soundboard 0.0.2

cross-plattform soundboard: play sounds over your microphone
soundboard-0.0.2 is not a library.

soundboard

Build

cross-platform desktop application to spice up your audio/video conferences

soundboard screenshot

features

  • play local and remote sounds (http) to your microphone and output device
  • hotkeys
  • native user interface
  • web user interface
  • http api

install

  1. use compiled release package from https://github.com/gamebooster/soundboard/releases/ or cargo install soundboard (compile time is a coffee break)
  2. create soundboard config directory with soundboards (see below for example config)
  3. provide virtual microphone (instructions below)
  4. (optional) copy web directory in soundboard config directory for webui

default usage

  1. run soundboard --print-possible-devices
  2. run soundboard --loopback-device "<name>" or put in config file
    • loopback-device should be the installed virtual output device name
  3. Press hotkeys or use native gui or open web ui http://localhost:3030
  4. ???
  5. Press CTRL-C to exit or press x on window

providing virtual microphone on windows

  1. download and install vb-audio virtual cable from https://download.vb-audio.com/Download_CABLE/VBCABLE_Driver_Pack43.zip
  2. start soundboard with loopback device CABLE Input
  3. use applications with input CABLE Output

providing virtual microphone on linux

  1. create and choose loopback device
    a. use flag --auto-loop-device
    b. alternative: enter command pactl load-module module-null-sink sink_name=virtualSink
  2. start soundboard with loopback device null sink
  3. use applications with input Monitor of Null Sink or Monitor of SoundboadLoopbackDevice

providing virtual microphone on macos

  1. download and install soundflower kernel extension from https://github.com/mattingalls/Soundflower/releases
  2. set sample rate via Audio MIDI Setup for Soundflower (2ch) to 48000 hz
  3. start soundboard with loopback device: Soundflower (2ch)
  4. use applications with input: Soundflower (2ch)

config file example

soundboard.toml is optional. soundboards directory is mandatory.

config search path:

{soundboard exe location}
$XDG_CONFIG_HOME/soundboard/
$HOME/.config/soundboard/
$HOME/.soundboard/
# input_device = "Mikrofonarray (Realtek High Definition Audio(SST))" # optional else default device
# output_device = "Speaker/HP (Realtek High Definition Audio(SST))" # optional else default device
loopback_device = "CABLE Input (VB-Audio Virtual Cable)" # required: change to your virtual loopback output

stop_hotkey = "ALT-S" # stop all sound
http_server = true # api and webui; 3030 is the default port
no_gui = false # no native gui
name = 'favorites'
position = 0

[[sound]]
name = 'Nicht so tief, RĂ¼diger!'
path = 'nicht-so-tief-rudiger.mp3'
hotkey = 'CTRL-P'
name = "Myinstants.com"

[[sound]]
name="Sad Trombone"
path="https://www.myinstants.com//media/sounds/sadtrombone.swf.mp3"

[[sound]]
name="Dramatic Chipmunk"
path="https://www.myinstants.com//media/sounds/dramatic.swf.mp3"
soundboard.toml
soundboards/
  favorites/
    nicht-so-tief-rudiger.mp3
  favorites.toml
  myinstants_soundboard.toml