IRC

How we interact with our users


All our realtime communication happens through IRC: #pico.sh @ libera.chat.

If you don't want to use our bouncer and just want to quickly connect to our channel, then we recommend the libera-hosted web client.

We are delighted to provide a hosted IRC bouncer and web client for us on the team as well as pico users.

NOTE: For libera.chat you must ensure you have a libera account.

# Generate a login token for bouncer

pico-token-menu

  • SSH into our pico TUI
  • Select "Manage Tokens" submenu
  • Type "n" to generate a new token
  • Save token someplace safe

# Supported Clients

Next you need to pick a client to connect to the bouncer and finish setup:

# Web

We provide pico users with a self-hosted version of gamja.

# Log into chat.pico.sh

  • You'll be redirected to auth.pico.sh which implements a fake oauth2 service
  • Enter the token from above
  • Click submit

# Back to chat.pico.sh

irc-remember-me

  • Click "remember me" (this is important)
  • You'll see an error "Cannot interact with channels and users on the bouncer connection. Did you mean to use a specific network?" that's okay
  • Message BouncerServ (/msg BouncerServ help) to configure the bouncer

Next step is to connect to libera.chat section.

# Senpai

Senpai is a modern terminal client coupled pretty tightly to soju development so it's a great fit for us at pico -- we use it.

senpai (terminal client)

# Configure senpai

Create a config file

1mkdir -p ~/.config/senpai
2touch ~/.config/senpai/senpai.scfg

Edit senpai.scfg

address ircs://irc.pico.sh:6697
nickname <user>
password "<pico-token>"
tls true

Open senpai

1senpai

Next step is to connect to libera.chat section.

# Connect to libera

Using:

  • Network irc.libera.chat
  • Network alias libera
  • Channel #pico.sh

# Message BouncerServ

/msg BouncerServ help

# Join a network

network create -addr irc.libera.chat -name libera -nick <user> -enabled false
sasl set-plain -network libera <user> <sasl-pass>
network update libera -enabled true

# Join pico

/j #pico.sh

That's it! Join any other channels or networks using the same method.

# References

<< PREV
Images
NEXT >>
API Tokens
Home
Sitemap
Getting started
How it works
File uploads
UI
Custom domains
pgs.sh
tuns.sh
imgs.sh
prose.sh
pastes.sh
feeds.sh
pico+
Images
IRC
API Tokens
FAQ
Web Tunnels
Lab
Plain text lists
About us
Contact us
Abuse
Operations
Privacy policy