Repository navigation
RockWheel 1.4
Firmware for the iPod Video (5G / 5.5G), based on Rockbox. Details of each feature are in the README; what changes for an existing install is in Updating to 1.4.
Timings are from the test iPod: 5.5G, 32 MB RAM, iFlash, ~13,000 songs.
Highlights
- Podcasts and Audiobooks screens, with playback speed and chapters
- Three themes: Classic, Modern, Neo (13 colors), each light or dark
- Shuffle: Off / Songs / Albums
- Album lists with covers, album screen with track numbers, Songs sort options, Recently Added
- Sharp cover beside the main menu, optional Moving Cover
- Performance: Resume Playback starts instantly, full library rebuilds 34 s shorter, lighter syncs
- Plays and ratings now reach Finder with podcasts on the iPod
- Reliability fixes for disk, USB and settings
Before you update
- Use the installer again (
install.sh/install.ps1). Settings, play counts, ratings and resume places are kept. - Download ~63 MB, ~145 MB on the iPod (1.3.1: ~37 MB), almost all of it fonts (support for 40+ languages). Needs ~180 MB free; the installer checks before copying anything.
- First start rebuilds the library once (new format, Music-style sorting). Play counts, ratings, last played dates and audiobook/podcast places are kept.
- Nearly full iPod: "Not Enough Space" on first start, and the library may be empty or incomplete until you free space. Nothing is lost; the update finishes by itself at the next start.
- Update the games too: 1.3.1 games don't run on 1.4. The installers do this.
- The iPod starts in the Classic theme, light or dark as before.
- Going back to 1.3.1? Sync first: 1.3.1 rebuilds its library and loses plays of songs copied outside Finder.
New
Shuffle
- Shuffle is now Off / Songs / Albums, as on a stock iPod
- In Settings and in Now Playing's hold menu; Select on the row cycles the three
- Shuffle Albums: whole albums, each in disc and track order, the next album picked at random
- Works on whatever you play: all songs, an artist, a playlist
- The song you pick plays first, then the rest of its album
- Own status bar icon
- Shuffle Albums can be added to the main menu (Settings > Main Menu): all your music, an album at a time
- Resume Playback restores the same shuffled order, also after a sync
- A show's episodes and a book's parts always play in order
- Starting a song from Songs with Shuffle on Albums: 0.70 s on 13,188 songs
Podcasts
- Music > Podcasts: each show with its cover and what's waiting
- "2 new · 9 Nov" (new episodes and the newest one's date)
- "6 new · 13 min left" (with an episode you started)
- Time left alone, or the episode count, when nothing is new
- Show screen: header with cover, name, author and episode count
- Episodes newest first: "20 May 2023 · 22 min", or "28 min left" once started
- Dot for unplayed, half dot for started
- Synced episodes take your computer's marks until you play them on the iPod
- When an episode ends, the next unplayed one below it plays
- Played episodes are skipped; playback stops after the last unplayed one
- With Repeat on, nothing is skipped
- Play Next, Play Last and On-The-Go play exactly what you queued
- Hold Select on an episode: Start from Beginning, Mark as Played, Mark as Unplayed (synced episodes)
- Now Playing: show, episode date, time left; Select from the large cover shows the episode notes
- Scrubber: Previous −15 s, Next +30 s, with small signs under the bar; the wheel moves in 5 s steps
- Podcasts copied by hand: detected by genre Podcast or a Podcasts folder; they keep their place, use the podcast speed and stay out of shuffles
Audiobooks
- Music > Audiobooks: each book with cover, author and "6 h 12 min left", "Finished" or its length; started books first
- Book screen: "8 parts · 9 h 5 min", then Resume (with the part it continues from) or Listen Again, then the parts with their start times
- One place per book: starting another part moves the book's place there
- Hold Select on a part: Start Over, Mark as Finished (both confirmed)
- Now Playing: author, and the chapter name or the book title
- Books copied by hand:
.m4b, genre Audiobook(s) or an Audiobooks folder - Times over an hour read "1 h 33 min" in lists and Now Playing
Speed
- Settings > Playback > Podcast Speed: Normal, 1.25×, 1.5×, 1.75×, 2×
- Audiobook Speed: the same plus 0.75×
- Pitch preserved; music always plays at normal speed
- Speed view in Now Playing: Select past the scrubber, choose with the wheel, applied when you leave the view
- A speed other than Normal shows in Now Playing where the stars are
Chapters
- Episodes, audiobooks and songs of 10+ minutes play by the chapters in the file
- Next: next chapter, or the next track after the last chapter
- Previous: start of the chapter, or the previous chapter within its first 3 s
- Holding Previous / Next still rewinds and fast-forwards
- Chapter name under the progress bar ("Chapter 2 · Objects and stories"); books also show "Chapter 5 of 12"
- Hold Select > Chapters: list with start times, opened at the current one
- Skipping through a long song by chapters doesn't count it as played
- Read from MP3 (ID3v2 chapter frames) and MP4/M4B (Nero chapters, QuickTime chapter tracks)
Music lists
- Sorted as in Music on a Mac and on a stock iPod
- "The", "A", "An" ignored; accented letters with their base letter; numbers by value
- Sort fields from Music or the file's tags are followed
- Artists lists album artists: an album stays whole, guests on one song get no row (Settings > Music Menu > Group by Album Artist)
- Artist with 2+ albums: All Songs on top, with Sort By: Album (songs under a bar per album, "2009 · The Fame") or Name
- Album screen: cover, name, album artist and "2019 · 16 songs" in a header; track numbers and lengths; Disc 1, Disc 2 for multi-disc albums
- The header scrolls away with the list and comes back at the top
- Albums: two-line rows with cover, year and album artist
- Same-named albums by different artists are separate rows
- Same-year albums in release-date order
- Settings > Appearance > Artist under Album, Covers in Lists
- Songs: Sort By Name, Artist, Album or Year
- With covers, a second line: artist, "Album · Artist" or "1979 · Artist"
- Opens in 0.36 s with 13,163 songs in any order but Name
- Music > Recently Added: the last 50 albums, newest first (can be hidden in Settings > Music Menu)
- Scrollbar on long lists (Settings > Appearance > Scrollbar)
- Large letter when you spin the wheel fast in lists of 100+ rows (the year in Albums by year)
- While it shows, each wheel step jumps a letter; it stays while your thumb rests on the wheel
- Settings > Appearance > Jump by Letter turns the jumping off
- Hold Select on any song: Go to Artist, Go to Album; on an album row or in Cover Flow: Go to Artist
- Empty lists say so: "No Podcasts", "No Composers"
- Untagged songs under Unknown Artist / Album / Genre, last in their lists, in every language
- Protected purchases show "This item is protected and can't be played"
Cover Flow
- Ordered by album artist, each artist's albums by release date; the year after the artist: "LINKIN PARK · 2000"
- Hold Select > Sort By: Artist or Year
- Hold Previous / Next to run to the first / last album; a press still moves one
- Go to Artist in the hold menu
Now Playing
- Hold menu: Playing From (opens the list the music came from, at the current song), Up Next, Chapters
- Slides in from playlists and Search too
- After a restart, the playing list shows the speaker beside the current song again
Main menu
- Sharp cover beside the menu
- Synced music: Finder's 240 px cover, shown at once
- Other music: drawn from the song's file a few seconds into the track (2.5–3.9 s for ordinary covers); the last 48 are kept
- At first start, 1.4 adds the 240 px format to the iPod's description file (
SysInfoExtended); the original is kept asSysInfoExtended.original. Music synced from then on gets the sharp covers - Settings > Rebuild Synced Covers, for music synced before
- Shows the space needed and free, and asks first; stops the music
- Synced songs show no covers until the next sync, when Finder makes every cover again (~3.3 GB and ~12 min for 13,000 songs)
- Old covers are removed after the sync; choosing it again before syncing puts the old covers back
- Resume Playback starts instantly, without "Loading…"
- With nothing playing, its song's cover shows beside the menu, also after a restart or a sync
- Settings > Appearance > Moving Cover (off by default): the cover pans slowly while music plays or is paused; uses more battery
Themes
- Settings > Appearance > Theme: Classic, Modern, Neo, each light or dark
- Each has its own lists, main menu, Now Playing, USB screen, icons and fonts
- Changing the theme stops the music; Resume Playback picks it up
- Classic: the RockWheel look you know
- Modern: white or black with one accent color
- Selected row as a full-width accent bar; accent section names and artist; chevrons on rows that lead on
- Clock in the status bar; six rows of Search results
- No Cover Colors, no Angled Cover
- Neo: flat, rounded selection, always in your color
- Settings > Appearance > Color: 13 colors, each with a swatch
- Small text, hints, section names, scrollbar, progress bar and knob in your color
- Clock in the main menu; centered Now Playing with a two-line title
- Cover Colors acts on Now Playing (Off, Text and Stars, Whole Screen, Fill); a near-gray cover keeps your color
- Modern and Neo end long names with "…"
Photos
- Each photo album has its own collage, shown beside the list
- Play pauses and resumes the music in Photos
- Opening Photos no longer interrupts music
Sync
- Plays and ratings reach Finder with podcasts synced (macOS 26 drops them otherwise, even on stock firmware)
- Plays Finder doesn't take are kept and sent again at the next connection; connecting without syncing no longer offers them twice
- Songs Finder stores again under a new name keep last played date, resume place, date added and release date
- Release dates and dates added from Music (synced) or the file's tags (copied); release date in Track Info
Bug reports
.rockbox/health.log: unfinished imports, disk errors, USB errors, free space at each connection- Written at USB connect or power-off; no song names, paths or device IDs
- Attach it to bug reports
- "Not Enough Space": shown at each start and connection while the library can't be updated; continues on a button press
Performance
- Resume Playback starts instantly: its queue (13,188 songs) is read during startup, 0.33 s, instead of after you press it with "Loading…"
- Full library rebuild 34 s shorter: fonts for every alphabet ship ready instead of being built on the iPod
- Syncs that only change plays, ratings or playlists ~1 s shorter: covers and Cover Flow albums are no longer rebuilt
- Library updates on a full disk no longer reread the whole file table on every write
- Albums (1,698 albums) opens in 0.08 s, Artists in 0.011 s, Genres in 0.006 s, Audiobooks in 0.12 s
- Songs by Artist, Album or Year opens in 0.36 s (by Name 0.20 s): the orders are prepared during Updating Library
- Shuffle Albums: 0.70 s from Select to music on 13,188 songs, 0.40 s of it for the shuffle
- Sharp main-menu cover from the song's file in 2.5–3.9 s for ordinary covers, without the music running dry
- Flash iPods with the screen dark: the card no longer powers off mid-transfer, so Mac reads don't stall for 0.5 s+ each
- Firmware ~125 KB smaller than 1.3.1's despite the new features (a compact text composer replaces utf8proc)
Changed
- Music lists and Cover Flow hold music only; podcasts and audiobooks are in their own sections, and the song count leaves them out
- Search finds shows and books under Albums and opens their own screen
- Shuffle Songs in the main menu now also sets Shuffle to Songs, so later playback stays shuffled
- Shuffle Songs row removed from the top of playlists and On-The-Go: playlists follow the Shuffle setting
- Classic: Now Playing, Cover Flow captions and album headers bold for everyone; years, numbers, lengths and hints lighter
- Classic: time in the main menu title; the iPod's name shows beside the menu on Settings
- Classic: empty rating stars drawn as outlines
- Search keeps its section name (Artists, Albums, Songs) on screen while scrolling
- "Preparing Photos" only when photos changed
- All alphabets built into the theme fonts: no font building during Updating Library
- Current Playlist → Up Next (always shown); Crossfeed → Headphone Crossfeed
- Audiobook speeds Slower / Normal / Faster → 0.75× / Normal / 1.25×, plus 1.5×, 1.75×, 2×
- Hints for Shuffle, Crossfade, Podcast Speed and Audiobook Speed
- Now Playing times centered; shorter bar for 1 h+ tracks so "-2:43:21" fits
- Settings saved within ~2 s on flash
- Language files from another version are ignored: English shows instead of wrong text
- Translations: Ukrainian "Альбоми", Songs and Albums in Hindi and Thai, Dutch "Shuffle"; Recently Added in 23 more languages
Fixed
- Plays and ratings lost on the iPod when Finder ignored them (podcasts on macOS 26)
- Stopping a track in its last seconds counted it as played: short songs gained a play, podcasts and audiobooks lost their place
- Audiobook position on the Mac reset to the start after a sync
- Wrong seek and resume in M4A/M4B files over ~27 hours
- Interrupted settings save could reset the iPod to English and defaults; the last good settings are now kept
- Freeze or power cut during writes could leave two files sharing space or one file under two names
- Deleting or rewriting a damaged file could free other files' space
- Flash card switched off while the computer was reading it with the screen dark; each read waited 0.5 s+
- Possible freeze while connected to a computer if the USB controller never took a transfer (fix from Rockbox, ported from PodBox)
- Empty progress bar in "Checking Songs" for copied music
- iPod not appearing on the computer while checking songs or updating the library
- Missing or extra click on the first press after auto-return to Now Playing
- Library update on a full disk rereading the whole file table on every write and restarting at each start
- Stuck USB screen or no charging after unplugging at certain moments
- Wake alarm lost if the iPod restarted before it went off
- Null-pointer crash froze silently; now shows the panic screen
- Retried and failed writes during Updating Library on some flash drives behind bridge adapters (based on one user's log, not yet confirmed by them)
- Go to Artist opening another artist for albums with the same name
- Go to Album, Go to Artist and Playing From opening their list twice
- Cover remnants in the status bar after leaving a full-width list
- Cover Flow menu hiding the current Sort By value in Russian, German and 10 more languages
- Hebrew and Arabic: sound-wave bars on the wrong side, scrolling title erasing the track number
- Quick Scroll stopping early in libraries with many Chinese names
- Track Info showing the title as grouping
- Invisible formatting characters drawn as boxes
Removed
- Bold Text setting; custom Now Playing skins copied from 1.3.1 no longer load (the built-in one shows instead)
- Shuffle Songs row in playlists and On-The-Go
- iOS-style Status Bar, Rating and Progress Bar (try the Modern theme)
Known issues
- Sharp synced covers, the description-file change and Rebuild Synced Covers are tested with Finder on macOS 26 only, not iTunes for Windows or iOpenPod
- Rebuild Synced Covers needs room for two cover sets until the sync (~250 KB per song); the sharp covers alone take ~150 KB per song
- Cover drawn from the sideloaded file is slower for large pictures (600 px FLAC: 3.2 s; ALAC: 13.2 s); untested on hard drives
- Non-square covers fall back to the file's picture
- Podcast progress (place, plays, played mark) stays on the iPod. Needs further development.
- Resume Playback shows "Loading…" once after a setting change, Cover Flow, Photos, a game or a file change
- Chapters: max 255 per track; jumps may land a few seconds early in long AAC books
- Downgrading to 1.3.1: plays of copied songs are lost, new speeds read as Normal
- Libraries above ~25,000 songs untested on an iPod