This is a rewrite of the old waveboard project to make it cross-platform and easier to work with for the end-user.

The application is now a command line interface with a web UI.

Tested on Fedora 40 and Windows 10. Unsure about Mac support.

Installation

1. Get a binary or preferably compile one yourself
2. Put the src/web folder in the same directory as the binary

Features

• Global keyboard hotkeys / shortcuts for sounds
• In-memory playback
• Source Engine chat commands
• Whitelist and blacklist
• Audio queue
• Video downloader and converter
• Text-To-Speech using SAPI on Windows
• A barebones JavaScript API
• Supported formats : .ogg (opus and vorbis), .mp3, .wav, .flac

Screenshots

Requirements

1. A virtual audio cable (Virtual-Audio-Cable or VB-Audio Cable)

   • Follow this, the text tutorial or find another tutorial to install the drivers
   • You may need to disable "Driver Signature Enforcement" during the installation process

2. An audio directory (it is searched recursively)

   • It will be used by the program to play tracks and download videos

3. ^Optional A log file within your Source Engine game using the con_logfile <file> command or the -condebug launch option

   • This is for the log watching feature, which allows interaction with the application using the game's chat
   • You can use an autoexec.cfg file for easier management

4. ^Optional yt-dlp and ffmpeg binaries for video downloading and conversion

   The yt-dlp binary needs to be named "ytdl" or "ytdl.exe"

Compiling

You will need :

• Zig

Windows :

Nothing else

Linux :

Check build.zig for the required dependencies

Credits and libraries

• STARK - I've used it for a long time, but it is half broken and uses the disk to write raw audio data

• miniaudio
• libuiohook - evdev branch
• nfd-extended
• ogg-container
• opus and opusfile
• vorbis

• webui
• regex