https://github.com/krmax44/serial-soundboard

Simple soundboard designed to be controlled by a serial interface.
https://github.com/krmax44/serial-soundboard

Last synced: 8 months ago
JSON representation

Simple soundboard designed to be controlled by a serial interface.

• Host: GitHub
• URL: https://github.com/krmax44/serial-soundboard
• Owner: krmax44
• License: mit
• Created: 2020-07-01T07:23:42.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2020-08-14T14:04:07.000Z (almost 6 years ago)
• Last Synced: 2025-10-09T07:05:57.544Z (8 months ago)
• Language: Python
• Size: 11.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Serial Soundboard

[![Python application](https://github.com/krmax44/serial-soundboard/workflows/build/badge.svg)](https://github.com/krmax44/serial-soundboard/actions?query=workflow%3Abuild)

[![Code coverage](https://codecov.io/gh/krmax44/serial-soundboard/branch/master/graph/badge.svg)](https://codecov.io/gh/krmax44/serial-soundboard)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

Simple soundboard designed to be controlled by a serial interface. It also offers a minimal UI.

## Usage

Clone the repo or download the [archive](https://github.com/krmax44/serial-soundboard/archive/main.zip). Then, install using:

```bash

python3 -m venv .venv

pip install -r requirements.txt

```

Create a folder `sounds` and put your sound files into it. Start the program:

```bash

python3 soundboard.py [--port  --rate ]

```

Here, `` is your serial port (like `/dev/ttyS0` or `COM1`). If you don't specify a port, the UI will open. Optionally, you can specify a baud rate using the `--rate` flag. All options can be listed via the `--help` flag.

To trigger a sound, send its filename (with or without the extension) via serial, with a newline afterwards.