diff options
author | Michael Czigler <37268479+mcpcpc@users.noreply.github.com> | 2021-03-19 17:15:23 -0400 |
---|---|---|
committer | GitHub <noreply@github.com> | 2021-03-19 17:15:23 -0400 |
commit | 9e7a45467cb445bf70ff2ee5973c1a2ae9717b12 (patch) | |
tree | a4e4091ce420b603cbe2fe25a57b9a5f103f36c6 /README | |
parent | released at 0.2.4 (diff) | |
download | kirc-9e7a45467cb445bf70ff2ee5973c1a2ae9717b12.tar.gz kirc-9e7a45467cb445bf70ff2ee5973c1a2ae9717b12.tar.bz2 kirc-9e7a45467cb445bf70ff2ee5973c1a2ae9717b12.tar.xz kirc-9e7a45467cb445bf70ff2ee5973c1a2ae9717b12.tar.zst kirc-9e7a45467cb445bf70ff2ee5973c1a2ae9717b12.zip |
released at 0.2.5
Diffstat (limited to 'README')
-rw-r--r-- | README | 162 |
1 files changed, 63 insertions, 99 deletions
@@ -1,99 +1,63 @@ -<!-- vim: syntax=Markdown --> -<!-- - Title: KISS for IRC (kirc) - Description: A tiny IRC client written in POSIX C99. - Author: mcpcpc ---> - -<h3 align="center"> - <img src="https://raw.githubusercontent.com/mcpcpc/kirc/gh-pages/kirc.png" alt="kirc" height="170px"> -</h3> - -<p align="center">KISS for IRC, a tiny IRC client written in POSIX C99.</p> - -<p align="center"> - <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg"></a> - <a href="https://github.com/mcpcpc/kirc/releases"><img src="https://img.shields.io/github/v/release/mcpcpc/kirc.svg"></a> - <a href="https://repology.org/metapackage/kirc"><img src="https://repology.org/badge/tiny-repos/kirc.svg" alt="Packaging status"></a> - <a href="https://www.codacy.com/manual/mcpcpc/kirc/dashboard?utm_source=github.com&utm_medium=referral&utm_content=mcpcpc/kirc&utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/5616c0ed4b2f4209826038dbc270dbf5" alt="Codacy status"></a> -</p> - -## Features - -* Excellent cross-platform compatibility. -* Asynchronous user input and server messager handling. -* No dependencies other than a C99 compiler. -* Simple Authentication and Security Layer (SASL) procotol support. -* Client-to-client protocol (CTCP) support. -* Transport Layer Security (TLS) protocol support (via external utilities). -* Full chat history logging. -* Multi-channel joining at server connection. -* Simple command aliases and full support for all RFC 2812 commands. -* Easy color scheme definition via ANSI 8-bit colors. - -## Installation & Usage - -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 **Raspbian**, **Debian**, **Ubuntu** and many other Unix distributions): - -```shell -git clone https://github.com/mcpcpc/kirc.git -cd kirc -make -make install -``` - -### Usage - -Consult `man kirc` for a full list and explanation of available `kirc` arguments. - -```shell -kirc [-s hostname] [-p port] [-c channels] [-n nickname] [-r realname] [-u username] [-k password] [-a token] [-x command] [-o logfile] [-e|v|V] -``` - -### Command Aliases - -```shell -<message> Send a PRIVMSG to the current channel. -@<channel|nick> <message> Send a message to a specified channel or nick -@@<channel|nick> <message> Send a CTCP ACTION message to a specified channel or nick -/<command> Send command to IRC server (see RFC 2812 for full list). -/#<channel> Assign new default message channel. -``` - -### User Input Key Bindings - -* **CTRL+B** or **LEFT ARROW** moves the cursor one character to the left. -* **CTRL+F** or **RIGHT ARROW** moves the cursor one character to the right. -* **CTRL+E** moves the cursor to the end of the line. -* **CTRL+A** or **HOME** moves the cursor to the start of the line. -* **CTRL+W** deletes the previous word. -* **CTRL+U** deletes the entire line. -* **CTRL+K** deletes the from current character to end of line. -* **CTRL+C** Force quit kirc. -* **CTRL+D** deletes the character to the right of cursor. -* **CTRL+T** swap character at cursor with previous character. -* **CTRL+H** equivalent to backspace. - -## Support Documentation - -Please refer to the official [Support Documention](https://mcpcpc.github.io/kirc/documentation.html) for examples, troubleshooting and use cases. - -## Contact - -For any further questions or concerns, feel free to reach out to me, [mcpcpc](https://github.com/mcpcpc), on `#kirc` -or `#kisslinux` Freenode IRC channels. +kirc +==== + +kirc (KISS for IRC) is a tiny IRC client written in POSIX C99. + +Installation +------------ + +Building and installing from source: + + git clone https://github.com/mcpcpc/kirc + cd kirc + make + make install + +Usage +----- + +Consult `man kirc` for a full list and explanation of available arguments. + + kirc [-s hostname] [-p port] [-c channels] [-n nickname] [-r realname] + [-u username] [-k password] [-a token] [-x command] [-o logfile] + [-e|v|V] + +Command Aliases +--------------- + + <message> send PRIVMSG to the current channel. + @<channel|nick> <message> send message to a specified channel or nick. + @@<channel|nick> <message> send CTCP ACTION message to a specified channel or nick. + /<command> send command to the IRC server (see RFC 2812). + /#<channel> assign new default message channel. + +Key Bindings +------------ + + CTRL+B or LEFT ARROW move the cursor one character to the left. + CTRL+F or RIGHT ARROW move the cursor one character to the right. + CTRL+P or UP ARROW move to previous record in the input history buffer. + CTRL+N or DOWN ARROW move to next record in the input history buffer. + CTRL+E move the cursor to the end of the line. + CTRL+A or HOME move the cursor to the start of the line. + CTRL+W delete the previous word. + CTRL+U delete the entire line. + CTRL+K delete the from current character to end of line. + CTRL+D delete the character to the right of cursor. + CTRL+C force quit kirc. + CTRL+T swap character at cursor with previous character. + CTRL+H equivalent to backspace. + +Support Documentation +--------------------- + +Please refer to the official for examples, troubleshooting and use cases. + + https://mcpcpc.github.io/kirc/documentation.html + +Contact +------- + +For any further questions or concerns, feel free to email me at: + + michaelczigler [at] mcpcpc [dot] com |