Read the documentation in:
[English] [French] [Russian]

A cross-platform soundboard 🔊

---

👀 Preview

👋 Introduction

Soundux is a cross-platform soundboard that features a simple user interface. With Soundux you can play audio to a specific application on Linux and to your VB-CABLE sink on Windows.

🏃 Runtime Dependencies

These are required to run the program

🐧 Linux

Please refer to your distro instructions on how to install

• pulseaudio / pipewire >= 0.3.26
• Xorg
• Libwnck3 (optional, for icon support)
• Webkit2gtk
• libappindicator3
• youtube-dl & ffmpeg (optional, for downloader support)

Windows

• VB-CABLE (Our installer automatically installs VB-CABLE)
• Webview2 Runtime (Is also shipped with the installer)
• youtube-dl & ffmpeg (optional, for downloader support)

📥 Installation

🐧 Linux

Arch Linux and derivatives

You can install our package with your AUR helper of choice which will automatically compile and install the latest release version

yay -S soundux

We also provide a soundux-git package which compiles from the master branch

Ubuntu and derivatives

You can install Soundux via pacstall

pacstall -I soundux

Fedora

Soundux can be installed via this COPR repository

sudo dnf copr enable rivenirvana/soundux
sudo dnf install soundux pipewire-devel

Distro-agnostic packages

You can grab the latest release from the Snap Store or Flathub

Windows

Download our installer or portable from the latest release

🔨 Compilation

🔗 Build Dependencies

🐧 Linux

• Webkit2gtk
• PulseAudio development headers
• PipeWire development headers
• X11 client-side development headers
• libappindicator3 development headers
• OpenSSL development headers
• G++ >= 9
  • Some distros still have G++ versions < 9 in their repos, using them will result in a build failure (for more information refer to #71).

Debian / Ubuntu and derivatives

sudo apt install git build-essential cmake libx11-dev libxi-dev libwebkit2gtk-4.0-dev libappindicator3-dev libssl-dev libpulse-dev libpipewire-0.3-dev

If you're on Ubuntu 20.04 or lower you might have to add the PipeWire PPA: sudo add-apt-repository ppa:pipewire-debian/pipewire-upstream

Fedora and derivatives

sudo dnf install git webkit2gtk3 cmake llvm clang libXi-devel gtk3-devel webkit2gtk3-devel libappindicator-gtk3-devel pulseaudio-libs-devel pipewire-devel

Windows

• Nuget
• MSVC
• CMake
• OpenSSL

👷 Build

Clone the repository

git clone https://github.com/Soundux/Soundux.git
cd Soundux
git submodule update --init --recursive

Create a build folder and start compilation

mkdir build
cd build
cmake ..
cmake --build . --config Release

To start the program

./soundux # .\soundux.exe on Windows

🖥️ Install

🐧 Linux

sudo make install

📝 Why Soundux?

The project started as a Soundboard for Linux

🗒️ License

The code is licensed under GPLv3

✍️ Contributing

The contribution guidelines can be found here, please check them out if you're planning to contribute!

✨ Contributors

Thanks goes to these wonderful people (emoji key):

Noah 🐛 💼 💻 🎨 🤔 🚇 🚧 📦 📆 💬 👀 ⚠️	Nico 🐛 💼 💻 🎨 🤔 🚇 🚧 📦 📆 💬 👀 ⚠️ 🌍 ️️️️♿️
Michael 🐛 🤔 🌍 ⚠️	BrandonKMLee 🤔
Toadfield 🤔 🐛	fubka 🐛
TheOriginalTripleD 🔬	UltraBlackLinux 🐛
bendem 🐛	Edgar Onghena 🐛 🔬
moggesmith10 🤔	Bilal Elmoussaoui 📦
Thomas Finstad Larsen 🤔	Arthur Melton 🤔
Serkan ÖNDER 🌍	PizzaDude 🐛 🔬
Kylianalex 🐛	Greger 🐛
Arvin Verain 📦	EinfachEinAlex 💻 🔬 ⚠️
MeblIkea 🌍	Nathan Bonnemains 🌍
Lucas van Beek 🌍	Timotej S. 🐛 ⚠️
3JlOy_PYCCKUi 🌍	FuRyQC 🌍
Scott Percival 🐛 ⚠️ 💻

This project follows the all-contributors specification. Contributions of any kind welcome!