https://github.com/telemetrydeck/applemodelnames
A mapping of Apple model names to readable names
https://github.com/telemetrydeck/applemodelnames
Last synced: 8 months ago
JSON representation
A mapping of Apple model names to readable names
- Host: GitHub
- URL: https://github.com/telemetrydeck/applemodelnames
- Owner: TelemetryDeck
- Created: 2023-11-29T16:26:54.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-10-27T16:35:15.000Z (8 months ago)
- Last Synced: 2025-10-27T18:28:36.845Z (8 months ago)
- Language: JavaScript
- Size: 20.5 KB
- Stars: 1
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Apple Model Names for TelemetryDeck
A mapping of Apple model names to readable names. We're using this as the basis for [TelemetryDeck](https://telemetrydeck.com)'s device detection.
Help TelemetryDeck and the community by adding new devices or correcting existing ones. Just open a pull request. 🩵
## Type Definitions
`dataset.json` contains a single JSON object with the following structure:
```json
{
"": {
"deviceType": "",
"processorFamily": "",
"processorType": "",
"readableName": ""
}
}
```
We then use `process.mjs` to generate individual JSON files for readableName, deviceType, processorType and processorFamily that will directly map from modelName to readableName/deviceType/processorType/processorFamily. These can then be used in TelemetryDeck as Lookup Tables.
## Example
`dataset.json`
```json
{
"MacBookPro16,1": {
"deviceType": "Laptop",
"processorFamily": "Intel Core i5",
"processorType": "Intel",
"readableName": "MacBook Pro 13-inch (2019)"
}
}
```
Will result in the following files:
`appleModelNames.json`
```json
{
"MacBookPro16,1": "MacBook Pro 13-inch (2019)"
}
```
`deviceTypes.json`
```json
{
"MacBookPro16,1": "Laptop"
}
```
`processorTypes.json`
```json
{
"MacBookPro16,1": "Intel"
}
```
`processorFamilies.json`
```json
{
"MacBookPro16,1": "Intel Core i5"
}
```