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
New
- Recap filter: All / Library / Streamed. A switch on the Recap page picks which plays a recap counts: every song, only your library's files, or only songs streamed from YouTube Music, SoundCloud or an addon. The periods, the recap and its top artists and genres all follow it, and the choice is remembered. A filtered recap doesn't overwrite your saved listening profile. (#176)
- Queue tab in the side panel, next to Details and Lyrics. (#180)
- Zoom album and artist pictures. Click the cover on an album or artist page to see it big; Escape or a click closes it. You now change a library artist's picture with the camera button on its corner. (#180)
Improvements
- Save buttons show what's already in your library. In Search, Home and the player bar, a song you already have shows as saved before you click anything. In Search, if your copy is low quality, you get an upgrade button instead, and the better version replaces your file. You can still download a song marked as saved from the button's right-click menu. (#180)
- Streamed songs in recaps get their covers. Recap cards, sessions, albums and the story now show streamed songs' artwork. (#177)
- Streamed songs get a genre. Streamed songs that come without one are looked up on iTunes in the background, so Top Genres is no longer empty for them. Songs you've already played are filled in once at startup. The "Fetch Online Artwork" setting turns this off. (#177)
Behind the scenes
-
Releases can be started from Actions. Release Lokal → Run workflow opens the "Version X.Y.Z" PR, and merging it tags and builds the draft release, with notes generated from the merged PRs. (#178, #179, #181)
-
Streamed songs: covers in recaps, genres looked up (#177)
Details
Recap covers (the main card, sessions, albums, the story) read only a downloaded artwork file, so streamed songs showed none: their own cover (artwork_url) is used now. The session mosaic also stopped treating every song without an artwork file as the same cover.
Streamed songs rarely come with a genre, so Top Genres and session genres were empty for them. A song saved from YouTube Music, SoundCloud or an addon without one gets it from iTunes in the background (a result by that artist only), like the library's "Fetch missing genres"; streamed songs already played are filled in once at startup. The details panel looks up the playing song's genre when it has none. Off with "Fetch Online Artwork".
-
Release Lokal: Run workflow bumps, tags and builds the release (#178)
Details
Actions > Release Lokal had no Run workflow button: it only ran on a pushed tag, so every release took a version PR and a tag pushed by hand.
-
Run workflow (patch / minor / major, or an exact version): bumps package.json, package-lock.json and the README badge on main, tags vX.Y.Z and builds the draft release in the same run. Refuses an existing tag, an older version, or nothing new since the last release. The tag is made with the default token so it doesn't start a second run. If main is protected, a RELEASE_TOKEN secret allowed to push is used.
-
Release notes: one entry per PR merged since the previous version, its description folded under it, version bump PRs left out, contributors and the compare link; GitHub's own list if that fails.
-
Pushing a vX.Y.Z tag by hand still works as before.
-
-
Release Lokal: open the version PR; merging it tags and builds (#179)
Details
main only takes changes through a pull request (the run was refused pushing the bump to it), so Run workflow no longer pushes to main:
-
Run workflow pushes the bump to release/vX.Y.Z and opens the "Version X.Y.Z" PR (or reuses one left open), and says so in the run.
-
A push to main that changes package.json to a version without a tag (that PR merged, or a bump PR merged by hand) tags it and builds the draft release.
-
Run workflow when package.json already has an untagged version tags and builds it at once.
-
-
Library marks on save buttons, Queue tab, cover zoom (#180)
Details
-
Save buttons (Search, Home, the player bar) show a song already in the library as saved before anything is clicked: by where it was downloaded from, or by artist and title (remaster labels, "Artist - Title" videos and credited artists allowed for). Read once, again when the library changes.
-
In Search, a song whose library copy is low quality (the Audio Quality page's "low" tier) gets an upgrade mark instead: click to download that version, which replaces the file when it's better. Elsewhere it's "saved".
-
A song marked saved only by that check can still be downloaded from the button's right-click menu.
-
The side panel's tabs: Details, Lyrics and now Queue.
-
Album and artist pages (library and online): click the cover or picture to see it big; Escape or a click closes it. Online pictures are asked for in a larger size. The library artist's picture changes from a camera button on its corner.
-
-
Release Lokal: link to open the version PR when Actions can't (#181)
Details
Without "Allow GitHub Actions to create and approve pull requests" the run failed. It now ends green with a link that opens the PR, title filled in, in the run summary and as a notice.
Full Changelog: v5.2.1...v5.2.2
Setup
See README.md for full setup instructions.
Binary Checksums (SHA-256)
Lokal-5.2.2-arm64-mac.zip:
[1CB52B7E4289560B01562D4E9D7B3B411B25BB35006CE390B6155791237134C1]
Lokal-5.2.2-arm64-mac.zip.blockmap:[E67E98FF88B7A17965A204F4C9479A8FD30567C58D4A2E2CED424907EA04D569]
Lokal-5.2.2-arm64.dmg:[2864BDAF734B84F2D853436CD75985AC9E332C59199E1A61F1141461F6C886F7]
Lokal-5.2.2-arm64.dmg.blockmap:[5657D245F0434D1B43A2959AF25945810F74BF832DF1BEF53F1DB7A157289BA6]
Lokal-5.2.2.AppImage:[F6D88B06F7420EB52B7966CC6D87DA00CE71BD2D6AA961AEFA069A7E87DAC438]
Lokal-5.2.2.exe:[E6CC4A1BA282A6AFC1B71D35F82A9257FEC024B7BA26FC137853D5901D4FC4AB]
Lokal-Setup-5.2.2.exe:[E786BA3EB6F52738723A2F5ED9CB4BB25EF5E2D27ED671C6717C2B714E0EAE88]
Lokal-Setup-5.2.2.exe.blockmap:[5ACC2F9B4F55EDDFBFFFBA299E6E0E706549195C035FEB4DD6DCA84F936A4128]
builder-debug.yml:[EAAE02F379E178BA65A472C8BFADEB6DEEBA3BAD56F4A5325D1012DDCE5BF624]
latest-linux.yml:[09A695120E933218FB88845E1BB5096719232EFDCF99199EDE8AA50D5031A266]
latest-mac.yml:[F7AAFC9AF2A61D873E534A26EBC8A4644ADB51CEC4902306ED1210BEE6E367CE]
latest.yml:[46DF764C6A174C0B443918EAE748AFF8E561B3EFC31414CE05E422842FE5B71A]
lokal-music_5.2.2_amd64.deb:[20B72F19A26A57A69E279125A5A935AFE159016DCF7AE71787ADB8C670B4EA63]
