---
name: "blackened"
section: "1"
platform: "linux"
package: "blackened"
version: "1.8.0-3"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/blackened"
---

# blackened(1)

enhanced interface to the Internet Relay Chat system

## NAME

**Blackened** – enhanced interface to the Internet Relay Chat system

## SYNOPSIS

**blackened** \[**-c** *chan*\] \[**-p** *portno*\] \[**-f**\]\] \[**-F**\] \[**-s**\] \[**-S**\] \[**-d**\] \[*nickname* \["server list"\]\] \[**-l** *filename*\] \[**-L** *filename*\] \[**-a**\] \[**-v**\] \[**-q**\]

## DESCRIPTION

**Blackened** is a full screen, termcap based interface to Internet Relay Chat. Based on ircII-2.8.2, it gives full access to all of the normal IRC functions, plus a wide variety of additional options, including many  that are highly useful to IRC server operators and administrators.

### The Screen

The screen is split into two parts, separated by an inverse-video status line (if supported). The upper (larger) part of the screen displays responses from the IRC server. The lower part of the screen (a single line) accepts keyboard input.

Some terminals do not support certain features required by **Blackened**, in which case you receive a message stating this. If this occurs, try changing the terminal type or run **Blackened** with the **-d** option.

### Irc Commands

Any line beginning with the slash character ‘/’ is regarded as a **Blackened** command (the command character may be changed; type “**/help set cmdchar**”). Any line not beginning with this character is treated as a message to be sent to the current channel. To produce a listing of commands, type “/help ?”. To receive information about the commands type “**/help**  ⟨**command**⟩”.

### The .ircrc File

When **Blackened** is executed, it checks the user's home directory for a *.ircrc* file, executing the commands in the file. Commands in this file do not need to have a leading slash character ‘/’. This allows predefinition of aliases and other features.

### The Help Files

All of the **Blackened** commands are fully described in the help files package.  The best way to start help is with the “**/HELP ?**” command as this prints a listing of all available help files.

## OPTIONS

- **-c** *chan*

  Automatically join channel “chan”.

- **-p** *portno*

  Set the port number to “portno” (default: 6667, the standard IRC port). Only supply this if you connect to a server which uses a port other than 6667.

- **-f**

  Use flow control (^S and ^Q) to stop and start the display. Normally these are both bound to other functions within **Blackened**. This switch is ignored if the **-d** switch is used.

- **-F**

  Don't use flow control (^S and ^Q) to stop and start the display. This switch is ignored if the **-d** switch is used.

- **-s**

  Don't start up the ircserv process to connect to the IRC server (default).

- **-S**

  Start up the ircserv process to connect to the IRC server.

- **-d**

  Start in “dumb” mode.  All input is taken directly from stdin and all output goes to stdout without using any of the [termcap(5)](/termcap/5.md) screen control codes.

- *nickname*

  Set the nickname (overrides the environment variable  IRCNICK; default: the username).

- *server*

  Set the list of servers with which **Blackened** will try to connect upon startup. This list is also used by the program's **/server** command. The format for lines in the list is:

  ```
  hostname
  [:portno[:password[:nick]]]
  ```

- **-l** *filename*

  Selects a different file to be used as the .ircrc file for  **Blackened**. There is no exansion of $ expandos when using this option. The default is *$HOME/.ircrc*.

- **-L** *filename*

  Selects a different file to be used as the .ircrc file for **Blackened**. Expansion of $ expandos happens with this option.   The default is  *$HOME/.ircrc*.

- **-a**

  This adds the normal IRC server list to the command line list of IRC servers.

- **-v**

  Print the version and release date of **Blackened** and exit.

- **-q**

  Start up **Blackened** quickly -- don't load the *.ircrc* file.

## ENVIRONMENT

It can be helpful to predefine certain variables in in the *.cshrc*, *.profile*, or *.login* file:

- IRCNICK

  The user's nickname.

- IRCNAME

  The user's realname (otherwise retreived from */etc/passwd*)

- IRCSERVER

  The default server(s) (see server for details)

- IRCHOST

  The hostname or IP from which to connect to IRC servers.  Useful for virtual hosts.

- IRC\_HOST

  Alternative name for IRCHOST.

- MYHOSTADDR

  Alternative name for IRC\_HOST.

- HOME

  Overrides the default home path in */etc/passwd*.

- TERM

  The type of terminal in use.

## FILES

- */usr/local/bin/blackened*

  the executable program

- *~/.ircrc*

  default initialization file

- *~/.irc/*

  directory you can put your own **Blackened** scripts into, that can then be loaded with **/load**

- */usr/local/share/blackened/@VERSION@/*

  directory containing message-of-the-day, master initialization, help files and  **Blackened** scripts

## SIGNALS

- SIGUSR1

  Closes all DCC connections and processes spawned with [exec(3)](/exec/3.md).

- SIGUSR2

  Drops **Blackened** back to the command line.

**Blackened** handles the following signals:

## EXAMPLES

```
blackened -c #irchelp -p 5555
```

Connect **Blackened** to port number 5555 of the default host and immediately join channel #irchelp.

```
blackened Mermaid
```

Use the nickname “Mermaid”.

```
blackened Mermaid server1:5000 server2::passwd server3
```

Use the nickname “Mermaid” and the modified server list.

```
blackened -d
```

Use dumb mode.

```
blackened -f
```

Allow use of ^S/^Q to stop/start screen display.

```
setenv IRCNICK Mermaid
setenv IRCNAME "The one and only :)"
blackened
```

Set the nickname (if not specified elsewhere) to “Mermaid”. The user's name (when provided in response to a  **/WHOIS** command) is set to “The one and only :)”.

## BUGS

To report bugs in the latest version of **Blackened** send email to ⟨blackened-bugs@blackened.com⟩ with as much pertinent information as possible.  Please avoid creating duplicate bug reports by checking the list on the official website prior to sending email.

## AUTHOR

Timothy Jensen ⟨toast@blackened.com⟩

Names of contributors and contact addresses can be retrieved with the **/info** command.

## SEE ALSO

[ircII(1)](/ircII/1.md), [ircd(8)](/ircd/8.md)

Official Website: http://www.blackened.com/blackened/