Soju

Soju is an IRC bouncer — it keeps you connected to IRC networks 24/7. Messages sent while you're offline are stored and delivered when you reconnect.

All ~horsies can use soju by connecting with an IRC client and authenticating with their shell credentials.

Joining a network

There are two ways to add an IRC network to your bouncer.

Via username

Set your username to <username>/<irc-server-address> when connecting. Soju will create the network automatically on first connect.

username: ky/irc.libera.chat
username: ky/irc.oftc.net

Via BouncerServ

Connect with just your username (no network suffix), then message BouncerServ:

/msg BouncerServ network create -addr irc.libera.chat:6697 libera
/msg BouncerServ network create -addr irc.oftc.net:6697 oftc

Once a network exists, connect to it by appending its name to your username: ky/libera.

Client Examples

WeeChat

/server add bouncer soju.tilde.horse/6697 -tls -username=<username>/<network> -password=<password> -autoconnect
/connect bouncer

Irssi

/network add -user <username>/<network> <network>
/server add -auto -tls -network <network> soju.tilde.horse 6697 <password>
/connect <network>

Catgirl

catgirl -h soju.tilde.horse -p 6697 -n <username>/<network> -w <password>

Note: catgirl has limited bouncer support — history playback may not work fully.

For more information, see the soju manual.