Irc /

Onekeyirc

  1. 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

  1. Platforms

onekeyirc is intended for:

  • OpenBSD
  • Other BSD systems
  • Linux

It is particularly useful on remote servers and shell accounts.

  1. License

onekeyirc is free and open-source software from https://thatiam.vip/software/.

License: IALA - Insha-Allah License Agreement

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.

  1. 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.