hubbub/README.md
2025-10-31 05:19:18 +01:00

1.6 KiB

hubbub

hubbub is a frightening idea: Voice-over-IRC-over-SSH. i saw voirc by asie before making this, but hubbub is different in a couple of ways:

  • it doesn't plop you in a big alternate screen
  • it does not support text
  • it has deafen and mute indicators
  • crucially, it is built for tilde town, so it tunnels through ssh.

the code is about as horrifying as the idea itself. if something breaks when it reasonably shouldn't, let me know (or fix it and then let me know!)

todo

  • joining a channel
  • handling everyone's state
  • any of the actual audio stuff
  • noise suppression with rnnoise

building

hubbub requires go 1.23 to build. it might run on earlier versions, but i think slices mainlined in 1.23 and i can't be bothered to check. run go build and copy the binary wherever.

usage

hubbub needs a TOML config file, either passed using --config or at .config/hubbub/config.toml:

username = 'shrike420'
privkey = '~/.ssh/id_ed25519'
nick = 'shrike420_voice'
channel = '#hubbub'

note that the nick is different than the username: if you're already logged onto irc you won't be able to use that nick. you can also pass a different server or port but you really don't have a reason to.

i'm writing this part about audio way in advance. i'll probably use alsa? either alsa or pipewire if i can be bothered with pipewire.

here's the controls:

,/m/space   toggle mute
./d         toggle deafen
q/^c/^d     quit :(

license

this monstrosity is licensed under the Dayenu Public License. see the notice for details.