pip
Installs iOpenPod into your current Python environment.
Upgrade with python -m pip install --upgrade iopenpod.
Free and open source for Windows, macOS, and Linux
Browse albums and tracks, play music, edit metadata, and sync your whole library—from FLAC and artwork to video, photos, podcasts, and audiobooks.
Add FLAC and other unsupported audio. iOpenPod converts it automatically with FFmpeg, caches the result, and syncs an iPod-ready copy—no separate conversion step.
iOpenPod prepares unsupported video and photos for the formats and sizes your iPod expects. No separate HandBrake workflow or manual resizing.
See additions, removals, artwork, metadata, and storage impact before syncing. Automatic device snapshots give you a way back.
Subscribe, choose how many recent episodes to keep, track listened status, and add episodes to an iPod.
ListenBrainz and Last.FM scrobbling can submit play history during sync.
Manage standard playlists or build smart playlists with rule filters, live updating, limits, and sort order.
Read play counts, ratings, and skip counts from the iPod and sync them back to PC library metadata where supported.
Copy files directly to the iPod without using the full PC-folder sync workflow.
Change cover art, inspect iPod artwork records, and write device-specific thumbnail formats.
Supports music, audiobooks, podcasts, videos, and photos.
Tune encoders, bitrate, lossless conversion, sample rate, and spoken-word output.
Browse snapshots by device and restore only when the connected iPod matches.
| Device | Status | Notes |
|---|---|---|
| iPod "Classic" (all generations 1st-7th) | Supported | |
| iPod Mini (all generations 1st and 2nd) | Supported | |
| iPod Nano (all generations 1st-7th) | Supported | |
| iPod Shuffle | Planned | Shuffle uses a different database structure. ETA ~4 mo. |
| iPod Touch | Not planned | Touch requires non-file-system device protocols. |
iOpenPod is available as a Python package through pip, pipx, and uv tool. After installing, launch it with
iopenpod.
pipInstalls iOpenPod into your current Python environment.
Upgrade with python -m pip install --upgrade iopenpod.
pipxCreates an isolated app environment and exposes the iopenpod command.
Upgrade with pipx upgrade iopenpod.
uv toolIf you already use uv, this gives you the same isolated app-style install.
Upgrade with uv tool upgrade iopenpod.
Native builds do not require a separate Python installation.
| Platform | File | Instructions |
|---|---|---|
| Windows | iOpenPod-Windows.zip | Extract the archive and run iOpenPod.exe. |
| macOS | iOpenPod-macOS.zip | Extract the archive and run iOpenPod.app. You may need to allow the app in System Settings. |
| Linux (recommended) | iOpenPod-Linux-x86_64.AppImage | Run chmod a+x ./iOpenPod-Linux-x86_64.AppImage, then launch the AppImage. |
| Linux (Arch-based) | iopenpod (AUR) | Install from the AUR. |
| Linux (tarball) | iOpenPod-Linux.tar.gz | Extract the archive and run ./iOpenPod. |
| Linux (Flatpak) | iOpenPod-Linux.flatpak | If present on the release, install with Flatpak. |
For step-by-step platform setup and troubleshooting, see the Install Help page.
Python package installs require Python 3.11+. If iopenpod is not on your PATH yet, run pipx ensurepath for pipx or uv tool update-shell for uv tool.
Installs should be updated with the same tool used to install them.
Required tools: install FFmpeg with ffprobe for transcoding and media probing, and Chromaprint for acoustic fingerprinting during sync.
Linux users who see a Qt xcb platform plugin error should install the XCB runtime packages listed on the Install Help page.
uv sync installs dependencies into a local virtual environment. FFmpeg with ffprobe and Chromaprint are needed for full sync functionality.
Install iOpenPod from PyPI with pip, pipx, or uv tool, or download a native release build. Launch it, connect your iPod as a mounted drive, choose PC media folders, review the proposed changes, and apply the sync plan.
PyPI installs require Python 3.11 or newer. Native builds do not require a separate Python installation.
Yes. iOpenPod can convert unsupported audio and video formats to iPod-compatible output during sync. FFmpeg with ffprobe is required for transcoding and media probing.
Yes. iOpenPod supports Windows, macOS, and Linux. PyPI installs are recommended while native packaging is still being hardened.
No. iOpenPod shows you exactly what will change before writing anything, and backs up your database before every sync. Roll back with one click.
Yes. Drag and drop files into iOpenPod and they'll be added to your iPod directly — no sync configuration required.
No. iOpenPod reads the existing iTunesDB on your iPod and shows you everything already on it. You can browse, edit, and add tracks without touching what's already there. A sync will only change what you explicitly approve in the review step.
Make sure the iPod is mounted as a drive and visible in File Explorer, Finder, or your Linux file manager. If it still is not working, open an issue with your iPod model, OS, and iopenpod.log.
To find the log in iOpenPod, open Settings > Storage, then click Open next to Log Location.
Open Settings > Storage, then click Open next to Log Location. Attach iopenpod.log when reporting a bug.
Yes for full sync functionality. FFmpeg with ffprobe is required for transcoding and media probing, and Chromaprint is required for acoustic fingerprinting during sync.
iOpenPod takes a full snapshot of your iPod's database before every sync begins. If anything goes wrong, open the Backups panel and restore the previous snapshot with one click — your iPod goes back to exactly how it was.
Only when you explicitly trigger it: checking for updates, scrobbling to ListenBrainz, or searching for podcasts. Nothing is sent in the background. There's no telemetry.
Yes, with a caveat. The fingerprint-to-database mapping is stored in a file on the iPod itself, so the iPod carries its own identity. Each PC will re-fingerprint its local library on first sync, then match against what's already on the device.
Not currently. iPod Touch uses non-file-system device protocols rather than the iTunesDB-style storage used by classic iPods.
Meet other iPod owners, suggest features, share feedback, and get help when something isn’t working.
Join us on Discord