Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -347,7 +347,7 @@ Collected on iOS 7. Unofficial, and may differ on other iOS versions.

## SystemSoundIDs added after iOS 7

293 IDs that aren't in the iOS 7 table above. Mappings and minimum versions come from [p-x9](https://github.com/p-x9/swift-system-sound/blob/e3f44c2d5766b0a7c3cdaacd4d61b5e1c8804794/SystemSoundTable.md) (MIT, iOS 16–26.0). Files were checked against the iOS 26 file list. Like everything here, they are unofficial, so test on a device. "≤ 16" means the ID existed in iOS 16 or earlier. The source data is in [`data/sounds.json`](data/sounds.json).
298 IDs that aren't in the iOS 7 table above. Mappings and minimum versions come from [p-x9](https://github.com/p-x9/swift-system-sound/blob/46a556c57d32cbae13ee2023c599bc6efcb628a6/SystemSoundTable.md) (MIT, iOS 16–27.0; iOS 27 IDs from [p-x9/swift-system-sound#16](https://github.com/p-x9/swift-system-sound/pull/16)). Files were checked against the iOS 26 and iOS 27 file lists. Like everything here, they are unofficial, so test on a device. "≤ 16" means the ID existed in iOS 16 or earlier. The source data is in [`data/sounds.json`](data/sounds.json).

| SystemSoundID | File name | Folder | Category | Min iOS | Confidence |
| --- | --- | --- | --- | --- | --- |
Expand All @@ -361,6 +361,7 @@ Collected on iOS 7. Unofficial, and may differ on other iOS versions.
| 37 | ringback_tone_hk.caf | nano | InCallSystemSound | ≤ 16 | medium |
| 38 | ringback_tone_aus.caf | nano | InCallSystemSound | ≤ 16 | medium |
| 39 | ringback_tone_uk.caf | nano | InCallSystemSound | ≤ 16 | medium |
| 40 | call_waiting_tone_low_priority.caf | nano | InCallSystemSound | 27.0 | medium |
| 1017 | alarm.caf | (root) | ReminderAlert | ≤ 16 | medium |
| 1018 | Swish.caf | (root) | MailSent | ≤ 16 | medium |
| 1060 | WebcamStart.caf | (root) | WebcamStartAlwaysHeard | 16.0 | medium |
Expand Down Expand Up @@ -399,6 +400,9 @@ Collected on iOS 7. Unofficial, and may differ on other iOS versions.
| 1169 | EarInteraction_Complete.caf | (root) | EarInteraction_Complete | 18.1 | medium |
| 1174 | - | - | Time_To_Run | 16.0 | medium |
| 1175 | - | - | Time_To_Walk | 16.0 | medium |
| 1176 | GymKitConnecting.caf | (root) | GymKit | 27.0 | medium |
| 1177 | GymKitConnected.caf | (root) | GymKit | 27.0 | medium |
| 1178 | GymKitDisconnected.caf | (root) | GymKit | 27.0 | medium |
| 1253 | DeviceShutdown.caf | (root) | DeviceShutdown | 16.0 | medium |
| 1260 | camera_timer_final_second.caf | (root) | CameraShutterAlt | ≤ 16 | medium |
| 1261 | camera_timer_countdown.caf | (root) | CameraShutterAlt | ≤ 16 | medium |
Expand Down Expand Up @@ -445,6 +449,7 @@ Collected on iOS 7. Unofficial, and may differ on other iOS versions.
| 1372 | HeadGesturesDoubleShake.caf | nano | - | 18.0 | medium |
| 1373 | HeadGesturesPartialNod.caf | nano | - | 18.0 | medium |
| 1374 | HeadGesturesPartialShake.caf | nano | - | 18.0 | medium |
| 1381 | - | - | HomeDeviceHourlyChime | 27.0 | medium |
| 1390 | LiveTranslationStart.caf | (root) | PersonalTranslator | 26.0 | medium |
| 1391 | LiveTranslationStop.caf | (root) | PersonalTranslator | 26.0 | medium |
| 1392 | DualBudLongPressFailure.caf | (root) | PersonalTranslator | 26.0 | medium |
Expand Down Expand Up @@ -1339,7 +1344,7 @@ Collected on iOS 7. Unofficial, and may differ on other iOS versions.

## Changes since iOS 7

Differences between the original iOS 7 data above (left unchanged) and recent iOS versions. Sources: [p-x9](https://github.com/p-x9/swift-system-sound/blob/e3f44c2d5766b0a7c3cdaacd4d61b5e1c8804794/SystemSoundTable.md) and the iOS 17–27 file lists in [`data/uisounds/`](data/uisounds/).
Differences between the original iOS 7 data above (left unchanged) and recent iOS versions. Sources: [p-x9](https://github.com/p-x9/swift-system-sound/blob/46a556c57d32cbae13ee2023c599bc6efcb628a6/SystemSoundTable.md) and the iOS 17–27 file lists in [`data/uisounds/`](data/uisounds/).

### File mapping differs

Expand Down
858 changes: 449 additions & 409 deletions Sources/SystemSoundsLibrary/SystemSound+Catalog.swift

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The [iOSSystemSoundsLibrary](https://github.com/TUNER88/iOSSystemSoundsLibrary)
IDs and sound files, with copy-paste snippets for Swift, SwiftUI and Objective-C.

If you'd rather use names than raw IDs, `SystemSoundsLibrary` wraps the same calls. It has a
typed catalog of 418 known sounds, generated from `data/sounds.json`, with `@available`
typed catalog of 423 known sounds, generated from `data/sounds.json`, with `@available`
annotations for sounds added in newer iOS versions:

```swift
Expand Down
2 changes: 1 addition & 1 deletion Tests/SystemSoundsLibraryTests/SystemSoundTests.swift
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ private func loadSoundsFile() throws -> SoundsFile {
struct CatalogTests {
@Test func idsAndNamesAreUnique() {
let all = SystemSound.all
#expect(all.count == 418)
#expect(all.count == 423)
#expect(Set(all.map(\.id)).count == all.count)
#expect(Set(all.map(\.name)).count == all.count)
#expect(all.map(\.id) == all.map(\.id).sorted())
Expand Down
6 changes: 3 additions & 3 deletions data/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Machine-readable catalog of iOS system sounds. It backs the README tables and th

| File | Contents |
| --- | --- |
| `sounds.json` | 418 SystemSoundIDs: file, folder, category, minimum iOS, status, confidence, source |
| `sounds.json` | 423 SystemSoundIDs: file, folder, category, minimum iOS, status, confidence, source |
| `sounds.schema.json` | JSON Schema (draft 2020-12) for `sounds.json` |
| `uisounds/ios-7.0.2.txt` | Files in `/System/Library/Audio/UISounds` on iOS 7.0.2 (the original README list) |
| `uisounds/ios-{17,18,18.1,26,27}.txt` | Files in `/System/Library/Audio/UISounds` on later iOS versions |
Expand All @@ -19,7 +19,7 @@ Run `python3 scripts/validate_data.py` (needs `jsonschema`) to check the data. C
| `name` | string | Stable lowerCamelCase identifier, used for generated Swift constants |
| `file` | string or null | Sound file name. `null` = no file (vibration/haptic-only or unknown) |
| `folder` | string or null | Sub-folder of `/System/Library/Audio/UISounds`: `""` (root), `New`, `Modern`, `nano` |
| `path` | string or null | Full file path on recent iOS (checked against the iOS 26 file list) |
| `path` | string or null | Full file path on recent iOS (checked against the iOS 27 file list) |
| `category` | string or null | Internal category name |
| `minIOS` | string or null | First iOS version with this ID (`"17.0"`). `null` = available before iOS 16 or unknown |
| `status` | enum | `current`, `changed-since-ios7` (file or category differs from the iOS 7 table), `removed` |
Expand All @@ -33,7 +33,7 @@ None of this is documented by Apple. IDs and files can change between iOS versio
## Sources and attribution

- **Original iOS 7 table and file list**: this repository's README (collected on iOS 7 / 7.0.2).
- **p-x9/swift-system-sound**: the SystemSoundID → file/category mapping and the minimum iOS versions (up to iOS 26.0) come from [SystemSoundTable.md](https://github.com/p-x9/swift-system-sound/blob/e3f44c2d5766b0a7c3cdaacd4d61b5e1c8804794/SystemSoundTable.md) at commit `e3f44c2`, used under the MIT License:
- **p-x9/swift-system-sound**: the SystemSoundID → file/category mapping and the minimum iOS versions (up to iOS 27.0) come from [SystemSoundTable.md](https://github.com/p-x9/swift-system-sound/blob/46a556c57d32cbae13ee2023c599bc6efcb628a6/SystemSoundTable.md) at commit `46a556c`, used under the MIT License. The iOS 27 IDs were added by @p-x9 in [p-x9/swift-system-sound#16](https://github.com/p-x9/swift-system-sound/pull/16) (thanks!):

```text
MIT License
Expand Down
90 changes: 87 additions & 3 deletions data/sounds.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"$schema": "./sounds.schema.json",
"version": 1,
"generated": "2026-10-18",
"generated": "2026-11-01",
"sources": {
"readme-ios7": "README.md \"List of SystemSoundIDs\" table (collected on iOS 7)",
"p-x9": "https://github.com/p-x9/swift-system-sound/blob/e3f44c2d5766b0a7c3cdaacd4d61b5e1c8804794/SystemSoundTable.md (MIT, Copyright (c) 2023 p-x9)",
"onj-dump": "https://3.onj.me/phonetones/unzipped/Apple/iOS-26/System/Library/Audio/UISounds/ (file exists in the iOS 26 filesystem dump)"
"p-x9": "https://github.com/p-x9/swift-system-sound/blob/46a556c57d32cbae13ee2023c599bc6efcb628a6/SystemSoundTable.md (MIT, Copyright (c) 2023 p-x9; iOS 27 additions from https://github.com/p-x9/swift-system-sound/pull/16)",
"onj-dump": "https://3.onj.me/phonetones/unzipped/Apple/ (file exists in the iOS 26 or iOS 27 filesystem dump)"
},
"sounds": [
{
Expand Down Expand Up @@ -178,6 +178,23 @@
"ios7": null,
"notes": null
},
{
"id": 40,
"name": "inCallSystemSoundCallWaitingToneLowPriority",
"file": "call_waiting_tone_low_priority.caf",
"folder": "nano",
"path": "/System/Library/Audio/UISounds/nano/call_waiting_tone_low_priority.caf",
"category": "InCallSystemSound",
"minIOS": "27.0",
"status": "current",
"confidence": "medium",
"source": [
"p-x9",
"onj-dump"
],
"ios7": null,
"notes": "Added in iOS 27 according to p-x9/swift-system-sound#16 (https://github.com/p-x9/swift-system-sound/pull/16)."
},
{
"id": 1000,
"name": "mailReceived",
Expand Down Expand Up @@ -2306,6 +2323,57 @@
"ios7": null,
"notes": null
},
{
"id": 1176,
"name": "gymKitConnecting",
"file": "GymKitConnecting.caf",
"folder": "",
"path": "/System/Library/Audio/UISounds/GymKitConnecting.caf",
"category": "GymKit",
"minIOS": "27.0",
"status": "current",
"confidence": "medium",
"source": [
"p-x9",
"onj-dump"
],
"ios7": null,
"notes": "Added in iOS 27 according to p-x9/swift-system-sound#16 (https://github.com/p-x9/swift-system-sound/pull/16)."
},
{
"id": 1177,
"name": "gymKitConnected",
"file": "GymKitConnected.caf",
"folder": "",
"path": "/System/Library/Audio/UISounds/GymKitConnected.caf",
"category": "GymKit",
"minIOS": "27.0",
"status": "current",
"confidence": "medium",
"source": [
"p-x9",
"onj-dump"
],
"ios7": null,
"notes": "Added in iOS 27 according to p-x9/swift-system-sound#16 (https://github.com/p-x9/swift-system-sound/pull/16)."
},
{
"id": 1178,
"name": "gymKitDisconnected",
"file": "GymKitDisconnected.caf",
"folder": "",
"path": "/System/Library/Audio/UISounds/GymKitDisconnected.caf",
"category": "GymKit",
"minIOS": "27.0",
"status": "current",
"confidence": "medium",
"source": [
"p-x9",
"onj-dump"
],
"ios7": null,
"notes": "Added in iOS 27 according to p-x9/swift-system-sound#16 (https://github.com/p-x9/swift-system-sound/pull/16)."
},
{
"id": 1200,
"name": "touchToneDtmf0",
Expand Down Expand Up @@ -4194,6 +4262,22 @@
"ios7": null,
"notes": null
},
{
"id": 1381,
"name": "homeDeviceHourlyChime",
"file": null,
"folder": null,
"path": null,
"category": "HomeDeviceHourlyChime",
"minIOS": "27.0",
"status": "current",
"confidence": "medium",
"source": [
"p-x9"
],
"ios7": null,
"notes": "Added in iOS 27 according to p-x9/swift-system-sound#16 (https://github.com/p-x9/swift-system-sound/pull/16). No sound file is listed for this ID."
},
{
"id": 1390,
"name": "personalTranslatorLiveTranslationStart",
Expand Down
4 changes: 2 additions & 2 deletions scripts/generate_readme.py
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
"- [List of all system audio files in iOS 27](#list-of-all-system-audio-files-in-ios-27)\n",
"- [Changes since iOS 7](#changes-since-ios-7)\n",
]
P9 = "[p-x9](https://github.com/p-x9/swift-system-sound/blob/e3f44c2d5766b0a7c3cdaacd4d61b5e1c8804794/SystemSoundTable.md)"
P9 = "[p-x9](https://github.com/p-x9/swift-system-sound/blob/46a556c57d32cbae13ee2023c599bc6efcb628a6/SystemSoundTable.md)"
BASE = "/System/Library/Audio/UISounds/"


Expand All @@ -47,7 +47,7 @@ def build():
out += [
"## SystemSoundIDs added after iOS 7",
"",
f"{len(new)} IDs that aren't in the iOS 7 table above. Mappings and minimum versions come from {P9} (MIT, iOS 16–26.0). Files were checked against the iOS 26 file list. "
f"{len(new)} IDs that aren't in the iOS 7 table above. Mappings and minimum versions come from {P9} (MIT, iOS 16–27.0; iOS 27 IDs from [p-x9/swift-system-sound#16](https://github.com/p-x9/swift-system-sound/pull/16)). Files were checked against the iOS 26 and iOS 27 file lists. "
"Like everything here, they are unofficial, so test on a device. \"≤ 16\" means the ID existed in iOS 16 or earlier. The source data is in [`data/sounds.json`](data/sounds.json).",
"",
"| SystemSoundID | File name | Folder | Category | Min iOS | Confidence |",
Expand Down
4 changes: 2 additions & 2 deletions scripts/validate_data.py
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,10 @@
if ids != sorted(ids):
errors.append("sounds are not sorted by id")

latest = set((ROOT / "data/uisounds/ios-26.txt").read_text().split())
latest = set((ROOT / "data/uisounds/ios-27.txt").read_text().split())
for s in sounds:
if s["path"] and s["status"] != "removed" and s["path"] not in latest:
errors.append(f"{s['id']}: path {s['path']} not in data/uisounds/ios-26.txt")
errors.append(f"{s['id']}: path {s['path']} not in data/uisounds/ios-27.txt")
if s["file"] and s["path"] and not s["path"].endswith("/" + s["file"]):
errors.append(f"{s['id']}: path does not end with file name")

Expand Down
Loading