Icons
Icon format requirements, entry fields, and matching logic
Icons are PNG images that replace the default app icon in VR notifications.
Format Requirements
- File format: PNG only
- Recommended size: 128x128 or 256x256 pixels (square)
- File extension:
.png
Icon Entry Fields
| Field | Required | Description |
|---|---|---|
Android | No | Android package name (e.g. "com.discord") |
iOS | No | iOS bundle ID (e.g. "com.hammerandchisel.discord") |
iOSCategory | No | iOS notification category fallback (e.g. "Email", "Social") |
PNG | Yes | Relative path to the PNG file |
You should include at least one of Android, iOS, or iOSCategory so the icon actually matches something.
How Icon Matching Works
When a notification comes in, NotiVR checks your packs in priority order:
- Direct match — checks
AndroidoriOSfield against the app's package/bundle ID - iOS category fallback — if no direct match, checks
iOSCategoryagainst the ANCS notification category
First match wins. If no pack has a matching icon, NotiVR uses the default.
iOS Category Values
When matching by iOS notification category, these are the standard ANCS category values:
OtherIncomingCallMissedCallVoicemailSocialScheduleEmailNewsHealthAndFitnessBusinessAndFinanceLocationEntertainment
Category matching is useful as a catch-all. For example, you could set a generic mail icon for iOSCategory: "Email" to cover all email apps that don't have a specific icon entry.