Sounds
Sound format requirements, entry fields, and resolution logic
Sounds are OGG audio files that play when a notification arrives.
Format Requirements
- File format: OGG Vorbis only
- File extension:
.ogg - Duration: Keep it short. 0.5 to 2 seconds is ideal. NotiVR will only play the first 10 seconds.
Sound Entry Fields
Each sound is a key-value pair in the Sounds object. The key, for example "ding", is the sound's internal ID.
| Field | Required | Description |
|---|---|---|
Name | Yes | Display name shown in settings |
Ogg | Yes | Relative path to the OGG file |
Android | No | Android package names this sound should match |
iOS | No | iOS bundle IDs this sound should match |
Leave Android and iOS empty if you want the sound to be available for manual selection without automatically applying it to any app.
How Sound Resolution Works
When a notification arrives, NotiVR picks a sound in this order:
- Per-app override: if the user has selected a custom sound for the app in settings.
- Pack match: the first sound that maps to the app, using pack priority order.
- Default sound: the user's global default sound.
- None: no sound if nothing is configured.