logo

KISS for IRC, a tiny IRC client written in POSIX C99.

Packaging status

## Objectives _"Do one thing and do it well"_ — Emphasis was placed on building simple, short, clear, modular, and extensible code that can be easily maintained and repurposed (per the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy)). _Portability_ — [POSIX](https://en.wikipedia.org/wiki/POSIX) compliance ensures seamless compatibility and interoperability between variants of Unix and other operating systems. _Usability_ — Commands and shortcuts should feel natural and accessible using a [standard 104-key US keyboard layout](https://en.wikipedia.org/wiki/Keyboard_layout). Where possible, the number of keystrokes shall be minimized. Usage ----- ```shell usage: kirc [-s hostname] [-p port] [-c channel] [-n nick] [-r real name] [-u username] [-k password] [-x init command] [-w columns] [-W columns] [-o path] [-h|v|V] -s server address (default: 'irc.freenode.org') -p server port (default: '6667') -c channel name (default: '#kisslinux') -n nickname (required) -u server username (optional) -k server password (optional) -r real name (optional) -v version information -V verbose output (e.g. raw stream) -o output path to log irc stream -x send command to irc server after inital connection -w maximum width of the printed left column (default: '10') -W maximum width of the entire printed stream (default '80') -h basic usage information ``` Features -------- - No dependencies other than a [C99 compiler](https://gcc.gnu.org/). - Complies with [RFC 2812](https://tools.ietf.org/html/rfc2812) standard. - Ability to log the entire chat history (see _Usage_ section for more information). - vi-like command shortcuts: ```shell Send a message to the current channel. /m Send a message to a specified channel or nick. /M Send a message to NickServ. /Q Send a message and close the host connection. /x Send a message directly to the server. /j Join a specified channel. /p Leave (part) a specified channel. /n List all users on the current channel. /q Close the host connection. ``` - Color scheme definition via [ANSI 8-bit colors](https://en.wikipedia.org/wiki/ANSI_escape_code). Therefore, one could theoretically achieve uniform color definition across all shell applications and tools. Screenshots ----------- ![Screenshot 1](/.github/example.png) Installation ------------ Building and installing on **KISS Linux** using the Community repository: ```shell kiss b kirc kiss i kirc ``` Building and installing on **Arch** and **Arch-based** distros using the AUR: ```shell git clone https://aur.archlinux.org/kirc-git.git cd kirc makepkg -si ``` Building and installing from source (works on **Rasbian**, **Debian**, **Ubuntu** and many other Unix distributions): ```shell git clone https://github.com/mcpcpc/kirc.git cd kirc make make install ```