Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mcpcpc/kirc
A tiny IRC client written in POSIX C99.
https://github.com/mcpcpc/kirc
c99 irc irc-client kirc posix
Last synced: 2 days ago
JSON representation
A tiny IRC client written in POSIX C99.
- Host: GitHub
- URL: https://github.com/mcpcpc/kirc
- Owner: mcpcpc
- License: mit
- Created: 2020-08-06T20:07:16.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-01-13T14:40:39.000Z (15 days ago)
- Last Synced: 2025-01-18T22:32:24.374Z (10 days ago)
- Topics: c99, irc, irc-client, kirc, posix
- Language: C
- Homepage: https://mcpcpc.github.io/kirc/
- Size: 3.35 MB
- Stars: 527
- Watchers: 9
- Forks: 31
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- Awesome - Kirc - A tiny IRC client written in POSIX C99. (Communication and Collaboration Tools / IRC)
- awesome-cli-apps - kirc - Tiny IRC client. (Entertainment / Chat)
- fucking-awesome-cli-apps - kirc - Tiny IRC client. (Entertainment / Chat)
README
# 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] [-a auth]
[-u username] [-k password] [-a token] [-o logfile] [-D directory] [-4|6|d|e|x|v|V]
## DCC
DCC transfers are only accepted if the -d flag is passed to kirc.
If -d is passed to kirc, DCC transfers are always accpeted without user interaction
and downloaded to the configured directory.
If no directory is set with the -D option, files are downloaded to the current directory.
## DCC SEND
DCC SEND is only enabled if the -d flag is passed to kirc.
You can send files via DCC SEND using the folowing command:
/dcc
If you are sending files to clients outside of your lan, you must
make sure that the chosen port is open and forwarded to
the sending machine's internal address.
Thus is usually done from your router's settings.
For example:
/dcc dcc_client /home/user/upload/file.txt 192.168.1.100 12.34.56.78 10000
This command would send the file located at /home/user/upload/file.txt to the nick
dcc_client, assuming the sending machine's local ip is 192.168.1.100, and
the sending machine's external ip is 12.34.56.78, and that the port 10000
is open and forwarded to the sending machine's local address.
## Command Aliases
send PRIVMSG to the current channel.
@ send PRIVMSG to a specified channel or nick.
@@ send CTCP ACTION message to a specified channel
or nick (if no channel or nick is specified, the
message will be sent to the default channel).
/ 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 homepage](http://kirc.io/docs.html) for examples,
troubleshooting and use cases.
## Contact
For any further questions or concerns, feel free to send me an
[email](michaelczigler[at]mcpcpc[dot]com).