Heisenbridge

Heisenbridge is a bouncer-style Matrix-IRC bridge.

1. Install bbctl and log in as described in the readme (https://github.com/beeper/bridge-manager)
2. Install Python 3 using your OS package manager. You also need the stdlib venv module, which may or may not be included in the base python package (depends on your OS).
   • On Debian-based distros, sudo apt install python3 python3-venv
3. Run the bridge with bbctl run sh-irc. You can use a different name than sh-irc too, but it must start with sh-, and it should contain irc or heisenbridge (if it doesn't, it'll prompt you to choose the bridge type)
   • bbctl run currently runs the bridge in foreground, so you should leave it running in tmux or something similar. A background service mode will be added in the future.
4. The management room should pop up automatically

To get started in the management room, send the following messages:

1. ADDNETWORK libera
2. ADDSERVER libera irc.libera.chat 6697 --tls
3. OPEN libera - this will create a new libera-specific management room
4. In the libera management room, run NICK yourname, then CONNECT
5. You should now be connected to libera.chat. You can join channels using JOIN #channel

Happy chatting!