Skip to main content

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:
  1. 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
  2. Verify the macOS app builds cleanly (no warnings):