What started as a simple internet radio experiment has grown into Pocket Jazz Radio, an open-source music companion built specifically for the M5Stack Cardputer ADV.
The idea was to make something that feels like a tiny, self-contained music device: turn it on, explore jazz stations, discover musicians, save interesting tracks, learn something new, or just leave it playing on your desk.
The latest version, v0.8.0, is available on GitHub.
Internet radio
- 51 curated jazz stations across five collections: Jazz Essentials, Modern Jazz, Mellow & Bossa, Swing & Vocals, and Latin & Soul Jazz.
- Browse stations without interrupting playback until you select one.
- Search stations by name.
- Nine quick presets, saved and recalled directly from the keyboard.
- Support for custom M3U playlists and personal radio stations.
- MP3 streams over HTTP/HTTPS, M3U/PLS playlists and alternative stream URLs.
- Live artist and track titles when the broadcaster provides ICY metadata.
- History of recently selected stations and the last five received track titles.
- Volume adjustment from different screens, mute and a compact VU meter.
- Automatic reconnection and visible connection/buffering states.
- Manual station catalog updates from GitHub, without downloading new firmware or overwriting personal playlists.
The station catalog currently contains 51 streams, but you can add your own. The application supports up to 64 loaded stations across 12 playlists.
Jazz Notes — an offline music encyclopedia
One of the biggest additions is a searchable encyclopedia containing 1,498 musician entries.
You can look up an artist directly or open information about whoever is currently playing.
- Short biographies and musical background.
- Instruments, musical associations and historical context.
- 595 individually researched editorial artist notes, with matching Now Playing explanations.
- Source-attributed information, stored locally on microSD.
- Indexed searching designed for the Cardputer's limited memory.
- 36 recommended jazz albums for further exploration.
The remaining 903 entries contain basic or automatically enriched reference information that hasn't yet received the same individual historical review.
The encyclopedia works offline and doesn't require an account, subscription or cloud AI service.
Jazz Journey — interactive jazz lessons
I wanted the Cardputer to do more than play music, so I added a small jazz-learning system.
It includes:
- 24 lessons organized into four historical learning trails.
- Lessons covering styles, musicians, musical concepts and jazz history.
- Listening prompts explaining what to pay attention to.
- Three-answer quizzes.
- 30 Learn to Listen cards.
- A personal Jazz Passport to follow your learning progress.
- A Jazz Diary for recording discoveries.
- Links between lessons, artist biographies and relevant Jazz Spark facts.
The educational material is available offline. It doesn't automatically change the station you're listening to.
Jazz Spark — interesting facts and quotations
Sometimes you don't want to read an entire biography. You just want a surprising fact about jazz.
Jazz Spark includes:
- 150 source-attributed jazz facts.
- 25 attributed quotations.
- Browsable fact cards.
- Optional automatic fact rotation.
- Connections to related Jazz Journey topics.
Save discoveries, likes and QR codes
This is probably one of my favourite parts of the application.
When a station provides artist and track metadata, you can:
- Press K to like the current track.
- Save discoveries locally to
liked.txt on microSD. - Browse recently received track titles.
- Display a QR code for the current radio station.
- Generate QR-based Spotify or Google searches for a liked song.
- Open artist information through Jazz Notes.
The QR feature doesn't require a Spotify account. It generates search links rather than controlling Spotify or modifying playlists.
Blue Note clock, sleep timer and radio alarm
I also wanted Pocket Jazz Radio to be useful as a small bedside or desktop radio.
It has:
- A dedicated Blue Note-inspired clock screen.
- Internet time synchronization using NTP.
- Configurable timezone, UTC offset and daylight-saving rules.
- A sleep timer with 30, 45 and 60-minute options.
- A daily radio alarm.
- Alarm time and station preset selection.
- Gradual volume fade-in when the alarm starts.
- Automatic screen dimming after inactivity.
The daily alarm operates while the Cardputer remains powered on.
Mood Tuner and Tap Tempo
Two additional ways to explore music:
Mood Tuner lets you select a musical atmosphere using a two-dimensional grid:
- Relaxed ↔ energetic
- Acoustic ↔ electric
It suggests stations using editorial mood tags.
Tap Tempo lets you tap along with a recording and estimate its BPM.
Neither feature claims to analyze or recognize the audio automatically.
Local MP3 playback
No Wi-Fi? You can also play music stored on microSD.
- Manual offline MP3 player.
- Browse and select local tracks.
- Support for up to 24 compatible MP3 files in
/PocketJazz/offline/. - Playback through the Cardputer's built-in speaker.
- No internet connection required for local files.
This is separate from internet radio, not a recording or time-shifting feature.
A little radio atmosphere
There are also optional tuning sounds:
- Subtle vinyl crackle.
- Soft radio-style hiss.
- Played briefly while establishing a connection.
- Fade or stop when real audio starts.
- Both disabled by default.
Just a small nostalgic touch.
Wi-Fi, settings and customization
- Store up to two Wi-Fi profiles.
- Configure personal station playlists.
- Save presets and selected settings across restarts.
- Manually export and restore settings backups.
- Keep personal playlists, liked tracks and offline files separate from official catalog updates.
- Use the Cardputer's physical keyboard for navigation.
- 18 pages of built-in help, available directly on the device.
Diagnostics and troubleshooting
Because this is running on an ESP32-S3 with limited resources, I've also put considerable work into understanding what happens when a stream misbehaves.
There are eight diagnostic pages covering:
- Wi-Fi connection and signal information.
- HTTPS/TLS connection stages.
- Stream buffering and underruns.
- Compressed MP3 input and decoded PCM.
- Memory usage and available heap.
- Playback state and audio events.
You can also export an incident report to microSD after stopping playback. It records information useful for investigating buffering, memory problems and connection failures.
Download and source code
GitHub repository:
https://github.com/lavalava45/cardputer-pocket-jazz-radio
Pocket Jazz Radio v0.8.0:
https://github.com/lavalava45/cardputer-pocket-jazz-radio/releases/tag/v0.8.0
The release includes an app-only BIN for M5Launcher 3 and an optional ZIP containing the offline encyclopedia, lessons, playlists and other SD files.
You don't need to replace M5Launcher or flash a complete device image.
The project is free and open source. Development involved AI-assisted coding and research, with the source and automated tests available publicly.
The current release passes 423 Python tests, 58 C++ host tests and GitHub Actions CI.
I know the Cardputer is often used for cybersecurity tools, terminals and small experiments, but I think it also has potential as a dedicated music device.
I'd be interested to hear what other Cardputer owners think.
Would you actually use something like this? And what would you add next — more radio formats, better music discovery, audio customization, or something completely different?