From 9e7a45467cb445bf70ff2ee5973c1a2ae9717b12 Mon Sep 17 00:00:00 2001 From: Michael Czigler <37268479+mcpcpc@users.noreply.github.com> Date: Fri, 19 Mar 2021 17:15:23 -0400 Subject: released at 0.2.5 --- README | 162 +++++++++++++++++++++++++---------------------------------------- 1 file changed, 63 insertions(+), 99 deletions(-) (limited to 'README') diff --git a/README b/README index 1a451b5..be6a73f 100644 --- a/README +++ b/README @@ -1,99 +1,63 @@ - - - -

- kirc -

- -

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

- -

- - - Packaging status - Codacy status -

- -## 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 - Send a PRIVMSG to the current channel. -@ Send a message to a specified channel or nick -@@ Send a CTCP ACTION message to a specified channel or nick -/ Send command to IRC server (see RFC 2812 for full list). -/# 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 +--------------- + + send PRIVMSG to the current channel. + @ send message to a specified channel or nick. + @@ send CTCP ACTION message to a specified channel or nick. + / send command to the IRC server (see RFC 2812). + /# 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 -- cgit v1.2.3