Skip to content

morbo12/soundboard

Repository files navigation

Soundboard: A speaker/DJ helper app

FB Tools Logo
Visit FB Tools Website

Overview

Soundboard is a professional audio management application designed to enhance the experience of sports events, particularly Floorball matches in Stockholm, Sweden. It provides a comprehensive solution for managing audio playback, announcements, and live event reporting during matches.

πŸ“Έ View Screenshots - See the application in action

Features

Core Features (All Platforms)

  • Main Soundboard: Play and manage audio clips with ease
  • Text-to-Speech (TTS): Automated announcements for game events
  • Theme Support: Customize the app's appearance
  • Multi-channel Audio Management: Control different audio sources independently

Windows-specific Features

  • Lineup Management: Handle team lineups and player information
  • Live Events: Real-time event reporting and display
  • Hardware Volume Mixer: Physical control over audio levels using Deej protocol

System Requirements

Windows

  • Windows 10 or later
  • Latest Visual C++ Redistributable (see Prerequisites)

Android

  • Android 8.0 or later

Installation

Windows

  1. Download the latest release from the Releases page
  2. Unzip the package in folder of choice
  3. Install the required Visual C++ Redistributable if needed.

Android

  1. Download the APK from the Releases page
  2. Enable "Install from Unknown Sources" in your device settings
  3. Install the APK
  4. Grant necessary permissions when prompted

Prerequisites

  • Visual C++ Redistributable: Required for Windows 10 users. Download from Microsoft's official page
  • Azure Speech Service: Required for TTS functionality. You'll need to:
    1. Create an Azure account (Azure provides 500k chars for free per month)
    2. Set up a Speech Service resource
    3. Configure your API key in the app settings

Getting Started

  1. Launch the application
  2. Configure your audio devices in Settings
  3. Set up your Azure Speech Service credentials if using TTS
  4. Import your audio files (jingles, sound effects, etc.)
  5. Configure the hardware mixer if using one (see Hardware Volume Mixer)

Freemium Model & Upcoming Features

Soundboard is currently available as a free application with a freemium model in development:

Current Status

  • Free Version: Full access to all core soundboard features
  • TTS (Text-to-Speech): Currently requires your own Azure Speech Service subscription

Under Development

We're working on subscription-based services to enhance your experience:

  • TTS Subscription Backend: Eliminate the need for your own Azure account. Subscribe to our managed TTS service for hassle-free text-to-speech announcements.
  • AI-Generated Music Subscription: Access a library of AI-generated background music and jingles, specifically designed to avoid licensing fees associated with playing copyrighted music in public venues.

These subscription services will provide convenient, cost-effective alternatives while keeping the core soundboard functionality free.

Limitations

  • No plans exists to build for any Apple device.
  • TTS requires an Azure Speech Service, which you need to provide yourself
  • Some AI generated jingles are included (dowloaded through the installer)

Hardware Volume Mixer (Deej)

Soundboard supports hardware volume mixers following the Deej protocol. This allows you to control various volume levels using physical sliders.

Setup

  1. Build a Deej mixer following instructions at Deej GitHub repository
  2. Connect your Arduino to your computer via USB
  3. In Soundboard, go to Settings and configure your serial port settings:
    • Select the correct COM port
    • Set baud rate to match your Arduino sketch (default: 9600)
    • Configure other serial port parameters if needed
    • Enable "Auto Connect" to automatically connect at startup

Slider Mapping

You need to map your sliders to a process or master.


⬇️ Downloads

Soundboard: stable


Thanks to

  • Github Copilot
  • ChatGPT, Claude
  • GitHub for providing the runners to build new images.

How can I help?

Do you love this project? All kinds of contributions are welcome πŸ™Œ!

  • ⭐️ star the project
  • raise 🐞 issues
  • πŸ’° donations.

Donate with Buy me a coffee

Contributing

We welcome contributions! Here's how you can help:

  1. ⭐️ Star the project
  2. 🐞 Report bugs or suggest features
  3. πŸ’° Support development through donations
  4. πŸ“ Improve documentation
  5. πŸ”§ Submit pull requests

For developers:

  • Fork the repository
  • Create a feature branch
  • Make your changes
  • Submit a pull request
  • Ensure all tests pass
  • Update documentation as needed

About

A soundboard

Resources

License

Stars

Watchers

Forks

Sponsor this project

  •  

Packages

 
 
 

Contributors