Skip to main content

Set Up Alert Sounds

Alert sounds are short clips that play before TTS to flag an incoming donation. The app supports:

  • Map per event — different sound per event type (donation / superchat / bits / sub / resub / gift)
  • Tier per amount — different sounds based on amount (e.g. ≥100 = sound A, ≥500 = sound B)
  • Min threshold + volume — filter low-amount donations and control loudness

What you'll need​

  • Audio files in .mp3 / .wav / .ogg / .m4a — max 10 MB per file
  • A plan for how you want to split sounds (per event, per amount, or both)

Step 1 — Open the Alert Sounds tab​

  1. Go to Settings → Alert Sounds
  2. The page has 3 sections: Sound list (uploads), Event mapping, Sound by Amount

Step 2 — Upload your audio files​

  1. Click Upload / + Add Sound
  2. Pick a .mp3 / .wav / .ogg / .m4a file
  3. The file gets added to the Sound list — give it a memorable name (e.g. "ding-low", "fanfare-big")
  4. Click ▶ next to the name to preview

Upload all the sounds you'll use first — then map them in the next step.

Step 3 — Map sounds to event types​

In the Event Mapping section, you'll see a table of event types:

EventDescription
donationStreamlabs / tipme.in.th
superchatYouTube Super Chat
bitsTwitch Cheer / Bits
subscribeTwitch new sub
resubTwitch resub
giftTwitch gift sub
defaultFallback when nothing else matches

Pick a sound from each row's dropdown — saves automatically.

Step 4 — Set tiers by amount (optional)​

In the Sound by Amount section:

  1. Click + Add Tier
  2. Enter a minAmount + pick a sound, e.g.
    • ≥฿100 → ding-medium
    • ≥฿500 → fanfare-big
    • ≥฿1000 → epic-horn
  3. The app always picks the highest tier that matches (compared by minAmount)

:::tip Tiers override Event Mapping If a tier matches, its sound wins over Event Mapping. So order tiers low-to-high, and let Event Mapping be the fallback for amounts below your lowest tier. :::

Step 5 — Set Volume + Min Threshold​

At the bottom of the tab:

  • Alert Volume — slider 0–100% (applies to every alert)
  • Minimum Amount (alertMinDonation) — donations below this don't play an alert (TTS may still play, depending on ttsMinDonation)

Step 6 — Test​

Open the Test Panel → send fake donations at different amounts:

  • ฿50 → hear default / event sound
  • ฿100 → hear tier 100
  • ฿500 → hear tier 500

Tweak sounds / volume / threshold until it feels right.

Tips & Troubleshooting​

  • Uploaded but won't play: double-check the format (mp3/wav/ogg/m4a) and that it's < 10 MB.
  • Too loud: lower the Alert Volume slider — 50–70% is usually a good range.
  • Why isn't the alert firing? make sure the amount clears Minimum Amount and the event has a mapping.
  • Tier not triggering: the tier's amount has to be lower than the donation amount — e.g. tier 100 won't match a ฿50 donation.

:::warning alert vs TTS alertMinDonation controls alert sounds; ttsMinDonation controls TTS — these two are independent and can be set separately. :::

See also​