Part 3 · Media & Phone
Apple Music
xOverland has a full Apple Music player built right in — no phone projection, no CarPlay needed. Sign in once and you can browse your library, search the whole Apple Music catalog, and stream full tracks on the truck's big screen, all inside the app.
Where to find it: The Apple Music player opens as its own full-screen page. Setup lives at Header › gear icon › Settings › Apple Music.
Heads-up on availability: The Apple Music player is fully built and working, but in the current release its tab is turned off in the bottom dock while it's being polished, so you may not see an "Apple Music" button on your home screen yet. Everything below describes the player exactly as it works once it's switched on. Your Settings setup (below) still applies and is saved for when the tab goes live.
When you'll use it: When Apple Music is your music service and you want to run it natively on the head unit — pick a playlist, search for a song, and control playback with large, easy-to-hit buttons — instead of streaming from your phone over Bluetooth.
The screen, part by part
The player has two states: a sign-in gate the first time, and the main player once you're in.
Before you sign in — the gate
- Music-note logo and "Apple Music" title at the top of a centered card.
- A status line that tells you what's happening — "Connecting to Apple Music…", "Sign in to stream your library and playlists.", or an error message if something's off.
- "Sign in to Apple Music" button — the big blue button that starts Apple's own sign-in.
After you sign in — the main player
- Top tab row with three views:
- Listen Now — your recently played tracks and your playlists, laid out as shelves of artwork.
- Library — your saved playlists and albums.
- Search — reveals a search box below the tabs.
- Sign out button — on the right end of the tab row.
- Search box (only in the Search view) — type a song, artist, or album; results appear automatically as you type, grouped into Songs, Albums, and Playlists.
- Content shelves — rows of square artwork cards, each showing the cover art, a title, and the artist or playlist name. Tap any card to start playing it.
- Now Playing bar (across the bottom, appears once something is playing):
- Album artwork on the left.
- Track title and artist in the middle.
- A thin progress line under the title that fills as the song plays.
- Three controls on the right: Previous (⏮), Play/Pause (the button shows ▶ when paused and ❚❚ when playing), and Next (⏭).
How to set up Apple Music
- Go to Header › gear icon › Settings and scroll to the Apple Music section.
- In the "Apple Music developer token" field, paste your developer token (it's a long code that begins with
eyJ…). - Tap Save token. The button changes to Saved to confirm it's stored — on this device only.
- Open the Apple Music player. It will connect and show the sign-in screen.
If you ever want to remove the token, tap Clear next to Save (it appears once a token is saved).
How to sign in and start listening
- Open the Apple Music player. When it says "Sign in to stream your library and playlists," tap Sign in to Apple Music.
- A full-screen Apple sign-in window opens. Enter your Apple Account details and approve access — this is Apple's own secure sign-in, handled entirely by Apple.
- When the window closes, you land on Listen Now with your recently played music and playlists.
- Tap any artwork card to start playing. Use the Now Playing bar at the bottom to pause, skip, and go back.
Your sign-in is remembered, so you won't have to do this every time.
How to find and play a specific song
- Tap the Search tab.
- Type into the search box — results update on their own after you pause typing.
- Browse the Songs, Albums, and Playlists results and tap the one you want. Playback starts immediately and the Now Playing bar appears.
How to sign out
- In the top tab row, tap Sign out on the right.
- You'll return to the sign-in screen. Your developer token stays saved in Settings, so you can sign back in anytime with one tap.
What you need
- An active Apple Music subscription on your Apple Account — this is what unlocks streaming your library and the full catalog.
- An Apple Music developer token pasted into Settings › Apple Music. This is a one-time technical setup that lets the built-in player talk to Apple Music. Until a token is saved, the player shows a "Connect Apple Music" screen pointing you to Settings, and won't stream.
- An internet connection on the head unit (Wi-Fi or a hotspot). The player streams over the web and also needs internet to load Apple's music engine and sign you in.
If any of these is missing, the player is honest about it: no token shows the "Connect Apple Music" prompt, no internet or an invalid token shows a clear "Couldn't start Apple Music" message telling you what to check.
Tips & good to know
- It's a real, native player — not your phone's screen mirrored over. That means it keeps working on its own and gives you big, glanceable artwork and controls suited to the 15.6" screen.
- The developer token is technical. It's a long-lived code you generate once from an Apple Developer MusicKit key. If you're not comfortable creating one, this is the kind of step worth having someone technical set up for you — after that, everyday use is just tap-to-play.
- Everything stays on your truck. The token is stored only on this device, and your Apple sign-in is remembered inside the player.
- "Nothing to show yet" on Listen Now simply means you haven't played much on this account recently — play a few things (here or in Apple Music anywhere) and your recents and playlists fill in.
- If a track won't play, the Now Playing bar will say "Playback error" with a short reason rather than failing silently — usually a sign to check your subscription status or connection.
- This is separate from the main Music page. xOverland's unified now-playing (which follows whatever's playing over Bluetooth or from other apps) is its own thing; the Apple Music player here is a dedicated, sign-in-based Apple Music experience.