Soundboard Launcher

Overview

Soundboard Launcher is an application designed to bring all your soundboards into one convenient location. Whether you've created your own soundboards or received them from friends, this app simplifies the process of importing and using them.

How It Works

To get started, simply open the app, import a soundboard from a zip file or a direct link on the internet, and start enjoying your sounds. The app is designed to be user-friendly, making it easy for anyone to access their favorite sound effects.

Important Information for Deployers

If you're hosting soundboards on a web server, ensure that the link points directly to a zip file. For example:

Correct: https://example.com/soundboard.zip
Correct: https://example.com/some_page/ (if it returns a zip file)
Wrong: https://example.com/some_page.html

File Structure

The zip file you upload should follow this structure:

plaintext
filename.zip
├─ icon.png (optional)
├─ manifest.json
└─ audio/
├─ audioname.mp3
...
└─ audioname.mp3

Manifest

The manifest is a JSON file with two properties:

"name": The name of the soundboard.
"lowvolmsg" (optional): A message to show the user when the volume is set to 0.

Here are some examples:

json
{
"name":"Test Soundboard 1",
"lowvolmsg":"Volume is too low!"
}

json
{
"name":"Test Soundboard 1"
}

Icon

The icon is a PNG file with transparency, used in the list of soundboards and in the volume bar. While there are no size limits, it's recommended to keep the image under 512x512 pixels to avoid using too much space.

Audio

The audio folder contains MP3 files. At present, the app does not support subfolders, though this feature will be added in future updates. Filenames are converted to button names, so "Mickey Mouse.mp3" becomes a button labeled "Mickey Mouse."

File Naming Guidelines

Filenames should be valid and not exceed system limitations:

Too long filenames may not display entirely in the button.
Filenames must be valid for the system. Android disallows filenames containing null characters (0x00) or forward slashes (/).

By following these guidelines, you can ensure a smooth experience while using Soundboard Launcher.