Onekeyirc
- onekeyirc
onekeyirc is a lightweight open-source command-line IRC client for BSD and Linux. It is designed to make persistent IRC operation simple, especially on shell accounts, VPS, and systems where the client is expected to remain connected without constant supervision.
onekeyirc supports TLS, automatic reconnecting, background operation, persistent sessions, multiple IRC servers and channels, scrollback, and terminal-based interaction
- Platforms
onekeyirc is intended for:
- OpenBSD
- Other BSD systems
- Linux
It is particularly useful on remote servers and shell accounts.
- License
onekeyirc is free and open-source software from https://thatiam.vip/software/.
License: IALA - Insha-Allah License Agreement
- Starting onekeyirc
To start the client:
onekeyirc
For persistent background operation:
onekeyirc --background --reconnect
onekeyirc can also be configured so that commonly used behavior is stored in its configuration file rather than repeatedly supplied on the command line.
- Connecting to IRCNow
Configure onekeyirc with the IRCNow hostname, nickname, username, port, and TLS settings supplied by the IRCNow provider.
A typical encrypted IRC connection uses TLS on port 6697.
onekeyirc can also connect through an IRCNow ZNC bouncer by configuring the bouncer hostname, TLS port, ZNC username or network name, and password.
- Persistent IRC operation
onekeyirc is designed for IRC sessions that should remain available even when the controlling terminal disappears.
This is useful when:
- an SSH connection drops
- a terminal is closed
- the user's network temporarily disappears
- the client is running unattended on a VPS
- the user wants IRC to remain connected between login sessions
A running client session can later be resumed from another terminal.
Session-management commands can also be used to terminate a stale or inaccessible session.
- Single-session mode
Many IRC users only need one persistent client session because one session can already hold multiple servers and channels.
onekeyirc therefore supports operation where the user can keep a single long-running IRC session rather than managing several separate instances.
This makes reconnecting to the client simpler while still allowing access to multiple IRC networks.
- Automatic reconnect
When automatic reconnect is enabled, onekeyirc attempts to restore IRC connectivity after temporary network failures.
This is useful for long-running connections where brief outages should not require manual intervention.
- Multiple networks and channels
A single onekeyirc session can maintain multiple IRC server connections and multiple channels.
This allows one persistent client process to act as the user's IRC workspace.
- Scrollback
onekeyirc keeps IRC history and scrollback available across normal client operation and resumed sessions.
The interface provides keyboard navigation for reviewing older messages and returning to the most recent activity.
- Background service operation
onekeyirc is suitable for unattended use.
On OpenBSD it can be operated through rcctl when the provided rc.d configuration is installed and a non-root service account has been configured.
For example, a typical service configuration can launch the client with:
--background --reconnect
This allows onekeyirc to start with the system and remain available without requiring an open terminal.
- Why use onekeyirc?
onekeyirc may be useful for users who want:
- a command-line IRC client
- simple persistent operation
- automatic reconnecting
- background operation
- OpenBSD and Linux support
- TLS
- multiple networks and channels
- scrollback
- shell-account use
- VPS operation
- optional service management through rcctl
The client is intended to make a long-running IRC connection behave more like a normal system service than a temporary terminal program.
