Python project that can feed audio files into individual audio channels for use as a location-based soundboard.
  • Python 83.2%
  • Makefile 16.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Blizzard Finnegan a5f60d67d6
All checks were successful
ci/woodpecker/push/ci Pipeline was successful
Add CI badge
2026-11-01 13:25:14 -07:00
.woodpecker Fix complaint 2026-11-01 13:22:15 -07:00
src/audio_soundboard Fix complaint 2026-11-01 13:22:15 -07:00
.gitignore Initial commit 2026-10-31 20:27:26 -06:00
.python-version Initial setup with documentation 2026-10-31 21:37:07 -06:00
LICENSE Initial commit 2026-10-31 20:27:26 -06:00
Makefile Pull in ruff from uv 2026-10-31 23:35:19 -06:00
mypy.ini Add type hints, mypy checks, update readme 2026-10-31 22:42:55 -06:00
pyproject.toml Pull in ruff from uv 2026-10-31 23:35:19 -06:00
README.md Add CI badge 2026-11-01 13:25:14 -07:00
soundboard.toml Add CLI args and makefile 2026-10-31 23:18:44 -06:00
uv.lock Pull in ruff from uv 2026-10-31 23:35:19 -06:00

CI status

audio-soundboard

Python project that can feed audio files into individual audio channels for use as a location-based soundboard.

Usage

This repository uses the Python package manager uv to manage its dependencies. To install uv, install using the standalone installer:

curl -LsSf https://astral.sh/uv/install.sh | sh

This will install locally to your user, and therefore does not require root/sudo access. It is compatible with environments that restrict installation of python libraries (see PEP668 ), such as Debian.

Once uv has been installed, in the root of this repository, run the following to get all dependencies:

uv sync
uv run soundboard

A Makefile is also included, for useful documentation.

All further keyboard inputs are captured and used for controlling the soundboard. It can be exited by pressing Ctrl-C.

Licensing

All code in this repo is licensed under AGPL-3.0-or-later. Any additional resources such as audio files are for demonstration purposes only.