Sounds
Sound format requirements, entry fields, and resolution logic
Sounds are OGG audio files that play when a notification arrives from a matched app.
Format Requirements
- File format: OGG Vorbis only
- File extension:
.ogg - Duration: Keep it short, 1-3 seconds is ideal for notifications. There is a hard limit of 10 seconds
Sound Entry Fields
Each sound is a key-value pair in the Sounds object. The key (e.g. "ding") is the sound's internal ID.
| Field | Required | Description |
|---|---|---|
Name | Yes | Display name shown in the settings UI |
Ogg | Yes | Relative path to the OGG file |
Android | No | Array of Android package names this sound applies to |
iOS | No | Array of iOS bundle IDs this sound applies to |
How Sound Resolution Works
When a notification arrives, NotiVR picks a sound using this priority:
- User override — if the user manually assigned a sound to the app in settings, use that
- Pack default — if a pack maps a sound to the app, use the first match (pack priority order)
- Global default — fall back to the user's default notification sound