---
name: "BitchX"
section: "1"
platform: "linux"
package: "bitchx"
version: "1:1.1-4"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/BitchX"
---

# BitchX(1)

an advanced Internet Relay Chat client scr-bx - restore detached BitchX session xbitchx - X wrapper for BitchX

## NAME

BitchX - an advanced Internet Relay Chat client\
 scr-bx - restore detached BitchX session\
 xbitchx - X wrapper for BitchX

## SYNOPSIS

**bitchx** \[-aAbdfqxvBFRZP\] \[-H hostname\] \[-c channel\] \[-p port\] \[-r file\] \[-n nickname\] \[-l file\] \[-L file\] \[nickname\] \[server list\]

**xbitchx**

**scr-bx**

## DESCRIPTION

**BitchX** is a VERY heavily modified ircII client. It includes many things such as built in CDCC (XDCC) offering, built in flood protection, etc. It is easier to script things in **BitchX** because unlike plain, vanilla ircII, half the script does not have to be devoted to changing the appearance of ircII. It also includes many other new features, such as port scanning, advanced TCL, a CD player, a mail client, screening process, etc.

**BitchX** - based on **EPIC** Software Labs **epic ircII (1998).** Version (BitchX-75p2-8) -- Date (19980708).

**xbitchx** is a wrapper script that loads the BitchX X11 font configuration from /etc/bitchx/xfont file, and runs BitchX under a nice XTerm window.

**scr-bx** is used to reattach screens after /detach.

## OPTIONS

- *-a*

  use the default servers list, as well as servers given on the command line.

- *-A*

  do not display the startup ANSI graphics.

- *-b*

  load *.bitchxrc* or *.ircrc* after connecting to a server (default).

- *-B*

  fork and return you to shell.

- *-c \<channel\>*

  automatically join the channel *\<channel\>* after connecting to a server. You usually need to escape the hash (#) character with backspace (.

- *-d*

  use a "dumb" terminal.

- *-f*

  your terminal uses flow control (^S/^Q), so BitchX should not use these chars.

- *-F*

  your terminal does not use flow control (default).

- *-h*

  display help, all available options.

- *-H \<hostname\>*

  use the virtual name \<hostname\> if possible.

- *-l \<file\>*

  use *\<file\>* instead of the usual .ircrc file.

- *-L \<file\>*

  use *\<file\>* instead of the usual .ircrc , and expand $ expandos.

- *-n \<nickname\>*

  set your IRC nickname to *\<nickname\>*.

- *-N*

  do not automatically connect to the first server.

- *-p \<port\>*

  use *\<port\>* as the default server connection port (normally 6667).

- *-P*

  toggle check pid.nickname for running program.

- *-q*

  don't load *~/.ircrc* on startup.

- *-r \<file\>*

  read *\<file\>* to get a list of IRC-servers. The *\<file\>* is a whitespace-separated list of server names.

- *-v*

  show version.

- *-x*

  run in **debug** mode.

- *-Z*

  use **NAT** address when doing DCC. Lets you specify your real address if you're using a machine that is being nat'd

  *Network Address Translation* - when you map N-to-M (IP masquerading is a special case of N-to-1 NAT). See *http://www.csn.tu-chemnitz.de/HyperNews/get/linux-ip-nat.html* for more information.

## SEE ALSO

**BitchX** has lots of internal documentation. Try using */ehelp,* */bhelp,* and */help.* There is also documentation in /usr/share/doc/bitchx.

## FILES

- */usr/lib/bitchx/, /etc/bitchx/*

  System-wide configuration directories

- *~/.BitchX/BitchX.sav*

  Personal configuration file

- *~/.BitchX/BitchX.ircnames*

  Default random real name(s)

- *~/.BitchX/BitchX.formats*

  Personal BitchX display formats

- *~/.BitchX/BitchX.reasons*

  Default random kick message(s)

- *~/.BitchX/BitchX.quit*

  Default random quit message(s)

- *~/.Bitchx/BitchX.help*

  User help-file.

- *~/.Bitchx/screens/*

  Storage directory for BitchX session screens.

## AUTHORS/CREDITS

**BitchX** was written by Colten Edwards **\<panasync@bitchx.com\>**

This manpage was written by Wichert Akkerman and later updated by Robert Durdle and Josip Rodin.