Merge pull request #629 from lokal-music/release/v12.2.8
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
-
fix(desktop): display full-resolution covers in the right sidebar (#628)
Details
Problem
The right-hand Now Playing sidebar still stretches
trackArtURL()(often a generated low-resolution.webpthumbnail) across its full-bleed cover, unlike fullscreen and Cover Flow.Fix
- Resolve the original/full-resolution artwork for the sidebar, including locally embedded art via
trackFullArtURL(). - Attempt existing provider-specific CDN upgrades (Spotify/Apple/Deezer/Tidal/Amazon/Google/YouTube) and retain the known original thumbnail as fallback.
- Predecode candidates and prefer real image dimensions so tiny CDN placeholder images are not selected as high resolution.
- Preserve the artwork beneath the higher-resolution overlay while it loads or if extraction fails, and ignore stale async results after a track/artwork change.
- Keep the existing
MixCoverstransition and motion covers unchanged.
Verification
- Added
scripts/sidebar-artwork-quality.test.mjsfor source selection, fallback, track-change safety and CDN ordering. - Automated tests and packaged Electron runtime validation were not executed in this environment; confirm through PR CI and playback testing.
Manual checks
- Play a local track indexed with generated
.webpart; compare the sidebar with fullscreen. - Play online Amazon, YouTube and Google-hosted artwork and verify sharper covers or thumbnail fallback.
- Skip tracks quickly, refresh/reassign artwork, and check for stale-image flashes.
- Test with a missing original artwork source and check that the original thumbnail remains visible.
- Resolve the original/full-resolution artwork for the sidebar, including locally embedded art via
Contributors: @CHEYCKIT
Full Changelog: v12.2.7...v12.2.8
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-12.2.8-arm64-mac.zip:
[5382A8664E8A611906BD595C79BD7612B9FA2D85364E797FC8899728AC3CFA51]
Lokal-12.2.8-arm64-mac.zip.blockmap:[9D50A476C65DC0A49819A10AAC0C313C1EC5673179D94092985A05452ADA82F2]
Lokal-12.2.8-arm64.AppImage:[31A1F0E8734A2EE9005B5D3632F9A418A30575153698A87F153389409D9350D0]
Lokal-12.2.8-arm64.dmg:[8B801E5B02A92A7BA6C3E96BD45671ACE5F4E77BB31E38D086DEDF4C86BF442D]
Lokal-12.2.8-arm64.dmg.blockmap:[3EF5911CE7D76DB494961DC36AC88315E755FC7CB0DD926E5F6CDA04B6FA3DD6]
Lokal-12.2.8-mac.zip:[AF747902FBBAB7E28EEDCC08A0448476100C46F97381C8408C8AAE0D2792BA18]
Lokal-12.2.8-mac.zip.blockmap:[20EEE9944735C3D7E3B69C2C986D39FF6134B53864FB12B98A5324A1819901AE]
Lokal-12.2.8.AppImage:[E98CD126A8B21F1DCEBCD21FA5BC097185936C1DCE7B74B3709045DBDD5284A4]
Lokal-12.2.8.dmg:[2DFEB9B3C58BB5A2A0B7EC684C4901681F9A474E2AEE21827F69D41A520895E9]
Lokal-12.2.8.dmg.blockmap:[1FD3D8E871411C7C9625E45F5CA61695A1508CAE077DA4C20B22DEDA408137DB]
Lokal-12.2.8.exe:[26D1D5ED7E97A7F03E28E4975B235924A72CA2FD69D4B4F3DBF17F195DD7CBA2]
Lokal-Setup-12.2.8.exe:[C7462F4A14D54FD6E3EEB5A72E797F088E4FD0712A73AB967803DAEA1463DEDA]
Lokal-Setup-12.2.8.exe.blockmap:[16FF2A235222BEDC92BFDB960CC4D7A090F69E7E986FDAFC4AE964105585B42D]
builder-debug.yml:[8967FCFD78D6C0A5FDCB45839624A94231A008EA16465FC2087AF4410F289468]
latest-linux-arm64.yml:[8897CDEEA35D05191454D8B7E49D704F1FCF4FE8A1B4A69CA5A4721D7DD0E0D9]
latest-linux.yml:[EAB1B8F8DE4983D3E379BFCC6D05834AC0FE2AEED98D3C1CF74D8A9EF2202ABC]
latest-mac.yml:[4B7B6EB75B9FCDB5412CAA0B5125FF40C0E30C8E6DAC3E33EBDCFE8DF7DF4BD6]
latest.yml:[07E79E58DC3EF128BD5A191B60E895E53A70EFA446E8C6863336AF9C0A2C5B87]
lokal-music_12.2.8_amd64.deb:[D978BB9F7B183F282E9E115BA24C0C830494B960230B1C57D7FC7CA1807B8C7B]
lokal-music_12.2.8_arm64.deb:[8B9F0F7EAB55B89AF9AD2418AC9DB547EAEB86EB883233B6359CC1E5BEE570E8]
