Lumen 0.2.0 — Streaming providers

Lumen 0.2.0 adds Sonora's streaming engines to the existing native player. Select Settings > Storage > Music providers, choose YouTube Music, and click Use guest playback to stream without waiting for a permanent download.

• YouTube Music guest playback and optional account sign-in.
• Deezer and Apple Music connections for accounts entitled to play the requested audio.
• Subsonic/Navidrome server connection and song import.
• Provider catalogue search and recording matching for imported Spotify songs.
• Existing saved files still play locally first. The separate download mode remains available for permanent offline files.
• Provider sign-in and browser attestation use a disposable helper process. Credentials remain local.
• Combined releases now use GPL-3.0-or-later. Original MIT and component notices are preserved. The matching source archive includes locked Rust dependency sources and offline build instructions.

Spotify streaming still requires Premium. Apple Music requires a compatible Widevine module, installed separately after reviewing and accepting its terms; the module is not bundled. These providers do not unlock subscriptions, and their streams are not exported as permanent downloads.

Validation: strict Windows/Linux lint checks and regular tests; live YouTube Music guest catalogue and muted audio-output checks on Windows; extracted corresponding-source dependencies resolve offline with an empty Cargo cache. Deezer/Apple Music/private-server playback still requires testing with authorized accounts.

Windows: use the setup installer. Linux Mint, Fedora, Arch and gaming desktops: use Flatpak; Ubuntu 24.04+ also supports the Debian package. Existing Lumen installations can use Settings > Updates.

Lumen 0.1.2 — Play while saving

Lumen 0.1.2 starts supported independent provider audio while it is still downloading, instead of waiting for the whole song.

• Direct MP3 and unencrypted segmented AAC start after a small audio buffer. The rest is saved permanently for later offline playback.
• Pause/resume works with the buffered prefix. Seeking becomes available once the complete validated file is saved.
• Changing songs cancels unfinished transfers so the new song is not queued behind the previous download. Completed songs stay saved.
• Stop, pause, rapid playback changes and shutdown interrupt stalled audio reads cleanly. Cancelled/stale playback commands do not stop a newer song.
• Existing saved files, library sign-in, lyrics and the main GUI remain in place.

Update from Settings > Updates > Check for updates, then choose Install update. Windows users can also run lumen-0.1.2-windows-x86_64-setup.exe. Linux downloads include Flatpak, Debian and a portable archive. Version 0.1.0 needs a manual installer upgrade because it predates the updater.

Provider lookup and human verification can still delay startup. Sources that cannot be decoded progressively, and public-source matching without the service connection, use the complete-file fallback. The streaming path needs FFmpeg, as does permanent MP3 saving. This release does not grant Spotify Premium streaming: use Continue with Spotify for library sign-in and independent playback; the Premium option is separate. Development-mode accounts still need to be added under User Management in the app owner's Spotify developer dashboard.

Validation includes Windows/Linux formatting, strict Clippy and unit tests; a synthetic FFmpeg test verifies audible samples from both direct MP3 and fragmented AAC while half the input is deliberately withheld, plus resume from the buffered prefix. Linux CI also checks conversion, WebKit, release startup and Flatpak runtime dependencies. These checks do not verify every live provider response, a physical audio device or CAPTCHA acceptance.

SHA256SUMS.txt covers all five app downloads.

Lumen 0.1.1 — Account sign-in, playback fix and updates

Lumen 0.1.1 adds Spotify library sign-in, verified update downloads, and a fix for provider links returning segmented HLS audio instead of a direct music file.

Getting started

1. Windows: install lumen-0.1.1-windows-x86_64-setup.exe, then open Lumen from the Start menu. Linux: install the Flatpak or Ubuntu 24.04+ Debian package.
2. Choose Continue with Spotify, sign in in your browser, and approve read-only library access. Lumen imports accessible playlists and Liked Songs, while keeping playback independent of a Spotify streaming session.
3. Choose a song. If the configured download provider needs human verification, Lumen opens its verification panel. Completed downloads stay on your device for offline playback. Provider availability is not guaranteed.

The app includes Lumen's public Client ID and uses PKCE, with no client secret. Spotify development mode requires the app owner to have Premium and accounts to be added in the app dashboard's User Management (up to five users). Spotify may restrict free-account or endpoint access; this release does not promise unrestricted account sync. Owned/collaborative playlists are supported where permitted. Restricted playlists are reported, and public links or account JSON exports remain import options. Use Spotify Premium streaming is a separate sign-in option.

Updates

Lumen checks GitHub at startup and every six hours, downloads the matching stable-release installer, and verifies its size and SHA-256 checksum. Select Install update to open the normal system installer. Windows uses a per-user install and Start menu shortcut; portable Linux archives need extraction. Disable automatic checks/downloads in Settings > Updates if desired. Downloaded installers are reused and reverified before installation.

Existing 0.1.0 installations need this one manual upgrade to get the updater. Their settings and completed music downloads remain in the existing user folders.

Validation

Formatting, strict Clippy and automated tests run on Windows and Linux, with Linux audio conversion, WebKit and release startup fixtures. The app owner confirmed that a new Free account could sign in after its email was added under User Management. Playback remains provider-dependent; the reported HLS response failure is covered by a new synthetic segmented AAC conversion test. Physical Linux audio devices, individual Wayland desktops and live CAPTCHA acceptance are not covered by the synthetic checks.

SHA256SUMS.txt covers all five app downloads.

Lumen 0.1.0 — Windows and Linux

Lumen 0.1.0 is a native Rust music player for Windows and Linux.

• Native desktop UI with playlists, queue controls, themes and lyrics where available.
• Local/offline audio and personal Spotify playlist JSON imports without a streaming login.
• Independent download-first playback through the configured download provider.
• Attended verification: Windows WebView2 panel or an isolated Linux WebKitGTK window.

Downloads

• Windows: run lumen-windows-x86_64.exe. New downloads require FFmpeg on PATH; verification requires Microsoft Edge WebView2 Runtime.
• Linux Mint, Fedora, Arch and gaming desktops (x86_64): install the .flatpak file with flatpak install --user ./lumen-0.1.0-linux-x86_64.flatpak, then flatpak run io.github.zaydzaari.Lumen. The first install downloads the shared GNOME runtime, including WebKitGTK and FFmpeg. This edition omits the optional tray icon.
• Ubuntu 24.04+ x86_64: sudo apt install ./lumen_0.1.0_amd64.deb.
• Linux tarball: extract it, then run ./lumen/install.sh or launch the included executable. System GTK/WebKitGTK/audio libraries and FFmpeg are required; this is not a universal static build.

Spotify streaming and Spotify Connect require Premium. Independent mode does not provide live private-account sync or full online catalogue search. Provider coverage and live CAPTCHA/browser acceptance are not guaranteed; the manual token option remains available. No account tokens, personal library data or downloaded music are included.

See the repository README for supported workflows, Linux dependencies, troubleshooting and third-party licences.

Validation

Windows and Linux pass formatting, strict Clippy and automated tests. Linux additionally passes synthetic AAC-to-MP3 conversion, the actual WebKit fixture, native release startup and Flatpak startup in a clean unprivileged X11 test session. Physical audio-device playback, Wayland desktops and live provider CAPTCHA acceptance have not been checked on individual distributions.

SHA256SUMS.txt contains the checksums for the four app downloads.