Linnet is firmware for iPod Photo / Color, iPod Video, iPod classic, and fourth-generation monochrome iPods. The project includes a bootloader, kernel, on-device interface, Windows Media Manager, USB development tools, and a UI simulator.
- Share music with Apple software. Prepare compatible iTunes-synced music
for Linnet, and add supported MP3s from
/Musicto the Apple library. See sharing requirements. - Preparation on your computer. Media Manager builds library indexes, artwork, photos, and video conversions for the iPod's display and playback formats, so the device can use prepared data.
- Video on iPod Photo. Convert videos on your computer and play them with sound on the Photo / Color's display.
- Desktop media and menu controls. Manage playlists, select games, and configure the iPod's Home, Music, Settings, and Extras menus in Media Manager.
- Click-wheel menus and themes. Browse media through click-wheel menus with configurable shortcuts and selectable themes.
- Linnet Link. Developer firmware provides two-way USB communication for live diagnostics, remote input, screenshots, and loading test firmware into RAM.
- Native UI authoring. Create screens in TSX, compile them into native firmware, and preview them with the desktop simulator.
- Startup selection. Choose Linnet, preserved Apple software, or a compatible installed Rockbox image from the startup menu.
linnet-os-demo.mp4
Watch the demo on YouTube · Watch the tutorial playlist.
- Confirmed hardware
- Get started
- Video tutorials
- Music playback
- Linnet Media
- Linnet Link
- Games
- Themes
- Simulator
- Develop on Windows
- Explore the project
- License
- Credits
| iPod family | Firmware ZIP prefix | Features |
|---|---|---|
| Photo / Color | linnet-photo4g |
Music, photos, prepared IPVF video, Cover Flow, games |
| Video | linnet-video5g |
Music, photos, H.264/MPEG-4 video, Cover Flow, games |
| Classic 6G, 6.5G and 7G | linnet-classic6g-7g |
Music, photos, native MP4 video, Cover Flow, games |
| Fourth-generation monochrome | linnet-ipod4g |
Music and a monochrome interface |
The hardware guide lists tested models, storage configurations, target IDs, and feature limits. Classic requires PATA storage; CE-ATA is not supported. See storage compatibility for disk and filesystem requirements.
- Download LinnetSetup.exe and the firmware ZIP for your iPod from
Releases, or use the files
from a local build.
Choose
-user.zipfor regular use or-dev.zipfor diagnostics and Linnet Link. - Run the installer and open Linnet from the Start menu. The optional
linnet-media-windows.zipruns without installation after extraction. - Connect the iPod with USB and choose Find or switch iPod. If necessary, use the Apple Disk Mode instructions on the iPod setup screen.
- In iPod setup, choose Choose ZIP… and select the firmware ZIP without extracting it. Media Manager reads its model and build type automatically. Choose Install firmware and follow the prompts. Initial Classic setup includes instructions for entering DFU mode; Media Manager handles the subsequent bootloader and OS installation.
- A fresh Classic finishes in Linnet Disk Mode: open Preparation to add media, then Eject safely to start Linnet. For other installation routes, eject safely to start Linnet, then enter Settings → USB Disk Mode on the iPod and reconnect before preparing media.
The Windows installer supports Windows 10 and later with x64 application support. The app includes its runtime and media preparation dependencies. Prebuilt User and Developer firmware ZIPs work without a compiler, Python installation, or WSL.
Firmware installation checks the connected device, preserves existing media and Apple firmware, and saves recovery backups. Device writes require Windows administrator approval. See the installation guide for requirements and recovery instructions.
Hold MENU during startup to open Linnet's boot selection menu. Select Linnet, Apple iPod software, or a compatible installed Rockbox image from the available entries.
To change the default, open iPod setup → Startup in Media Manager, choose a system under Start automatically, and select Save.
In Media Manager, open Music, Photos, Videos, or Notes and add files or folders. Choose Preparation → Prepare selected media, then Eject safely and restart Linnet.
In Media Manager, open iPod setup, find Remove Linnet, and choose Remove…. Removal restores the saved previous startup software and removes Linnet's system files, settings, and prepared libraries. Original Music, Photos, Videos, and Notes folders are kept. Follow the removal instructions for recovery requirements and the Classic's additional steps.
Watch the Linnet tutorial playlist on YouTube. The videos include chapters so you can jump to the step you need.
- Install Linnet on iPod Video (5th generation)
- Install Linnet on iPod Classic (6th and 7th generations)
- Install Linnet on iPod Photo / Color
- Device not recognized and hardware reports
- Developer builds and Linnet Link
- Complete Media Manager walkthrough
- Complete iPod guide: every menu, setting and navigation path
Now Playing shows album artwork and track information. Browse albums with Cover Flow, or open playback options for shuffle, repeat, sound, and the sleep timer.
![]() Now Playing |
![]() Cover Flow |
![]() Playback options |
Select an image to view it at full size.
Media Manager is the Windows desktop app for firmware installation and media preparation. It provides:
- Song, album, artist, and genre views, with library and artwork preparation.
- Photo and video conversion for the selected device, with progress reporting and reusable computer caches.
- Game installation and removal, and on-device menu configuration.
- Firmware installation, startup selection, updates, removal, and recovery.
Media Manager's iPod setup screen with example device information and a User firmware ZIP selected. See the Media Manager guide.
Linnet Link is the USB interface for development and trace builds. It supports button and wheel input, framebuffer capture, diagnostics, temporary RAM boot, and persistent OS updates. User OS builds exclude this development interface.
Link operates while Linnet is running. Media library transfers use Disk Mode; firmware replacement stops playback and follows the update procedure. Temporary RAM boot does not replace the installed OS.
See the Link guide for commands, image requirements, readiness checks, and update behavior.
Photo, Video, and Classic support 18 native games: Comet Run, Pulse Path, Solitaire, Sudoku, Brick, Music Quiz, Vortex, Minesweeper, Falling Blocks, Reversi, Snake, Word Search, Scrub, Dial Heist, Mixtape, Signal, Clockwork City, and Pocket Pinball.
Games are separate target-specific native packages. Choose games in Media Manager, save, eject, and restart Linnet. See game authoring for the package format, templates, controls, and preview tools.
![]() Comet Run |
![]() Pulse Path |
![]() Solitaire |
Native game previews using the iPod Video's 320 × 240 layout.
Supported color targets provide selectable themes and an Album Colors option that uses colors from the current album's artwork. Theme layouts, palettes, and included fonts are compiled into firmware. The monochrome target uses its own interface.
Licensed fallback fonts are included. For Apple Podium Sans on supported color themes, open Media Manager → Settings → iPod appearance → Choose font → Download and use Apple font. The app downloads verified firmware from Apple and extracts the font on the computer. Eject safely and restart Linnet to apply it. See font setup for details.
The same track on iPod Video in six themes:
![]() Linnet |
![]() Midnight |
![]() Album Colors |
![]() Classic Split |
![]() Minimal Dark |
![]() Minimal Light |
All 15 theme previews
![]() Linnet |
![]() Midnight |
![]() Graphite |
![]() Aurora |
![]() Sunset |
![]() Blueprint |
![]() Album Colors |
![]() Classic Split |
![]() Minimal Dark |
![]() Minimal Light |
![]() iPod Photo |
![]() iPod Classic |
![]() Classic Cobalt |
![]() Classic Ember |
![]() iPod Mono |
Native simulator captures of all 15 selectable themes. Each preview uses a supported iPod layout; theme availability and layout vary by model. Select an image to view its native size. See the UI SDK for screen and theme definitions.
The desktop simulator uses the firmware's native renderer and compiled UI definitions. It renders screens to PNG, replays wheel and button events from input tapes, and generates a browser report. Hardware timing, sound, USB, and physical display behavior require testing on an iPod.
![]() Home screen |
![]() Music menu |
These previews use sample screens without personal library data. Simulator commands are included below.
Install Git for Windows and Python 3.14 x64, then run:
git clone https://github.com/jspann21/linnet.git
cd linnet
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r tools/studio/requirements.txt
.\.venv\Scripts\python.exe linnet setup
.\.venv\Scripts\python.exe linnet doctorSetup downloads and verifies the pinned LLVM 23.1.2 Windows compiler and builds the native Apple database helpers. Media Manager, firmware builds, and the simulator run on Windows without WSL.
.\.venv\Scripts\python.exe linnet build --target photo4g-p98 --profile release --verifyUse the target ID from the hardware guide for other models.
Build artifacts are written to a unique
out/<profile>/<target>/<kind>/runs/ directory. The command reports their paths;
building an image does not install it.
Linnet's bootloader, kernel, services, and UI use native code and fixed memory budgets. Host tools prepare media indexes, fonts, and artwork. Static TSX UI definitions are compiled to C; the device has no JavaScript runtime. See architecture and the UI SDK.
.\.venv\Scripts\python.exe linnet mediaFor media conversion when running from source, install a Windows FFmpeg build
containing both ffmpeg.exe and ffprobe.exe. Put them on PATH or choose
their folder under Settings → Advanced preparation → FFmpeg (source builds).
See audio and video preparation.
To compile during installation, open iPod setup → Build from source (advanced), enable Compile firmware on this computer, and choose User or Developer firmware. Developer firmware is bound to the detected iPod. Source compilation requires the configured compiler; selecting a prebuilt ZIP uses that ZIP's recorded build type.
.\.venv\Scripts\python.exe linnet simulator --target photo4g-p98 --all-scenes --output out/simulator
Start-Process out/simulator/index.htmlUse the target's system.toml to select apps and the default theme. The SDK
contains screen templates and input-tape examples.
Development and trace images require the device serial:
.\.venv\Scripts\python.exe linnet build --target photo4g-p98 --profile dev --device-serial YOUR_SERIAL --verifyReplace YOUR_SERIAL with the detected device's serial and use its target ID.
See the Link guide for discovery, input, screenshots,
RAM boot, and persistent updates.
.\.venv\Scripts\python.exe -m pip install -r tools/studio/requirements-build.txt
.\.venv\Scripts\python.exe linnet release bundle --target photo4g-p98 --build user --output out/releases/linnet-photo4g-user.zip
.\.venv\Scripts\python.exe linnet release bundle --target photo4g-p98 --build dev --output out/releases/linnet-photo4g-dev.zip
.\.venv\Scripts\python.exe linnet release media --output out/releases/linnet-media-windows.zip --installer-output out/releases/LinnetSetup.exeRepeat the bundle commands for the other targets. Packaging verifies the firmware images and includes the User or Developer OS, both bootloader variants, and prepared game packages where supported. Classic packages also include the initial bootloader bootstrap.
Windows app packages include the runtime, media preparation tools, and native
Apple database helpers. FFmpeg and Apple helper sources and licenses accompany
those components; linnet-source.zip provides the matching project source.
Packaging prepares the pinned Inno Setup compiler under out/toolchains/.
Output files must not already exist.
The GitHub workflow builds eight firmware ZIPs
and the Windows app on version-tag pushes (v*), pull requests, and manual
runs. Tag builds also create a draft release with downloads, source, and checksums.
See builds and releases for the naming and publishing steps.
For an existing compiler installation, set LINNET_LLVM_BIN to its bin
directory. doctor checks the pinned version. Linux firmware development
requires LLVM 23.1.2 on PATH; the desktop app is Windows-only. See
bootstrap tooling for target-specific build and
installation details.
The documentation index lists user guides and developer references.
| Topic | Documentation |
|---|---|
| Media preparation, firmware installation, and removal | Media Manager · Storage compatibility |
| Screens, apps, and themes | UI SDK · UI compiler |
| Native game packages | Game authoring |
| USB development interface | Linnet Link |
| Firmware structure and file formats | Architecture · Binary formats |
| Media formats | Music · Photos · Video |
| Device compatibility and porting | Hardware support · Porting guide |
| Contributions and planned work | Contributing · Roadmap |
| Build outputs and recovery records | Local artifacts |
Copyright (C) 2026 jspann21 and Linnet contributors.
Unless otherwise stated, Linnet's original code, documentation, and assets are licensed under the GNU General Public License, version 3 or (at your option) any later version (GPL-3.0-or-later). You may use, modify, and redistribute them under those terms. Linnet comes without any warranty; see the license for details.
Installation and use are at your own risk. To the extent permitted by law, the copyright holders and contributors are not liable for device damage, unusable devices, data loss, or repair and recovery costs. See the warranty and liability notice.
Third-party code, fonts, and artwork retain their own licenses and copyright notices. The project license does not grant rights to Apple-derived assets; see the font and theme notes and the Podium Sans notice.
The firmware incorporates third-party codecs, libraries, and adapted algorithms, including components sourced through Rockbox. Their licenses and origins are recorded in third-party provenance, the SDK's font and theme notes, and the game artwork credits.




























