Personalizing your sound

 Gumball has built-in speakers, so you can assign sounds to specific notifications. Choose from 15 pre-defined sounds, or add your own via the included SD card. Handy to distinguish notifications or to give you that extra boost of motivation with your special sound.

Choosing the sound of a webhook

You pick the sound when you create a webhook in your Gumball account. The action “track_x” plays a specific track: a webhook set to track_12 plays 12.mp3 from Gumball’s microSD card.

Want another sound for another app or event? Create another webhook. The “Try it” buttons on your Gumball’s page let you hear the sounds first.

You can also change the sound for a single call, by adding the “action” parameter to the webhook address:

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_12

Playing a random sound

Use the action “track_random_x-xx” to play a random track. The example below will play a random audio track out of the following audio tracks: 7,8,9,10.mp3

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_random_7-10

Playing a silent track

By default, the action track_0 is a silent track. This is handy if you want to have your Gumball turn on, rotating light only, without any sound. 

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_0

Changing the audio volume

Set the volume from your Gumball’s page in your account, or use the action volume_x. The minimum is 0 (silent) and the maximum is 21. The default is 15. “Sound off” and “Sound on”, on the same page, mute and unmute your Gumball.

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=volume_15

Adding your own custom sound

Your Gumball comes already loaded with 15 cool audio tracks. But we know everyone has their little ‘special’ sound they like 🎵! So we made it possible to add custom tracks! All you have to do is load some mp3 files on the Gumball’s microSD card:

• ⚠️ Unplug your Gumball!!
• Open your Gumball by removing the cover lens.
• Slide the microSD card holder outward, then flip it vertically.
• Remove the microSD card
• From a computer, load your mp3 files on the microSD (use the provided SD card adaptor)
• Make sure the audio track names are numbers only, for example: 4.mp3, 18.mp3, etc…
• Re-insert the microSD card inside your Gumball, put the lens back on, re-plug it. Done!

Then create a webhook that plays your new track, for example track_18 for 18.mp3.

Coming soon: upload and trim your sounds from your account, no SD card needed.

Audio considerations

• File types accepted: .mp3
• Best result with shorter tracks (~10sec or so). The light turns for as long as the sound plays, 30 seconds at most. Audacity is a great free tool if you want to trim or edit an audio file.
• While a sound is playing, a new notification is skipped.
• File naming convention: use numbers only. For example:
  • 1.mp3
  • 2.mp3
  • ….
  • 44.mp3
  • 45.mp3