Merge pull request #715 from lokal-music/release/v13.0.0
Changelog
Windows builds: free code signing provided by SignPath.io, certificate by SignPath Foundation (code signing policy).
FYI:
Lokal is 100% local; the library, history, anything in database, or any info that is used for API's such as yt-dlp, LRCLIB, is NOT seen by us.
What's Changed
-
Rebuild Stations around Radio Browser (256 kbps+ and lossless) (#714)
Details
New Stations experience
- Replaces the catalog-link-first Radio page with a worldwide Stations browser powered by Radio Browser.
- Only directory-reported 256 kbps+ MP3/AAC/Opus/Vorbis or lossless FLAC streams are eligible. Unknown and lower-quality streams are excluded. FLAC is searched separately so its sometimes-missing numeric bitrate does not suppress it.
- Fixed directory mirrors, bounded requests, TTL caching, server-side bitrate filtering, paging and duplicate-broadcaster suppression. The highest-quality qualifying variant wins.
- One-click playback through the existing station playback engine, plus persistent favorites, Favorites filtering, world/country/genre search and Lossless filtering.
- Now Playing on visible rows when the broadcaster publishes Icecast status: shared per-origin cache, max 3 concurrent requests, 60-second updates while visible, and 5-minute negative caching. Active-player metadata remains in place; no background audio streams are opened.
- Updates Electron IPC, web API and sidebar label; keeps legacy catalog code for compatibility.
Verification
Focused Node regression tests: bitrate gate, FLAC, dedupe, pagination, Icecast mount matching, private-host rejection. Dedicated Stations CI workflow is passing.
Limitations
Radio Browser advertises rather than independently measures bitrate; broadcaster actual stream quality can differ. Some radio stations do not publish current-track information, so their rows show station details instead. Favorites are currently persisted locally; cross-device synchronization is not part of this PR.
Summary by CodeRabbit
- New Features
- Browse radio stations with search, country and genre filters, pagination, and favorites.
- Station listings show now-playing metadata when available. Select a station to start playback, or select the currently playing station to toggle playback.
- Results include lossless streams and supported lossy streams with a bitrate of at least 256 kbps. A filter lets you show only lossless stations.
- The sidebar page is labeled “Stations.”
Contributors: @CHEYCKIT
Full Changelog: v12.8.0...v13.0.0
Setup
See README.md for full setup instructions.
macOS: this build is ad-hoc signed, not notarized (no Developer ID certificate is configured). The first time, right-click Lokal in Applications and choose Open, or run xattr -dr com.apple.quarantine /Applications/Lokal.app.
Binary Checksums (SHA-256)
Lokal-13.0.0-arm64-mac.zip:
[7C8AF28CD1CE5DAF80B011E7813305E24BD4399DD3E055ED91223E6C4E6D23DF]
Lokal-13.0.0-arm64-mac.zip.blockmap:[ED8D601F15F91EBDBE05AEED8C187EB4E54462934195DC072C9AD47FEDEAA6AE]
Lokal-13.0.0-arm64.AppImage:[2DD8F9E576829D710149D5E8DF109246C87967451BD17C160843CBEAAAED9172]
Lokal-13.0.0-arm64.dmg:[D057A58E574D5E70DCB58C3055AB61D96129CFD83E7E0AEFBFA95169E74870E8]
Lokal-13.0.0-arm64.dmg.blockmap:[A25631801D669748A1D2B8FF1A45A4461CDD9F875D59C461950427ECC90FA8C5]
Lokal-13.0.0-mac.zip:[9746291D4D63405D112180C75A3721927802615DFFB6B78D8B36724BC679A371]
Lokal-13.0.0-mac.zip.blockmap:[A28AB0811F91376C6D9F24CFF44557DBC3AFE2C08940B4332B9A652E41874F9D]
Lokal-13.0.0.AppImage:[B3D8A406219BA8BBF8AFD7DA8488E6C15DDD626A6447DB297C773910AF5675C6]
Lokal-13.0.0.dmg:[DFB02292B0890B5C461D3AC896D818A619F0E5982A972380E8529CEB6EAC9A2D]
Lokal-13.0.0.dmg.blockmap:[DB4DB19013EEE886714781A86BE323CB782B1F349D75B1AAC25F07B8E488682B]
Lokal-13.0.0.exe:[1C7F9F007A44FD4FF321CA8D99757E747DAFE26EC56A864F98993AAF82D98B3B]
Lokal-Setup-13.0.0.exe:[19AB4BDF750ED78F0FE7BFC43C8A7A17B28B3A4139CA0E000CD3AD31CE1EBC84]
Lokal-Setup-13.0.0.exe.blockmap:[C3A85105E896D093D73E4A7E8565863184A151F6B66BEA726678819E4EEC0ECF]
builder-debug.yml:[0372592FEBC98B80F80D404225B422E5F5C5A57EDE8D3B3B1D8686639DFC9DE4]
latest-linux-arm64.yml:[EEDBD0A8EC21D693561FF0DC92A5EAE70CEFA4C1DB3A2FD65374AC6B9261E74D]
latest-linux.yml:[7331459B0122B7EDACF8EC1C71AEA26871D1E944577F2A9365629B4459A7AF8A]
latest-mac.yml:[CBFD86EC2A83720C7F58FA9DE2EA493CC2DC8287F25BE3F2FAACE256B73202F8]
latest.yml:[B2E8532C2917B9BB3CD04FC95B1F8FAFD46812D88A72B08489E5042E226665EC]
lokal-music_13.0.0_amd64.deb:[E31558632C997BF060650B06A019DE0ED2548CB175A8385BBE743AAF0F272763]
lokal-music_13.0.0_arm64.deb:[6583F956ADADC2DE03B9849E062AC7C9C2CEB8E1AE3B3AC7B34189780C178AD8]