Welcome
The Welcome screen is the first thing you see when you open iPodRocks.
What it does
The Welcome panel gives you a quick overview of the app and links to every main area: Dashboard, Library, Playlists, Auto Podcasts, Extra Audiobooks, Devices, Sync, and Settings. It explains that iPodRocks works with any Rockbox or mountable device and guides you to use the sidebar for navigation.
Three cards make up the page:
- Hero — logo, a short description, a link to the full documentation, and the Check for Updates button (see below).
- Get started — one line per sidebar tab, describing what each panel is for, including Extra Audiobooks (LibriVox), the Listening Stats on the Dashboard, and the Web Server card in Settings.
- Features — a compact, two-column list covering the app's feature set: Sync, Sync from anywhere (the web server and remote devices), Multiple devices, Library & shadows, Playlists (Classic, Smart, Genius), Genius (the named playback-history playlist types), Star ratings, Listening stats, Podcasts, Rockbox-native smart playlists (tagnavi), Conversion & codecs, Harmonic mixing, Headless daemon, and Rocksy — the last marked optional, because it is the one item on the list that needs an API key you supply.
A Check for Updates button in the top-right corner of the hero card lets you manually check whether a new version of iPodRocks is available on GitHub. When a newer release is found, a modal shows the version number and a "Go to Releases" link. The modal also offers a 30-day snooze: ticking the checkbox before closing suppresses the automatic startup check for 30 days. The manual button always works regardless of the snooze state.
How it works
The Welcome screen is a static landing page. It does not load data from the database or devices (aside from the update check itself). The "Get started" and "Features" cards are plain content — no live data.
How to work with it
- Read the overview to understand the workflow: add a library folder, add a device, optionally create playlists, then sync. None of it needs an account or an API key.
- If your player is plugged into a different machine from your library, set up the web server and add it as a remote device instead.
- Use the sidebar to jump to Library, Devices, Playlists, Auto Podcasts, Extra Audiobooks, or Sync.
- After your first setup, you can skip Welcome and go directly to Dashboard for an at-a-glance view of your library, devices, and listening stats.