diff options
author | Michael Czigler <37268479+mcpcpc@users.noreply.github.com> | 2020-09-07 14:04:26 -0400 |
---|---|---|
committer | mcpcpc <michaelczigler@icloud.com> | 2020-09-09 22:25:03 -0400 |
commit | 5db8d0b6e3d8d924008eea25b7bd831ce3c53bea (patch) | |
tree | 72c9bba8ec100617f5f5d6717bc5498f4e342818 /README.md | |
parent | Merge pull request #11 from mcpcpc/0.0.7 (diff) | |
download | kirc-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.md | 89 |
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 +----------- + + + +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 +``` |