Skip to content

Soundux/Soundux

Repository files navigation

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️

[!NOTE]
Soundux is undergoing a major rewrite right now, for more information see #591

⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️


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



A cross-platform soundboard 🔊

Latest Stable Release
GitHub Repo stars GitHub issues GitHub pull requests
License Discord Matrix
Windows Build Linux Build Flatpak Build
Discord Invite Translation status

👀 Preview

Dark Interface Light Interface
Settings Dark Settings Light
Search Dark Search Light
Application Passthrough Application Passthrough
Seek/Pause/Stop Dark Seek/Pause/Stop Light
Grid View Dark Grid View Light

👋 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

Windows

📥 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

Get it from the Snap Store

Download on 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!