en2zmax/neo-pod-desktop
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
neo-pod-desktop/src/vendor/ipod_device/models.py
Maksim Totmin 71f35c53cb refactor: vendor iOpenPod core modules instead of pip dependency 
Vendored 5 packages from iOpenPod (TheRealSavi/iOpenPod):
  iTunesDB_Writer/  — binary iTunesDB generation
  iTunesDB_Shared/  — field defs, constants, album identity
  SQLiteDB_Writer/  — SQLite databases for Nano 6G/7G
  iTunesDB_Parser/  — play stats reading from iPod
  ipod_device/      — device detection, FireWire ID, capabilities

Rationale: iOpenPod is a standalone iPod manager app, not a library.
Pulling it as a pip dependency is heavy and confusing for users.

Changes:
  + src/vendor/   — 77 .py files + calcHashAB.wasm (506 KB)
  ~ ipod_nano7_db.py  — _find_iop_root() now returns src/vendor/
  ~ requirements.txt   — iopenpod replaced with wasmtime + pycryptodome
  ~ .gitignore         — removed iOpenPod/ exclusion
  (setup.py reads requirements.txt automatically)
2026-06-02 09:16:19 +07:00

510 lines
30 KiB
Python
Raw Blame History

"""iPod model identification databases — model numbers, USB PIDs, and serial suffixes.
Data tables
~~~~~~~~~~~
- ``IPOD_MODELS`` Model number → (family, gen, capacity, color)
- ``USB_PID_TO_MODEL`` USB Product ID → (family, gen)
- ``IPOD_USB_PIDS`` All known iPod USB Product IDs (frozenset)
- ``SERIAL_LAST3_TO_MODEL`` Serial suffix → model number
Sources
~~~~~~~
- Universal Compendium iPod Models table (universalcompendium.com)
- The Apple Wiki: Models/iPod (theapplewiki.com)
- Linux USB ID Repository
- libgpod ``itdb_device.c``
"""
# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║ Comprehensive iPod model database ║
# ╚═══════════════════════════════════════════════════════════════════════════╝
#
# Maps order number prefixes to (product_line, generation, capacity, color)
#
# Generation naming conventions:
# The full-size iPod line has TWO numbering systems. This table uses the
# product-specific generation (matching what users see in "About" screens),
# with the overall iPod lineage noted in comments.
#
# Overall iPod gen │ Product-specific gen │ Years │ Apple Model
# ─────────────────┼──────────────────────┼───────┼────────────
# 1st gen │ iPod 1st Gen │ 2001 │ M8541
# 2nd gen │ iPod 2nd Gen │ 2002 │ A1019
# 3rd gen │ iPod 3rd Gen │ 2003 │ A1040
# 4th gen │ iPod 4th Gen │ 2004 │ A1059
# 4th gen (color) │ iPod Photo │ 2004 │ A1099
# 5th gen │ iPod Video 5th Gen │ 2005 │ A1136
# 5.5th gen │ iPod Video 5.5th Gen │ 2006 │ A1136 (Rev B)
# 6th gen │ iPod Classic 1st Gen │ 2007 │ A1238
# 6.5th gen │ iPod Classic 2nd Gen │ 2008 │ A1238 (Rev A)
# 7th gen │ iPod Classic 3rd Gen │ 2009 │ A1238 (Rev B/C)
IPOD_MODELS: dict[str, tuple[str, str, str, str]] = {
# ==========================================================================
# iPod Classic (2007-2009)
# ==========================================================================
'MB029': ("iPod Classic", "1st Gen", "80GB", "Silver"),
'MB147': ("iPod Classic", "1st Gen", "80GB", "Black"),
'MB145': ("iPod Classic", "1st Gen", "160GB", "Silver"),
'MB150': ("iPod Classic", "1st Gen", "160GB", "Black"),
'MB562': ("iPod Classic", "2nd Gen", "120GB", "Silver"),
'MB565': ("iPod Classic", "2nd Gen", "120GB", "Black"),
'MC293': ("iPod Classic", "3rd Gen", "160GB", "Silver"),
'MC297': ("iPod Classic", "3rd Gen", "160GB", "Black"),
# ==========================================================================
# iPod (Scroll Wheel) — 1st Generation (2001)
# ==========================================================================
'M8513': ("iPod", "1st Gen", "5GB", "White"),
'M8541': ("iPod", "1st Gen", "5GB", "White"),
'M8697': ("iPod", "1st Gen", "5GB", "White"),
'M8709': ("iPod", "1st Gen", "10GB", "White"),
# ==========================================================================
# iPod (Touch Wheel) — 2nd Generation (2002)
# ==========================================================================
'M8737': ("iPod", "2nd Gen", "10GB", "White"),
'M8740': ("iPod", "2nd Gen", "10GB", "White"),
'M8738': ("iPod", "2nd Gen", "20GB", "White"),
'M8741': ("iPod", "2nd Gen", "20GB", "White"),
# ==========================================================================
# iPod (Dock Connector) — 3rd Generation (2003)
# ==========================================================================
'M8976': ("iPod", "3rd Gen", "10GB", "White"),
'M8946': ("iPod", "3rd Gen", "15GB", "White"),
'M8948': ("iPod", "3rd Gen", "30GB", "White"),
'M9244': ("iPod", "3rd Gen", "20GB", "White"),
'M9245': ("iPod", "3rd Gen", "40GB", "White"),
'M9460': ("iPod", "3rd Gen", "15GB", "White"),
# ==========================================================================
# iPod (Click Wheel) — 4th Generation (2004)
# ==========================================================================
'M9268': ("iPod", "4th Gen", "40GB", "White"),
'M9282': ("iPod", "4th Gen", "20GB", "White"),
'ME436': ("iPod", "4th Gen", "40GB", "White"),
'M9787': ("iPod U2", "4th Gen", "20GB", "Black"),
# ==========================================================================
# iPod Photo / iPod with color Display — 4th Gen (Color) (2004-2005)
# ==========================================================================
'M9585': ("iPod Photo", "4th Gen", "40GB", "White"),
'M9586': ("iPod Photo", "4th Gen", "60GB", "White"),
'M9829': ("iPod Photo", "4th Gen", "30GB", "White"),
'M9830': ("iPod Photo", "4th Gen", "60GB", "White"),
'MA079': ("iPod Photo", "4th Gen", "20GB", "White"),
'MA127': ("iPod U2", "4th Gen", "20GB", "Black"),
'MS492': ("iPod Photo", "4th Gen", "30GB", "White"),
'MA215': ("iPod Photo", "4th Gen", "20GB", "White"),
# ==========================================================================
# iPod Video — 5th Generation (2005)
# ==========================================================================
'MA002': ("iPod Video", "5th Gen", "30GB", "White"),
'MA003': ("iPod Video", "5th Gen", "60GB", "White"),
'MA146': ("iPod Video", "5th Gen", "30GB", "Black"),
'MA147': ("iPod Video", "5th Gen", "60GB", "Black"),
'MA452': ("iPod Video U2", "5th Gen", "30GB", "Black"),
# ==========================================================================
# iPod Video — 5.5th Generation / Enhanced (Late 2006)
# ==========================================================================
'MA444': ("iPod Video", "5.5th Gen", "30GB", "White"),
'MA446': ("iPod Video", "5.5th Gen", "30GB", "Black"),
'MA448': ("iPod Video", "5.5th Gen", "80GB", "White"),
'MA450': ("iPod Video", "5.5th Gen", "80GB", "Black"),
'MA664': ("iPod Video U2", "5.5th Gen", "30GB", "Black"),
# ==========================================================================
# iPod Mini — 1st Generation (2004)
# ==========================================================================
'M9160': ("iPod Mini", "1st Gen", "4GB", "Silver"),
'M9434': ("iPod Mini", "1st Gen", "4GB", "Green"),
'M9435': ("iPod Mini", "1st Gen", "4GB", "Pink"),
'M9436': ("iPod Mini", "1st Gen", "4GB", "Blue"),
'M9437': ("iPod Mini", "1st Gen", "4GB", "Gold"),
# ==========================================================================
# iPod Mini — 2nd Generation (2005)
# ==========================================================================
'M9800': ("iPod Mini", "2nd Gen", "4GB", "Silver"),
'M9801': ("iPod Mini", "2nd Gen", "6GB", "Silver"),
'M9802': ("iPod Mini", "2nd Gen", "4GB", "Blue"),
'M9803': ("iPod Mini", "2nd Gen", "6GB", "Blue"),
'M9804': ("iPod Mini", "2nd Gen", "4GB", "Pink"),
'M9805': ("iPod Mini", "2nd Gen", "6GB", "Pink"),
'M9806': ("iPod Mini", "2nd Gen", "4GB", "Green"),
'M9807': ("iPod Mini", "2nd Gen", "6GB", "Green"),
# ==========================================================================
# iPod Nano — 1st Generation (2005)
# ==========================================================================
'MA004': ("iPod Nano", "1st Gen", "2GB", "White"),
'MA005': ("iPod Nano", "1st Gen", "4GB", "White"),
'MA099': ("iPod Nano", "1st Gen", "2GB", "Black"),
'MA107': ("iPod Nano", "1st Gen", "4GB", "Black"),
'MA350': ("iPod Nano", "1st Gen", "1GB", "White"),
'MA352': ("iPod Nano", "1st Gen", "1GB", "Black"),
# ==========================================================================
# iPod Nano — 2nd Generation (2006)
# ==========================================================================
'MA426': ("iPod Nano", "2nd Gen", "4GB", "Silver"),
'MA428': ("iPod Nano", "2nd Gen", "4GB", "Blue"),
'MA477': ("iPod Nano", "2nd Gen", "2GB", "Silver"),
'MA487': ("iPod Nano", "2nd Gen", "4GB", "Green"),
'MA489': ("iPod Nano", "2nd Gen", "4GB", "Pink"),
'MA497': ("iPod Nano", "2nd Gen", "8GB", "Black"),
'MA725': ("iPod Nano", "2nd Gen", "4GB", "Red"),
'MA726': ("iPod Nano", "2nd Gen", "8GB", "Red"),
'MA899': ("iPod Nano", "2nd Gen", "8GB", "Red"),
# ==========================================================================
# iPod Nano — 3rd Generation (2007)
# ==========================================================================
'MA978': ("iPod Nano", "3rd Gen", "4GB", "Silver"),
'MA980': ("iPod Nano", "3rd Gen", "8GB", "Silver"),
'MB249': ("iPod Nano", "3rd Gen", "8GB", "Blue"),
'MB253': ("iPod Nano", "3rd Gen", "8GB", "Green"),
'MB257': ("iPod Nano", "3rd Gen", "8GB", "Red"),
'MB261': ("iPod Nano", "3rd Gen", "8GB", "Black"),
'MB453': ("iPod Nano", "3rd Gen", "8GB", "Pink"),
# ==========================================================================
# iPod Nano — 4th Generation (2008)
# ==========================================================================
'MB480': ("iPod Nano", "4th Gen", "4GB", "Silver"),
'MB651': ("iPod Nano", "4th Gen", "4GB", "Blue"),
'MB654': ("iPod Nano", "4th Gen", "4GB", "Pink"),
'MB657': ("iPod Nano", "4th Gen", "4GB", "Purple"),
'MB660': ("iPod Nano", "4th Gen", "4GB", "Orange"),
'MB663': ("iPod Nano", "4th Gen", "4GB", "Green"),
'MB666': ("iPod Nano", "4th Gen", "4GB", "Yellow"),
'MB598': ("iPod Nano", "4th Gen", "8GB", "Silver"),
'MB732': ("iPod Nano", "4th Gen", "8GB", "Blue"),
'MB735': ("iPod Nano", "4th Gen", "8GB", "Pink"),
'MB739': ("iPod Nano", "4th Gen", "8GB", "Purple"),
'MB742': ("iPod Nano", "4th Gen", "8GB", "Orange"),
'MB745': ("iPod Nano", "4th Gen", "8GB", "Green"),
'MB748': ("iPod Nano", "4th Gen", "8GB", "Yellow"),
'MB751': ("iPod Nano", "4th Gen", "8GB", "Red"),
'MB754': ("iPod Nano", "4th Gen", "8GB", "Black"),
'MB903': ("iPod Nano", "4th Gen", "16GB", "Silver"),
'MB905': ("iPod Nano", "4th Gen", "16GB", "Blue"),
'MB907': ("iPod Nano", "4th Gen", "16GB", "Pink"),
'MB909': ("iPod Nano", "4th Gen", "16GB", "Purple"),
'MB911': ("iPod Nano", "4th Gen", "16GB", "Orange"),
'MB913': ("iPod Nano", "4th Gen", "16GB", "Green"),
'MB915': ("iPod Nano", "4th Gen", "16GB", "Yellow"),
'MB917': ("iPod Nano", "4th Gen", "16GB", "Red"),
'MB918': ("iPod Nano", "4th Gen", "16GB", "Black"),
# ==========================================================================
# iPod Nano — 5th Generation (2009)
# ==========================================================================
'MC027': ("iPod Nano", "5th Gen", "8GB", "Silver"),
'MC031': ("iPod Nano", "5th Gen", "8GB", "Black"),
'MC034': ("iPod Nano", "5th Gen", "8GB", "Purple"),
'MC037': ("iPod Nano", "5th Gen", "8GB", "Blue"),
'MC040': ("iPod Nano", "5th Gen", "8GB", "Green"),
'MC043': ("iPod Nano", "5th Gen", "8GB", "Yellow"),
'MC046': ("iPod Nano", "5th Gen", "8GB", "Orange"),
'MC049': ("iPod Nano", "5th Gen", "8GB", "Red"),
'MC050': ("iPod Nano", "5th Gen", "8GB", "Pink"),
'MC060': ("iPod Nano", "5th Gen", "16GB", "Silver"),
'MC062': ("iPod Nano", "5th Gen", "16GB", "Black"),
'MC064': ("iPod Nano", "5th Gen", "16GB", "Purple"),
'MC066': ("iPod Nano", "5th Gen", "16GB", "Blue"),
'MC068': ("iPod Nano", "5th Gen", "16GB", "Green"),
'MC070': ("iPod Nano", "5th Gen", "16GB", "Yellow"),
'MC072': ("iPod Nano", "5th Gen", "16GB", "Orange"),
'MC074': ("iPod Nano", "5th Gen", "16GB", "Red"),
'MC075': ("iPod Nano", "5th Gen", "16GB", "Pink"),
# ==========================================================================
# iPod Nano — 6th Generation (2010)
# ==========================================================================
'MC525': ("iPod Nano", "6th Gen", "8GB", "Silver"),
'MC688': ("iPod Nano", "6th Gen", "8GB", "Graphite"),
'MC689': ("iPod Nano", "6th Gen", "8GB", "Blue"),
'MC690': ("iPod Nano", "6th Gen", "8GB", "Green"),
'MC691': ("iPod Nano", "6th Gen", "8GB", "Orange"),
'MC692': ("iPod Nano", "6th Gen", "8GB", "Pink"),
'MC693': ("iPod Nano", "6th Gen", "8GB", "Red"),
'MC526': ("iPod Nano", "6th Gen", "16GB", "Silver"),
'MC694': ("iPod Nano", "6th Gen", "16GB", "Graphite"),
'MC695': ("iPod Nano", "6th Gen", "16GB", "Blue"),
'MC696': ("iPod Nano", "6th Gen", "16GB", "Green"),
'MC697': ("iPod Nano", "6th Gen", "16GB", "Orange"),
'MC698': ("iPod Nano", "6th Gen", "16GB", "Pink"),
'MC699': ("iPod Nano", "6th Gen", "16GB", "Red"),
# ==========================================================================
# iPod Nano — 7th Generation (2012)
# ==========================================================================
'MD475': ("iPod Nano", "7th Gen", "16GB", "Pink"),
'MD476': ("iPod Nano", "7th Gen", "16GB", "Yellow"),
'MD477': ("iPod Nano", "7th Gen", "16GB", "Blue"),
'MD478': ("iPod Nano", "7th Gen", "16GB", "Green"),
'MD479': ("iPod Nano", "7th Gen", "16GB", "Purple"),
'MD480': ("iPod Nano", "7th Gen", "16GB", "Silver"),
'MD481': ("iPod Nano", "7th Gen", "16GB", "Slate"),
'MD744': ("iPod Nano", "7th Gen", "16GB", "Red"),
'ME971': ("iPod Nano", "7th Gen", "16GB", "Space Gray"),
'MKMV2': ("iPod Nano", "7th Gen", "16GB", "Pink"),
'MKMX2': ("iPod Nano", "7th Gen", "16GB", "Gold"),
'MKN02': ("iPod Nano", "7th Gen", "16GB", "Blue"),
'MKN22': ("iPod Nano", "7th Gen", "16GB", "Silver"),
'MKN52': ("iPod Nano", "7th Gen", "16GB", "Space Gray"),
'MKN72': ("iPod Nano", "7th Gen", "16GB", "Red"),
# ==========================================================================
# iPod Shuffle — 1st Generation (2005)
# ==========================================================================
'M9724': ("iPod Shuffle", "1st Gen", "512MB", "White"),
'M9725': ("iPod Shuffle", "1st Gen", "1GB", "White"),
# ==========================================================================
# iPod Shuffle — 2nd Generation (2006-2008)
# ==========================================================================
'MA546': ("iPod Shuffle", "2nd Gen", "1GB", "Silver"),
'MA564': ("iPod Shuffle", "2nd Gen", "1GB", "Silver"),
'MA947': ("iPod Shuffle", "2nd Gen", "1GB", "Pink"),
'MA949': ("iPod Shuffle", "2nd Gen", "1GB", "Blue"),
'MA951': ("iPod Shuffle", "2nd Gen", "1GB", "Green"),
'MA953': ("iPod Shuffle", "2nd Gen", "1GB", "Orange"),
'MB225': ("iPod Shuffle", "2nd Gen", "1GB", "Silver"),
'MB227': ("iPod Shuffle", "2nd Gen", "1GB", "Blue"),
'MB228': ("iPod Shuffle", "2nd Gen", "1GB", "Blue"),
'MB229': ("iPod Shuffle", "2nd Gen", "1GB", "Green"),
'MB231': ("iPod Shuffle", "2nd Gen", "1GB", "Red"),
'MB233': ("iPod Shuffle", "2nd Gen", "1GB", "Purple"),
'MB518': ("iPod Shuffle", "2nd Gen", "2GB", "Silver"),
'MB520': ("iPod Shuffle", "2nd Gen", "2GB", "Blue"),
'MB522': ("iPod Shuffle", "2nd Gen", "2GB", "Green"),
'MB524': ("iPod Shuffle", "2nd Gen", "2GB", "Red"),
'MB526': ("iPod Shuffle", "2nd Gen", "2GB", "Purple"),
'MB811': ("iPod Shuffle", "2nd Gen", "1GB", "Pink"),
'MB813': ("iPod Shuffle", "2nd Gen", "1GB", "Blue"),
'MB815': ("iPod Shuffle", "2nd Gen", "1GB", "Green"),
'MB817': ("iPod Shuffle", "2nd Gen", "1GB", "Red"),
'MB681': ("iPod Shuffle", "2nd Gen", "2GB", "Pink"),
'MB683': ("iPod Shuffle", "2nd Gen", "2GB", "Blue"),
'MB685': ("iPod Shuffle", "2nd Gen", "2GB", "Green"),
'MB779': ("iPod Shuffle", "2nd Gen", "2GB", "Red"),
'MC167': ("iPod Shuffle", "2nd Gen", "1GB", "Gold"),
# ==========================================================================
# iPod Shuffle — 3rd Generation (2009)
# ==========================================================================
'MB867': ("iPod Shuffle", "3rd Gen", "4GB", "Silver"),
'MC164': ("iPod Shuffle", "3rd Gen", "4GB", "Black"),
'MC306': ("iPod Shuffle", "3rd Gen", "2GB", "Silver"),
'MC323': ("iPod Shuffle", "3rd Gen", "2GB", "Black"),
'MC381': ("iPod Shuffle", "3rd Gen", "2GB", "Green"),
'MC384': ("iPod Shuffle", "3rd Gen", "2GB", "Blue"),
'MC387': ("iPod Shuffle", "3rd Gen", "2GB", "Pink"),
'MC303': ("iPod Shuffle", "3rd Gen", "4GB", "Stainless Steel"),
'MC307': ("iPod Shuffle", "3rd Gen", "4GB", "Green"),
'MC328': ("iPod Shuffle", "3rd Gen", "4GB", "Blue"),
'MC331': ("iPod Shuffle", "3rd Gen", "4GB", "Pink"),
# ==========================================================================
# iPod Shuffle — 4th Generation (2010-2015)
# ==========================================================================
'MC584': ("iPod Shuffle", "4th Gen", "2GB", "Silver"),
'MC585': ("iPod Shuffle", "4th Gen", "2GB", "Pink"),
'MC749': ("iPod Shuffle", "4th Gen", "2GB", "Orange"),
'MC750': ("iPod Shuffle", "4th Gen", "2GB", "Green"),
'MC751': ("iPod Shuffle", "4th Gen", "2GB", "Blue"),
'MD773': ("iPod Shuffle", "4th Gen", "2GB", "Pink"),
'MD774': ("iPod Shuffle", "4th Gen", "2GB", "Yellow"),
'MD775': ("iPod Shuffle", "4th Gen", "2GB", "Blue"),
'MD776': ("iPod Shuffle", "4th Gen", "2GB", "Green"),
'MD777': ("iPod Shuffle", "4th Gen", "2GB", "Purple"),
'MD778': ("iPod Shuffle", "4th Gen", "2GB", "Silver"),
'MD779': ("iPod Shuffle", "4th Gen", "2GB", "Slate"),
'MD780': ("iPod Shuffle", "4th Gen", "2GB", "Red"),
'ME949': ("iPod Shuffle", "4th Gen", "2GB", "Space Gray"),
'MKM72': ("iPod Shuffle", "4th Gen", "2GB", "Pink"),
'MKM92': ("iPod Shuffle", "4th Gen", "2GB", "Gold"),
'MKME2': ("iPod Shuffle", "4th Gen", "2GB", "Blue"),
'MKMG2': ("iPod Shuffle", "4th Gen", "2GB", "Silver"),
'MKMJ2': ("iPod Shuffle", "4th Gen", "2GB", "Space Gray"),
'MKML2': ("iPod Shuffle", "4th Gen", "2GB", "Red"),
}
# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║ USB Product ID → iPod generation (Apple VID = 0x05AC) ║
# ╚═══════════════════════════════════════════════════════════════════════════╝
USB_PID_TO_MODEL: dict[int, tuple[str, str]] = {
# ── Normal-mode PIDs (0x120x) ──────────────────────────────────────────
0x1201: ("iPod", "3rd Gen"),
0x1202: ("iPod", ""), # 1st/2nd Gen share this PID in USB ID tables
0x1203: ("iPod", "4th Gen"),
0x1204: ("iPod Photo", "4th Gen"),
0x1205: ("iPod Mini", ""), # Mini 1st/2nd Gen share this PID
0x1206: ("iPod", ""), # USB IDs label this only as "iPod '06'"
0x1207: ("iPod", ""), # USB IDs label this only as "iPod '07'"
0x1208: ("iPod", ""), # USB IDs label this only as "iPod '08'"
0x1209: ("iPod Video", ""), # 5th/5.5th Gen share this coarse PID
0x120A: ("iPod Nano", ""), # Original nano-era generic PID
# ── DFU / WTF recovery mode PIDs (0x124x) ─────────────────────────────
0x1240: ("iPod Nano", "2nd Gen (Recovery)"),
0x1241: ("iPod Classic", "1st Gen (Recovery)"),
0x1242: ("iPod Nano", "3rd Gen (Recovery)"),
0x1243: ("iPod Nano", "4th Gen (Recovery)"),
0x1245: ("iPod Classic", "3rd Gen (Recovery)"),
0x1246: ("iPod Nano", "5th Gen (Recovery)"),
0x1255: ("iPod Nano", "4th Gen (Recovery)"),
# ── Normal-mode PIDs (0x126x) ──────────────────────────────────────────
0x1260: ("iPod Nano", "2nd Gen"),
0x1261: ("iPod Classic", ""),
0x1262: ("iPod Nano", "3rd Gen"),
0x1263: ("iPod Nano", "4th Gen"),
0x1265: ("iPod Nano", "5th Gen"),
0x1266: ("iPod Nano", "6th Gen"),
0x1267: ("iPod Nano", "7th Gen"),
# ── iPod Shuffle PIDs ──────────────────────────────────────────────────
0x1300: ("iPod Shuffle", "1st Gen"),
0x1301: ("iPod Shuffle", "2nd Gen"),
0x1302: ("iPod Shuffle", "3rd Gen"),
0x1303: ("iPod Shuffle", "4th Gen"),
}
IPOD_USB_PIDS: frozenset[int] = frozenset(USB_PID_TO_MODEL)
# ╔═══════════════════════════════════════════════════════════════════════════╗
# ║ Serial number last-3-char → model number (from libgpod) ║
# ╚═══════════════════════════════════════════════════════════════════════════╝
SERIAL_LAST3_TO_MODEL: dict[str, str] = {
# ── iPod Classic ────────────────────────────────────────────────────
"Y5N": "MB029", "YMV": "MB147", "YMU": "MB145", "YMX": "MB150",
"2C5": "MB562", "2C7": "MB565",
"9ZS": "MC293", "9ZU": "MC297",
# ── iPod 1G (scroll wheel) ─────────────────────────────────────────
"LG6": "M8541", "NAM": "M8541", "MJ2": "M8541",
"ML1": "M8709", "MME": "M8709",
# ── iPod 2G (touch wheel) ──────────────────────────────────────────
"MMB": "M8737", "MMC": "M8738",
"NGE": "M8740", "NGH": "M8740", "MMF": "M8741",
# ── iPod 3G (dock connector) ───────────────────────────────────────
"NLW": "M8946", "NRH": "M8976", "QQF": "M9460",
"PQ5": "M9244", "PNT": "M9244", "NLY": "M8948", "NM7": "M8948",
"PNU": "M9245",
# ── iPod 4G (click wheel) ──────────────────────────────────────────
"PS9": "M9282", "Q8U": "M9282", "PQ7": "M9268",
# ── iPod U2 (4G click wheel, 20GB) ─────────────────────────────────
"S2X": "M9787",
# ── iPod Photo / Color Display ─────────────────────────────────────
"TDU": "MA079", "TDS": "MA079", "TM2": "MA127",
"SAZ": "M9830", "SB1": "M9830", "SAY": "M9829",
"R5Q": "M9585", "R5R": "M9586", "R5T": "M9586",
# ── iPod Mini 1G ───────────────────────────────────────────────────
"PFW": "M9160", "PRC": "M9160",
"QKL": "M9436", "QKQ": "M9436", "QKK": "M9435", "QKP": "M9435",
"QKJ": "M9434", "QKN": "M9434", "QKM": "M9437", "QKR": "M9437",
# ── iPod Mini 2G ───────────────────────────────────────────────────
"S41": "M9800", "S4C": "M9800", "S43": "M9802", "S45": "M9804", "S4G": "M9804",
"S47": "M9806", "S4J": "M9806", "S42": "M9801", "S44": "M9803",
"S48": "M9807",
# ── Shuffle 1G ─────────────────────────────────────────────────────
"RS9": "M9724", "QGV": "M9724", "TSX": "M9724", "PFV": "M9724",
"R80": "M9724", "RSA": "M9725", "TSY": "M9725", "C60": "M9725",
# ── Shuffle 2G ─────────────────────────────────────────────────────
"VTE": "MA546", "VTF": "MA546",
"XQ5": "MA947", "XQS": "MA947", "XQV": "MA949", "XQX": "MA949",
"YX7": "MB228", "XQY": "MA951", "YX8": "MA951", "XR1": "MA953",
"YXA": "MB233", "YX6": "MB225", "YX9": "MB225",
"8CQ": "MC167", "1ZH": "MB518",
# ── Shuffle 3G ─────────────────────────────────────────────────────
"A1S": "MC306", "A78": "MC323", "ALB": "MC381", "ALD": "MC384",
"ALG": "MC387", "4NZ": "MB867", "891": "MC164",
"A1L": "MC303", "A1U": "MC307", "A7B": "MC328", "A7D": "MC331",
# ── Shuffle 4G ─────────────────────────────────────────────────────
"CMJ": "MC584", "CMK": "MC585", "FDM": "MC749", "FDN": "MC750",
"FDP": "MC751",
# ── Nano 1G ────────────────────────────────────────────────────────
"TUZ": "MA004", "TV0": "MA005", "TUY": "MA099", "TV1": "MA107",
"UYN": "MA350", "UYP": "MA352",
"UNA": "MA350", "UNB": "MA350", "UPR": "MA352", "UPS": "MA352",
"SZB": "MA004", "SZV": "MA004", "SZW": "MA004",
"SZC": "MA005", "SZT": "MA005",
"TJT": "MA099", "TJU": "MA099", "TK2": "MA107", "TK3": "MA107",
# ── Nano 2G ────────────────────────────────────────────────────────
"VQ5": "MA477", "VQ6": "MA477",
"V8T": "MA426", "V8U": "MA426",
"V8W": "MA428", "V8X": "MA428",
"VQH": "MA487", "VQJ": "MA487",
"VQK": "MA489", "VQL": "MA489", "VKL": "MA489",
"WL2": "MA725", "WL3": "MA725",
"X9A": "MA726", "X9B": "MA726",
"VQT": "MA497", "VQU": "MA497",
"YER": "MA899", "YES": "MA899",
# ── Nano 3G ────────────────────────────────────────────────────────
"Y0P": "MA978", "Y0R": "MA980",
"YXR": "MB249", "YXV": "MB257", "YXT": "MB253", "YXX": "MB261",
# ── Nano 4G ────────────────────────────────────────────────────────
"37P": "MB663", "37Q": "MB666", "37H": "MB654", "1P1": "MB480",
"37K": "MB657", "37L": "MB660", "2ME": "MB598",
"3QS": "MB732", "3QT": "MB735", "3QU": "MB739", "3QW": "MB742",
"3QX": "MB745", "3QY": "MB748", "3R0": "MB754", "3QZ": "MB751",
"5B7": "MB903", "5B8": "MB905", "5B9": "MB907", "5BA": "MB909",
"5BB": "MB911", "5BC": "MB913", "5BD": "MB915", "5BE": "MB917",
"5BF": "MB918",
# ── Nano 5G ────────────────────────────────────────────────────────
"71V": "MC027", "71Y": "MC031", "721": "MC034", "726": "MC037",
"72A": "MC040", "72F": "MC046", "72K": "MC049", "72L": "MC050",
"72Q": "MC060", "72R": "MC062",
"72S": "MC064", "72X": "MC066", "734": "MC068", "738": "MC070",
"739": "MC072", "73A": "MC074", "73B": "MC075",
# ── Nano 6G ────────────────────────────────────────────────────────
"CMN": "MC525", "CMP": "MC526",
"DVX": "MC688", "DVY": "MC689", "DW0": "MC690", "DW1": "MC691",
"DW2": "MC692", "DW3": "MC693",
"DW4": "MC694", "DW5": "MC695", "DW6": "MC696", "DW7": "MC697",
"DW8": "MC698", "DW9": "MC699",
# ── Nano 7G ────────────────────────────────────────────────────────
# Source: TheAppleWiki Models/iPod (serial suffix table). Entries there
# are 4-char suffixes (e.g. F0GN); this map stores last-3 to match our
# lookup_by_serial(serial[-3:]) convention.
"0GD": "MD475", "0GM": "MD475", # pink
"0GF": "MD476", "0GN": "MD476", # yellow
"0GG": "MD477", "0GP": "MD477", # blue
"0GH": "MD478", "0GQ": "MD478", # green
"0GJ": "MD479", "0GR": "MD479", # purple
"0GK": "MD480", "0GT": "MD480", # silver
"0GL": "MD481", "0GV": "MD481", # slate
"4LN": "MD744", "4LP": "MD744", # product red
"JQ1": "ME971", # space gray (2013)
"K60": "MKMV2", # pink (2015)
"K61": "MKMX2", # gold (2015)
"K62": "MKN02", # blue (2015)
"K63": "MKN22", # silver (2015)
"K64": "MKN52", # space gray (2015)
"K65": "MKN72", # product red (2015)
# ── Video 5G ───────────────────────────────────────────────────────
"SZ9": "MA002", "WEC": "MA002", "WED": "MA002", "WEG": "MA002",
"WEH": "MA002", "WEL": "MA002",
"TXK": "MA146", "TXM": "MA146", "WEF": "MA146",
"WEJ": "MA146", "WEK": "MA146",
"SZA": "MA003", "SZU": "MA003", "TXL": "MA147", "TXN": "MA147",
"V9V": "MA452", # iPod Video U2 Special Edition 5G 30GB (Black)
# ── Video 5.5G ─────────────────────────────────────────────────────
"V9K": "MA444", "V9L": "MA444", "WU9": "MA444",
"VQM": "MA446", "V9M": "MA446", "V9N": "MA446", "WEE": "MA446",
"V9P": "MA448", "V9Q": "MA448",
"V9R": "MA450", "V9S": "MA450", "V95": "MA450",
"V96": "MA450", "WUC": "MA450",
"W9G": "MA664",
}
Reference in New Issue View Git Blame Copy Permalink