> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fased.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Device Model Database

# Device model database (friendly names)

The macOS companion app and **Advanced > Nodes** diagnostics show friendly Apple
device model names. They map Apple model identifiers, such as `iPad16,6` and
`Mac16,6`, to human-readable names.

The mapping is vendored as JSON under:

* `apps/macos/Sources/FasedAgent/Resources/DeviceModels/`

## Data source

We currently vendor the mapping from the MIT-licensed repository:

* `kyle-seongwoo-jun/apple-device-identifiers`

To keep builds deterministic, the JSON files are pinned to specific upstream
commits. The pinned commits are recorded in:

* `apps/macos/Sources/FasedAgent/Resources/DeviceModels/NOTICE.md`

## Updating the database

1. Pick the upstream commits you want to pin to (one for iOS, one for macOS).
2. Update the commit hashes in `apps/macos/Sources/FasedAgent/Resources/DeviceModels/NOTICE.md`.
3. Re-download the JSON files, pinned to those commits:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
IOS_COMMIT="<commit sha for ios-device-identifiers.json>"
MAC_COMMIT="<commit sha for mac-device-identifiers.json>"
DEVICE_DB_BASE="https://raw.githubusercontent.com/kyle-seongwoo-jun/apple-device-identifiers"

curl -fsSL "${DEVICE_DB_BASE}/${IOS_COMMIT}/ios-device-identifiers.json" \
  -o apps/macos/Sources/FasedAgent/Resources/DeviceModels/ios-device-identifiers.json

curl -fsSL "${DEVICE_DB_BASE}/${MAC_COMMIT}/mac-device-identifiers.json" \
  -o apps/macos/Sources/FasedAgent/Resources/DeviceModels/mac-device-identifiers.json
```

4. Ensure the vendored license still matches upstream. Replace it if the
   upstream license changes:
   `apps/macos/Sources/FasedAgent/Resources/DeviceModels/LICENSE.apple-device-identifiers.txt`
5. Verify the macOS app builds cleanly (no warnings):

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
swift build --package-path apps/macos
```