My IRC client

Client Features

• Subsequent joins and parts fold into one line and do not scroll chat messages off the screen
• Ignore support that folds ignored messages into the joins and parts. Toggle it off to see previously hidden messages
• Detailed view to see all the messages in a channel in full detail with hostmask and timestamp (F2)
• Nick tab completion
• New message notification
• View ban, quiet, invex, and exception lists
• WYSIWYG mIRC formatting input
• Chanserv integration
• Each user's nick is assigned a consistent color, when a user's nick is rendered in a chat message it uses that same color.
• Support for /STATUSMSG/ messages (messages only voice or op users can see)
• Run commands upon connection
• Ban lists don't obstruct chat messages
• Ban list and user list are searchable
• CERTFP and SASL authentication

TLS

glirc has TLS support via the Haskell tls package. Note that Freenode (and other networks) will allow you to authenticate to NickServ via a client certificate.

I use the x509-store for decoding certificates and private key files. This library seems to support PEM formatted files and does not seem to support encrypted private key files. If the key and certificate are both contained in the certificate file the private key command line argument is unnecessary.

Startup

glirc [FLAGS] INITIAL_NETWORKS...
  -c PATH  --config=PATH  Configuration file path
  -h       --help         Show help
  -v       --version      Show version

Environment variables

USER=<default nickname and username>
IRCPASSWORD=<your irc password>

Configuration file

A configuration file can currently be used to provide some default values instead of using command line arguments. If any value is missing the default will be used.

Learn more about this file format at config-value

-- Defaults used when not specified on command line
defaults:
  port:            6667
  nick:            "yournick"
  username:        "yourusername"
  realname:        "Your real name"
  password:        "IRC server password"
  tls:             yes -- or: no
  tls-client-cert: "/path/to/cert.pem"
  tls-client-key:  "/path/to/cert.key"

-- Override the defaults when connecting to specific servers
servers:
  * hostname:      "chat.freenode.net"
    sasl-username: "someuser"
    sasl-password: "somepass"
    socks-host:    "socks5.example.com"
    socks-port:    8080 -- defaults to 1080

  * hostname:      "example.com"
    port:          7000
    connect-cmds:
      * "JOIN #favoritechannel,#otherchannel"
      * "PRIVMSG mybot :another command"

    -- Specify additional certificates beyond the system CAs
    server-certificates:
      * "/path/to/extra/certificate.pem"

Configuration sections:

• defaults - These settings are used for all connections
• servers - These settings are used to override defaults when the hostname matches

Settings

• hostname - text - hostname used to connect and to specify the server
• port - number - port number, defaults to 6667 without TLS and 6697 with TLS
• nick - text - nickname
• username - text - username
• realname - text - realname / GECOS
• password - text - server password
• sasl-username - text - SASL username
• sasl-password - text - SASL password
• tls - yes/no - use TLS to connect
• tls-insecure - yes/no - disable certificate validation
• tls-client-cert - text - path to TLS client certificate
• tls-client-key - text - path to TLS client key
• connect-cmds - list of text - raw IRC commands to send upon connection
• socks-host - text - hostname of SOCKS proxy to connect through
• socks-port - number - port number of SOCKS proxy to connect through
• server-certificates - list of text - list of CA certificates to use when validating certificates
• chanserv-channels - list of text - list of channels with chanserv op permission
• flood-penalty - number - cost in seconds per message
• flood-threshold - number - threshold of seconds for burst

Commands

• /exit - Terminate the client
• /quit - Gracefully terminate connection to the current server
• /disconnect - Forcefully terminate connection to the current server
• /connect <hostname> - Connect to the given hostname
• /reconnect - Reconnect to the current server
• /focus <server> - Change focus to server window
• /focus <server> <channel> - Change focus to channel window
• /clear - <Clear contents of current window
• /ignore <nick> - Toggle ignore of a user
• /quote <raw command> - Send a raw IRC command to the server
• /join <channel> - Join a channel
• /mode <mode> <params> - Change modes on the current channel
• /msg <target> <msg> - Send a message on the current server to target
• /nick <nick> - Change nickname
• /who <query> - Perform WHO query (use detailed view to see output)
• /whois <nick> - Perform WHOIS query
• /whowas <nick> - Perform WHOWAS query
• /invite <nick> - Invite a user to the current channel
• /topic <topic> - Change the topic
• /kick <nick> - Kick a user
• /kickban <nick> - Kick and ban a user
• /remove - Gracefully kick a user
• /me - Send action message to channel
• /part - Part from current channel
• /users - Show channel user list
• /masks <mode> - Show channel bans(b), quiets(q), exempts(e), or invex(I)
• /channelinfo - Show channel topic, creation, url

Filters

• /grep - Filter chat messages using a regular expression
• /grepi - Filter chat messages using a case-insensitive regular expression on the message

Keyboard Shortcuts

• ^N next channel
• ^P previous channel
• M-# jump to window - 1234567890qwertyuiop
• M-A jump to activity
• ^A beginning of line
• ^E end of line
• ^K delete to end
• ^U delete to beginning
• ^D delete at cursor
• ^W delete word
• ^Y paste from yank buffer
• M-F forward word
• M-B backward word
• TAB nickname completion
• F2 toggle detailed view
• Page Up scroll up
• Page Down scroll down
• ^B bold
• ^C color
• ^V reverse video
• ^_ underline
• ^] italic
• ^O reset formatting