rPod

A terminal-native manager for Rockbox iPod Classic on Linux.

██████╗ ██████╗  ██████╗ ██████╗
██╔══██╗██╔══██╗██╔═══██╗██╔══██╗
██████╔╝██████╔╝██║   ██║██║  ██║
██╔══██╗██╔═══╝ ██║   ██║██║  ██║
██║  ██║██║     ╚██████╔╝██████╔╝
╚═╝  ╚═╝╚═╝      ╚═════╝ ╚═════╝

Interactive TUI with arrow-key navigation, live storage bar, and color-coded status. Mount, sync, clean, rip YouTube audio, manage themes — all from one menu.

⚠ This is a prototype. The clean and sync commands perform bulk file operations directly on the iPod's FAT32 filesystem without proper sync barriers between writes. FAT32 has no journaling — interrupted or batched writes can corrupt the partition table. This has already bricked one filesystem during development.

Safe to use: connect, disconnect, explore, backup Use at your own risk: clean, sync, yoink

Next version will stage all file grooming locally and only push finished files to the iPod in batched, synced copies. Building in public.

How it looks

The menu shows live iPod status and storage at a glance:

Status: ● Connected & Mounted
Storage:  ████████████░░░░░░░░░░░░░░░░░░ 38%
          18G of 48G used / 30G free

──────────────────────────────────────────────
Menu:
  1. Connect - Mount iPod
  2. Disconnect - Safely unmount
  3. Explore - Open in file manager
  4. Yoink - Rip YouTube audio to iPod
  5. Sync - Rebuild playlists & sync themes
  6. Setup - Clean, backup, themes & flash

↑/↓ navigate · Enter select · number to jump · Esc quit

The clean command scans and reports what it'll do before touching anything:

Leading spaces
    ▸ Artists/ The Doors/ → The Doors/

FSCK recovery files
    ✕ 3 FSCK*.REC files

Radiohead (2 albums, 14 files)
    Radiohead - OK Computer/ → OK Computer/ (12 files)
    Radiohead - Kid A/ → Kid A/ (2 files)
    ✕ cover.jpg
    ✕ album.nfo

────────────────────────────────────────────
Apply changes? [y/N]

Commands

rpod              # interactive TUI menu
rpod connect      # mount iPod
rpod disconnect   # safely unmount
rpod yoink <url>  # rip YouTube audio
rpod clean        # strip prefixes & junk
rpod sync         # rebuild playlists
rpod help         # all commands

Requirements

• Linux (udisksctl, lsblk, fsck.vfat)
• Rockbox iPod Classic (6th/7th gen)
• yt-dlp for Yoink
• rsync for Backup
• bash 4+

Install

git clone https://github.com/remigius-labs/rpod.git
ln -s "$(pwd)/rpod/rpod" ~/.local/bin/rpod

License

MIT