Create your own SoundBoard
SoundBoardio is a unique GitHub-driven app. If you are familiar with GitHub, it's really easy!
Your board is a plain public repository: mp3s, two icons and a soundboardio.json file. Nothing to build or deploy, just follow these simple steps.
Working with an AI agent such as Claude Code? Give it our board skill: it cuts the sounds, writes the manifest, checks it through our MCP server and publishes the repository. In Claude Code, our plugin installs both at once.
Instructions
-
Create a new repository
On your GitHub account, create a public repo. Its name must start with the prefix
soundboardio-, for examplesoundboardio-quotes. Need an example? Check out this repository, or press Use this template there and get a copy of it. -
Upload your sounds
Add your MP3 files into a
soundsfolder (or you can host them yourself). No git needed: on GitHub, Add file → Upload files does it. -
Upload your icons
Add two square PNGs to an
iconsfolder,icon-192x192.pngandicon-512x512.png. The installed app uses them as its icon, without them it gets the SoundBoardio logo. -
Create a manifest file
Put together
soundboardio.jsonin the generator below and place it in the root of your repository. -
Commit and push
Save your changes to the repository! On the GitHub website that is the green Commit changes button.
soundboardio-quotes/
├── soundboardio.json
├── icons/
│ ├── icon-192x192.png
│ └── icon-512x512.png
└── sounds/
├── first-quote.mp3
└── second-quote.mp3 Finished example: soundboardio-developersThat's it!
Now you can open your shiny new SoundBoard using your custom URL. It works automagically without deploying anything:
github.com / your-name / soundboardio-quotessoundboardio.com/app / your-name / quotesDoesn't load? Paste the repository address into the validator and it tells you what the manifest is missing.
Manifest generator
Drop in your mp3s, fill in the name and download the finished soundboardio.json.
Preview
Board name
Description goes here
Add sounds and they show up here as tiles. Tap one to play it.
Still missing: sounds, board name, description, author, board language.
Show the JSON
{
"name": "",
"shortName": "",
"description": "",
"color": "#943100",
"lang": "",
"author": {
"name": "",
"url": ""
},
"version": "1.0.0",
"rootUrl": "sounds/",
"icons": [
{
"src": "/icons/icon-192x192.png",
"sizes": "192x192",
"type": "image/png"
},
{
"src": "/icons/icon-512x512.png",
"sizes": "512x512",
"type": "image/png"
}
],
"tiles": []
}FAQ
How do I create my own soundboard?
Create a public GitHub repository, add a soundboardio.json manifest that lists your sound tiles, and open your board at soundboardio.com. There is no build step and nothing to deploy.
What do I need to get started?
A GitHub account and a public repository with a soundboardio.json manifest. You can build the manifest with our generator and check it with the validator before publishing.
Where do the sound files go?
You can commit the mp3 files to the same GitHub repository, or host them on your own HTTPS server and set rootUrl in the manifest to the full address of their folder.
What audio format is supported?
Standard web audio files such as MP3, referenced from your soundboardio.json manifest.
How do I get my soundboard onto the SoundBoardio homepage?
Open a pull request to the soundboardio/plugins repository. Once it is merged, your board appears in the catalog. Listing is optional — your board already works through its own URL.
Can I edit my soundboard later?
Yes. Just update the soundboardio.json (or the audio files) in your GitHub repository — the changes show up automatically, with no redeploy needed.
Can an AI agent make the board for me?
Yes. Give an AI agent such as Claude Code our board skill, linked at the top of this page. It asks you for the sounds and their exact words, cuts the clips, writes the soundboardio.json manifest, checks it with the validate_board tool of our MCP server and publishes the repository on your GitHub.