aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorMichael Czigler <37268479+mcpcpc@users.noreply.github.com>2020-09-07 14:04:26 -0400
committermcpcpc <michaelczigler@icloud.com>2020-09-09 22:25:03 -0400
commit5db8d0b6e3d8d924008eea25b7bd831ce3c53bea (patch)
tree72c9bba8ec100617f5f5d6717bc5498f4e342818 /README.md
parentMerge pull request #11 from mcpcpc/0.0.7 (diff)
downloadkirc-5db8d0b6e3d8d924008eea25b7bd831ce3c53bea.tar.gz
kirc-5db8d0b6e3d8d924008eea25b7bd831ce3c53bea.tar.bz2
kirc-5db8d0b6e3d8d924008eea25b7bd831ce3c53bea.tar.xz
kirc-5db8d0b6e3d8d924008eea25b7bd831ce3c53bea.tar.zst
kirc-5db8d0b6e3d8d924008eea25b7bd831ce3c53bea.zip
Squash commits pertaining to 0.0.8 release
Update README cleanup cleanup fix int typecast in printw() fix int typecast for JOIN/QUIT add 'x' command to send direct messages to server Update README Update kirc.c remove annoying initial space char revert last commit to remove initial space revert last commit undo accidental commit apply fix for initial space char add NAMES command revamped README for readability in GitHub Rename README to README.md Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Add files via upload Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Add files via upload Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Update README.md Add files via upload Update README.md Add files via upload Delete example_cropped.png Delete kirc.png Add files via upload Delete kirc.png Add files via upload Delete kirc.png Add files via upload Delete kirc.png Add files via upload Delete kirc.png Add files via upload Update README.md Add files via upload Delete example_cropped.JPG Update README.md Update README.md Update README.md Update README.md Update README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md89
1 files changed, 89 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1e6d703
--- /dev/null
+++ b/README.md
@@ -0,0 +1,89 @@
+<h3 align="center"><img src="https://raw.githubusercontent.com/mcpcpc/kirc/master/.github/kirc.png" alt="logo" 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>
+</p>
+
+
+## Objectives
+
+*"Do one thing and do it well"* — Per the [Unix philosophy](https://en.wikipedia.org/wiki/Unix_philosophy), emphasis was placed on building simple, short, clear, modular, and extensible code that can be easily maintained and repurposed.
+
+*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] [-w columns] [-W columns] [-o path] [-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
+-w maximum width of the printed left column (default: '10')
+-W maximum width of the entire printed stream (default '80')
+```
+
+Features
+--------
+
+- No dependencies other than a [C99 compiler](https://gcc.gnu.org/).
+- Automatic server *PING* response.
+- Complies with [RFC 2812](https://tools.ietf.org/html/rfc2812) standard.
+- vi-like command shortcuts:
+
+```shell
+<message> Send a message to the current channel.
+/m <nick|channel> <message> Send a message to a specified channel or nick.
+/M <message> Send a message to NickServ.
+/Q <message> Send a message and close the host connection.
+/x <message> Send a message directly to the server.
+/j <channel> Join a specified channel.
+/p <channel> 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 Linux** or **Manjaro** using the Arch 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 distributions):
+
+```shell
+git clone https://github.com/mcpcpc/kirc.git
+cd kirc
+make
+make install
+```