Skip to content

RockWheel 1.3

Choose a tag to compare

@ssarkisy ssarkisy released this 08 Nov 04:02
· 229 commits to main since this release
7c4e83e

Figures below were measured on the test iPod: a 5.5G with 32 MB of RAM, an iFlash card and about 13,000 songs. More measurements are in performance.md.

Highlights

  • Search with the click wheel, on a ring of letters. With Smart Search, on by default, the wheel skips letters that wouldn't find anything.
  • Playlists on the iPod itself: create them, rename them, put them in folders, add and remove songs, and edit the .m3u8 and .m3u playlists you copy onto it. On-The-Go is back and saves as a playlist.
  • Smart playlists synced from Music or iTunes update on the iPod as you listen, with rules based on rating, play count or media kind.
  • Music copied directly onto the iPod joins your synced library, with covers.
  • A refreshed interface: Settings in folders with hints, Cover Flow laid out as on an iPod classic, albums listed chronologically by year, and customizable menus and Now Playing.
  • An installer for Windows.

Upgrading from 1.2

  • Run install.sh on a Mac, or install.ps1 on Windows. Settings, the database, play counts and ratings are kept. The installer asks once whether to add the games.
  • The Windows installer is new and has had little testing. If it goes wrong, a report with the output of -DryRun helps.
  • The first boot runs Updating Library once: the library fonts and Cover Flow's slides are rebuilt, and covers are prepared for music copied outside iPod_Control. With many copied albums this can take several minutes.
  • Fatigue Reduction has been removed and is off after upgrading.
  • Settings moved into folders: a setting you don't find at the top level is now under Sound, Playback, Appearance or General.
  • Update plugins together with the firmware. A plugin from another build could crash the iPod, so it is rejected with "Incompatible version". Both installers update plugins automatically; when installing by hand, extract rockbox.zip, and rockbox-games.zip for the games, at every update.
  • Release files: rockbox.zip, bootloader-ipodvideo.ipod, ipodpatcher (macOS) and SHA256SUMS, as in 1.2; rockbox-games.zip with SHA256SUMS-games; ipodpatcher.exe with SHA256SUMS-windows. install.sh from 1.2 still works with this release.

Added

Library

  • Automatic library updates for music copied directly onto the iPod. Copied music appears alongside synced songs in Artists, Albums, Search, Cover Flow and Shuffle Songs. The check runs at boot and after every USB disconnect; when no files have changed, it takes 0.1 s.
  • Songs deleted from the iPod leave the library at the next check, and a moved or renamed file keeps its play count and rating. Plays and ratings of copied songs stay on the iPod.
  • Album art for copied music is prepared during the library update, from the file or an image in its folder, and cached. New cover-cache entries are created only if at least 64 MB will remain free on the iPod's drive.
  • Song titles in Korean, Japanese, Chinese, Hebrew, Arabic and Thai are displayed with fonts built during the library update from the characters your library uses.
  • .rockbox/drive.txt describes the drive (make, firmware, size, power-on time), without its serial number, for bug reports.

Search

  • Music > Search: type with the click wheel on a ring of letters. Artists, albums and songs appear as you type, matched by the start of any word, ignoring case and accents.
  • The ring holds the menu language's alphabet, Latin, digits and every other alphabet in your library, Korean and Japanese kana included.
  • Settings > General > Smart Search (default On) dims and skips letters that wouldn't find anything.

Playlists

  • Playlists made on the iPod. New Playlist and New Folder are at the top of Playlists, and names are typed with the click wheel. Hold Select on one of these playlists to rename it, move it to a folder or delete it, and on one of its songs to remove it. Playlists copied into /Playlists by hand can be edited the same way.
  • Add to Playlist... in the menu opened by holding Select in Music, Search, Cover Flow and Now Playing, listing the playlists made on the iPod. Songs added to a playlist that is playing join the queue too.
  • Icons distinguish synced playlists from local playlists: a computer marks synced ones, which can't be changed on the iPod, and an iPod marks local ones, made on the iPod or copied onto it, which can be edited.
  • After a sync, playlists made on the iPod drop songs that were deleted and follow songs the sync moved.
  • On-The-Go. Add to On-The-Go is the first item of the menu opened by holding Select on a song, album, artist or playlist, and in Now Playing and Cover Flow. On-The-Go is the last row of Playlists; Save Playlist turns it into a playlist of its own, and Clear Playlist empties it. Like every playlist made on the iPod, it stays on the iPod: it doesn't appear in Music or iTunes.
  • Live smart playlists. For smart playlists synced from Music or iTunes, rules on rating, play count and media kind, with limits by songs or time, are evaluated on the iPod: at boot, after a sync, and when the playlist is opened after a rating or play count changed. Smart playlists with other rules stay as synced.
  • Library playlists open like Songs, in the order set in Music or iTunes, with Shuffle Songs first.
  • Playlist folders: from Music on a Mac (install.sh --folders) or iTunes on Windows (install.ps1 -Folders), they appear in Playlists after the next sync.

Cover Flow

  • Holding Select on an album, or on one of its songs, opens the menu Music's lists have: Add to On-The-Go, Add to Playlist..., and while music plays Play Next and Play Last.
  • Settings > Playback > Pause in Cover Flow (default On). With it Off, music keeps playing while you browse.

Now Playing

  • The cover has a reflection in every color mode and in the dark theme. Angled Cover (default Off) tilts it.
  • Settings > Appearance > Status Bar, Rating and Progress Bar: iPod or iOS style. The iOS icons, stars and bar were drawn by Linus (u/Linusssk).
  • Settings > Appearance > Bold Text: Now Playing, lyrics and Cover Flow's captions in bold.
  • Settings > Appearance > Status Icons: the colors of the status bar icons when Cover Colors fills the screen.
  • Settings > Now Playing Menu: choose which of the 14 items the menu opened by holding Select in Now Playing shows.

Menus and controls

  • Settings > Main Menu and Settings > Music Menu: choose the items. Sections of Music, such as Artists or Songs, can be added to the main menu.
  • Hints under the settings whose names don't explain them, in all menu languages.
  • Settings > General > Wake Screen. With Select & Menu (default), only those two buttons turn the screen on; Play, Previous and Next work with it off, and in Now Playing the wheel sets the volume.
  • Settings > General > Return to Now Playing: during playback, menus and lists return to Now Playing when the screen turns off (default), after another 10 or 30 seconds, or never.
  • In lists, the playing song has a speaker icon; Select on it opens Now Playing.
  • An artist's albums are listed by year, oldest first, with the year before each name: in Artists, Genres, Composers and Go to Artist. An album's year is the latest year among its songs.
  • Music > Albums: Sort By, at the top, switches between Year (default) and Name.
  • Screens slide when entering and leaving menus.

Sound

  • EQ preset WH-1000XM4C, under Headphones, for the Sony WH-1000XM4C by cable in Active Mode (headphones switched on).

Extras

  • Optional rockbox-games.zip with eight more games: Rockblox, 2048, Sudoku, Sokoban, Reversi, Space Rocks, Bubbles and Clix.
  • Extras > Games is sorted by name in the menu language. Clock, Calendar, Stopwatch and the built-in games are translated into the menu languages, help screens included.

Changed

  • Settings are organized into folders: Sound, Playback, Appearance and General.
  • Cover Flow is laid out as on an iPod classic: a light background in the light theme, larger covers, no status bar. Previous and Next now move one album at a time, and keep going while held; in an album's song list they open the next or previous album. The song list shows lengths.
  • Lists in Music and Playlists use the full screen width.
  • Wheel acceleration follows the stock iPod's: faster in stages beyond one turn per second; short lists don't accelerate. Wheel steps are no longer dropped while the screen draws.
  • Volume moves in 100 equal steps, shown in Now Playing as a percentage.
  • Now Playing's rating and play count come from the database. After changing the rating, Select returns to the first Now Playing view.
  • Choosing another song in a list starts it without the Fade on Stop fade.
  • Songs opens in 0.21 s and reopens instantly while the library is unchanged.
  • Text contrast in Cover Colors modes: 7:1 for the title, 4.5:1 for other text, 3:1 for lyrics not being sung.
  • Holding Select on Music's own sections (Artists, Albums, Songs and the rest) opens nothing, as on a stock iPod. Play Next and Play Last there queued the whole library or a single album.
  • Music, chosen in the main menu, opens at the Music menu rather than the last list.
  • Resume Playback is hidden in the main menu when there's nothing to resume.
  • The database and the directory cache load under the boot logo, before the main menu.
  • Removed the previous import caps of 256 playlists and 128 playlist folders.
  • SD card adapters that don't report themselves as flash are treated as flash when their first read after power-on is fast.
  • Removing deleted songs during a library update is faster: 50 songs take 0.7 s.

Fixed

  • Adding an artist with Add to On-The-Go, Add to Playlist, Play Next or Play Last added only its first album; it now adds all of its songs, album by album. A genre or a composer adds all of its songs.
  • Since 1.2.4, the screen could stay off during playback with only the volume working.
  • Cover Flow could crash when scrolled quickly past albums whose covers were loading.
  • The LCD controller could hang when Cover Flow and the rest of the firmware drew at the same time.
  • The current track's play count when USB was connected reached Finder a sync late or not at all.
  • After Previous or Next, the rating shown and the play count recorded were those from when the track was buffered.
  • A library update started while music played could deadlock with playback stopping.
  • Playlists were duplicated as "Name 2" when .rockbox/itunesdb_playlists.txt was missing.
  • On the iPod, files deleted outside Finder were never removed from the library.
  • Songs in .Trashes, and macOS ._ files, were added to the library.
  • After a sync, the sounds of the stock firmware's games were added as songs and showed in Cover Flow. They're removed at the next USB connection or sync.
  • A file with a PNG picture before a JPEG one showed no cover; the first JPEG is used now.
  • Cover Flow showed stale covers from old cache files for albums without a cover.
  • Lyrics disappeared after a track change followed by a pause, until the wheel moved.
  • An .lrc copied over USB for the playing song wasn't found until a reboot.
  • Resume Playback played nothing when its songs had been deleted over USB; it now resumes at the next remaining song.
  • Resume Playback could wait on "Loading..." for minutes after Updating Library.
  • Lists opened soon after boot waited up to 20 s for the database.
  • List scrolling stuttered for seconds after a seek or pause.
  • Night Mode's schedule didn't apply its volume limit, dimming or silent wheel while a plugin such as Cover Flow was open.
  • Play with the screen off only turned the screen on.
  • Volume steps were uneven.
  • Arabic text: right-aligned lines stopped short of the edge, setting values were hidden, and hints wrapped early.
  • Letters with straight sides touched, as "i" and "P" in "iPod": fonts now keep the spacing their typefaces define, so text is 1–5% wider.
  • An import on a full disk could leave half-written files.
  • The main menu took its order from a plain Rockbox config.cfg.
  • SD card adapters were powered off 7 s after each read while the screen was on, so each read waited 0.6–0.75 s.

Removed

  • Settings > Sound > Fatigue Reduction.
  • Rockbox's Add to Playlist, which offered synced playlists and named new ones with a keyboard. Add to Playlist... lists the playlists made on the iPod.
  • Cover Flow's jump to the next letter on Previous and Next, and its "Cache should be updated first" message.

Installers

  • New install.ps1 for Windows 10 and 11: run irm https://raw.githubusercontent.com/ssarkisy/RockWheel/main/install.ps1 | iex in PowerShell, not as administrator. It doesn't convert Mac-formatted iPods; restore such an iPod in iTunes on Windows first. Its options are in the README.
  • install.sh: new options --folders, --games and --no-games.
  • Both installers ask whether to add the games while none are on the iPod; Enter means No. Updates replace installed games, and saved games and high scores are kept.
  • ipodpatcher now refuses to install the bootloader on Mac-formatted iPods, preventing a startup failure. Convert the iPod to FAT32 first.

Known issues

  • In the simulator configured with 32 MB of RAM, libraries above about 25,000 songs may not load the theme after a restart straight into Updating Library.
  • Song titles in Hindi and Thai are displayed, but their combining marks can be misplaced.
  • Walloon has none of RockWheel's own phrases; they show in English.
  • The help and in-game texts of the eight added games are in English.

Limitations

  • Playlists made on the iPod, On-The-Go among them, stay on the iPod: Finder and iTunes don't bring them into the library.
  • Smart playlists with rules other than rating, play count and media kind are only updated by a sync.
  • PNG and progressive JPEG artwork for music copied directly onto the iPod isn't supported. Updating Library says how many albums have such a cover.
  • Albums of the same name by different artists share one row in Music > Albums.
  • Search has no Chinese characters or kanji on its ring: names written in them can't be searched.
  • Hindi and Thai aren't offered as menu languages.
  • In the simulator configured with 32 MB of RAM, a library of 100,000 songs doesn't start. At most 32,000 songs can be queued.
  • On original hard drives, Cover Flow, covers and the library update are slower, and battery life shorter.
  • install.ps1 -Folders needs iTunes from Apple's website; the Microsoft Store version can't be reached by scripts.
  • RockWheel doesn't play video. The stock firmware, still on the iPod, does: turn on the Hold switch as the iPod starts to boot into it.