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
-
Download a playlist's ghost songs from the playback sources (#219)
Details
Importing a Spotify CSV (or any file or pasted list) left the songs not in the library as ghost songs, with no way to get them all: only the link import had "Also download".
-
src/ghostDownloads.js: each ghost song is found on the playback sources, in the order set in Settings (the lookup radio and Mix use), then downloaded; one already in the library takes the ghost's place at once. Streamed ghosts are downloaded straight from their source.
-
The downloader's new replaceImported option: the file takes those ghosts' place in the playlist when it's in (or at once, when the song is already in the library, or joins a download already running). Accepted by the desktop IPC and the web route (ids checked, 20 at most).
-
Import playlist, From a file and From a list: "Also download the N songs not in the library yet", run in the background with progress in a toast.
-
Playlist pages with ghost songs: "Download all (N)" next to Resolve Ghost Songs, for playlists imported before.
-
-
Add ascending and descending playlist column sorting (#221)
Details
Summary
- Add clickable sorting to playlist song-list headers for #, Date added, and Time.
- Each header toggles ascending/descending order and shows the active direction with an arrow and accessible label.
- Preserve original playlist numbers while sorted, keep unknown dates/durations at the end, and retain stable order for ties.
- Make Play All, Shuffle, row playback, selection, and large-list windowing use the displayed order.
- Keep drag-reordering available only in the original # ascending order; sorted views cannot accidentally save a reordered playlist.
- Apply the same controls to regular playlists, smart playlists, and Liked Songs.
Validation
node --test scripts/*.test.mjs— 312 passed.npx vite build— passed.node /tmp/omnirush/playlist-sorting-ui.mjs— passed:- all three headers toggle both directions;
- original playlist numbers remain visible;
- Play All and row playback follow sorted order;
- selection, removal identity, keyboard activation, smart playlists, Liked Songs, and 650-song windowing work;
- sorting does not trigger accidental manual reordering.
- CodeRabbit review — completed with 0 findings.
Screenshots
-
Prevent system sleep in fullscreen mode (#222)
Details
Summary
- Keep Windows, Linux, and macOS awake while Lokal owns full-monitor fullscreen mode.
- Use Electron's
powerSaveBlockerwithprevent-display-sleep, which prevents both display sleep and system sleep while the fullscreen player is paused or playing. - Track HTML fullscreen and native fullscreen entry/exit, release protection on exit, minimize/hide, navigation, renderer failure, window close, and app quit.
- Do not block sleep for normal playback, the in-app fullscreen overlay alone, maximized windows, or hidden/minimized windows.
Validation
node --test scripts/*.test.mjs— 320 passed.node --test scripts/fullscreen-sleep.test.mjs— 8 passed.node --check electron/main.jsandnode --check electron/fullscreenSleepBlocker.js— passed.npx vite build— passed.git diff --check— passed.- CodeRabbit review — completed with 0 findings.
The implementation uses Electron's platform-supported
powerSaveBlockerAPI, so the same lifecycle applies on Windows, Linux, and macOS.Summary by CodeRabbit
- New Features
- The display now stays awake while the app is visible in HTML or native fullscreen, helping prevent interruptions during viewing.
- The display-sleep prevention ends when fullscreen is exited or the window is hidden, minimized, closed, or otherwise unavailable. It also resets after relevant navigation or renderer failures.
Full Changelog: v5.4.3...v5.4.4
Setup
See README.md for full setup instructions.
Binary Checksums (SHA-256)
Lokal-5.4.4-arm64-mac.zip:
[7658A4660BFD685827CFBAF30AC3C9A099F8062A602AFB7054AC6AB7AC06B8E0]
Lokal-5.4.4-arm64-mac.zip.blockmap:[99E82AB3619D721AE751F0C931E7EA47BF03E42608A29B2E17219AF44BC6EF77]
Lokal-5.4.4-arm64.dmg:[477A667718B8A7A533BE1B7F5BADD4CD21538434BC0F78C65BE9A54A70275815]
Lokal-5.4.4-arm64.dmg.blockmap:[F12E830C2BBE2DB220A62565B1C014AB6A3795773CA3D263C29C383B9CCA77C1]
Lokal-5.4.4.AppImage:[99722101478219A13D769D6E498F2A0B77D9D53B104ECD8FAB2DB76953CC76D9]
Lokal-5.4.4.exe:[3E0E8F1BE3EBF356B496937F9B696DDFAA4B7EA17080E18444C7E53CC95C8691]
Lokal-Setup-5.4.4.exe:[7F99D1811969D34B1FC9EC85341F081A813EB32E39C17327E009CEC09EA63CC2]
Lokal-Setup-5.4.4.exe.blockmap:[9DAEECFAF76B4ACF9A450B2A35E1813A1486380D6011827B0D8B5F8709BAE471]
builder-debug.yml:[C39F550EDBBBAC41F7338126B4B4D7E9AADC18F191010B0AF0840FA57B4F8D42]
latest-linux.yml:[531F06ECD77879E0D72F09C3997E382A3A6E7B4A59EF0144EB4DA4AD6450DD18]
latest-mac.yml:[A3067349503ACFCF0F43BDC29BCCF69C26FFD7E29062E892CEEF362826949CD7]
latest.yml:[731D7E1CBA832EFEF9544C7027DFAFACC42EF2EAC37399F3442E0C3EC45F3C93]
lokal-music_5.4.4_amd64.deb:[D8B1C3CD6EB7AC64664B160D55AAAAF43FC2361B4C71FDDC9ED42C76AAA65BBF]


