v1.4.1

1.4.1 (2026-10-07)

Added

• GrilledCheese downloads are available through the provider selection and download flow.

Fixed

• Amazon downloads retry the available regional servers when the requested region fails.
• Qobuz and Amazon use Lucida's current provider regions.
• A failed track-number metadata write preserves the original downloaded file.
• Downloaded tracks carrying a composite embedded track number (6/12) now have it
  rewritten to the bare number (6) after placement, so players and devices show a
  clean position. Already-bare numbers are left untouched.

lucidadl 1.4.0

What's new

• Import public playlists from YouTube and YouTube Music, Amazon Music, TIDAL, SoundCloud, and Qobuz.
• Use the same preview, match-checking, correction, ordered download, and resume flow across all eight supported services.
• Load complete long playlists beyond the public Spotify and TIDAL preview windows.
• Verify declared playlist sizes so incomplete public data stops with a clear error.
• Updated command help, interactive guidance, and README examples.

Upgrade

With pipx: pipx upgrade lucidadl

With pip: pip install --upgrade lucidadl

lucidadl 1.3.1

What's fixed

• Spotify playlists longer than 100 items now switch automatically to the complete public web view.
• The list is scrolled in the background until every playlist position has been read.
• Short Spotify playlists keep the faster direct import path.
• Ordered tracks and intentional duplicates remain preserved.

Upgrade

pip install --upgrade lucidadl

lucidadl 1.3.0

What's new

• Import public Spotify and Deezer playlists through the same flow as Apple Music.
• Preview, check, edit, download, and resume playlists while preserving their order and duplicates.
• Stop explicitly when a Spotify playlist is known to exceed the public 100-item window.
• Reject more alternate versions and secondary-artist covers during automatic matching.
• Use one clearer streaming-playlist entry point in the CLI and interactive menu.

Upgrade

pip install --upgrade lucidadl

lucidadl 1.2.0

Highlights

• Apple Music playlist imports now survive interruptions and retain their folder, settings, source order, and track numbers when resumed with lucida retry.
• lucida playlist URL --check previews the Qobuz/Amazon match selected for every title before downloading.
• lucida playlist-file FILE --name "My playlist" downloads an edited or reviewed text list as an ordered playlist with a portable .m3u8 file.
• Apple extraction is more resilient to page changes, preserves repeated songs at distinct positions, and gives clearer diagnostics for unavailable playlists.
• Downloads now use bounded retries for temporary service failures and reject incomplete response bodies.
• The TUI now presents playlist actions explicitly; lucida doctor checks the music destination and recovery state, while lucida cleanup removes stale state and old partial files.

See the changelog for the full details.

lucidadl v1.1.0

lucidadl 1.1.0 focuses the project around a small, reliable terminal experience.

Highlights:

• guided first-run setup and a clearer interactive menu
• explicit batch downloads from any .txt file
• safer automatic matching and typed retry of tracks and albums
• reliable exit statuses and clearer download summaries
• Apple Music playlist import validated against a 48-track public playlist
• portable .m3u8 playlist files
• streamlined Apple-only playlist scope
• rewritten README and modernized package metadata

Validated on Windows and Linux with Python 3.10, 3.11, and 3.12.

lucidadl v1.0.0

First stable release 🎉 — feature-complete and validated end to end.

A fast, parallel CLI (+ interactive TUI) for downloading music via lucida.to: tracks, albums and playlists from Qobuz and Amazon Music in lossless FLAC (or transcoded to MP3/AAC/Opus), organized into Artists/<Artist>/<Album>/.

• Parallel downloads over HTTP (no browser kept open), existence-aware dedup, service fallback, retry.
• Apple Music playlist import (numbered, in order), interactive menu (lucida ui) with live progress bars.
• Robust resolution (finds niche / multi-artist tracks), clean filenames.

Install: pipx install lucidadl · or pip install lucidadl

See the README and CHANGELOG.

lucidadl v0.1.1

Added

• Playlist tracks are numbered (NN - Title) so they keep the playlist order.

Changed

• Filenames drop the redundant artist prefix (Title.ext) — tracks are already in Artists/<Artist>/<Album>/.
• Cleaner playlist output (a table for --dry-run, a header + progress bars for a download).

Fixed

• Find niche / multi-artist tracks: when the literal "Artist - Title" query returns nothing, retry with the title alone (and primary-artist + title), verifying the artist so a broadened search can't grab the wrong song.
• Playlist dedup scoped to the playlist folder: a track already in Artists/ is still fetched into a playlist that's missing it, with no duplicate re-downloads.

Install: pipx install git+https://github.com/Jude-A/lucidadl (PyPI coming).

Full diff: v0.1.0...v0.1.1

lucidadl v0.1.0

First public release.

Highlights

• Fast parallel downloads over HTTP — no browser kept open; Cloudflare is solved once and the cookie is cached.
• Search or URL for tracks/albums; albums download track-by-track in parallel; automatic Qobuz → Amazon fallback.
• Local ffmpeg transcoding (--to, --bitrate) — bundled; tags + cover art preserved.
• Tag-based organization into Artists/<Artist>/<Album>/ (with an API-metadata fallback), playlists under Playlists/<name>/.
• Playlist import (Apple Music today), interactive menu (lucida ui) with live progress bars.
• Watchlists with existence-aware dedup, --force, retry, and a fixed configurable music folder (lucida config).

See the README and CHANGELOG.

Already using jelni's lucida-downloader (its binary is also lucida)? Use the lucidadl alias.