maleszka/librespot-dl
Watch
1
0
Fork
You've already forked librespot-dl
 0
Code Issues 8 Pull requests Projects Releases 1 Packages Wiki Activity Actions
1 release 1 tag
  • v0.1.0 0cb577b9a7

    v0.1.0 Stable

    maleszka released this 2026-07-06 23:02:19 +02:00 | 91 commits to main since this release

    librespot-dl v0.1.0 — Initial Release

    A fast, keyboard-driven CLI for downloading your Spotify library — fully tagged, correctly organized, and ready to play.

    Important

    Requires an active Spotify Premium subscription. Use is subject to Spotify's Terms of Service. librespot-dl does not circumvent Spotify's DRM or access controls — it only uses the streaming API surface librespot itself exposes.

    ✨ Highlights

    • 🎧 Real audio, real tags — fully-tagged OGG Vorbis downloads with per-album cover art embedded automatically.
    • ⌨️ Vim-style interactive queue manager — navigate, reorder, promote, and remove queued tracks live while downloads run.
    • 🤖 Script mode — librespot-dl -o <dir> <spotify-url> for cron jobs and automation, with clean exit codes and an optional --json summary.
    • 📁 Configurable layout — token-based album/track path templates, validated up front so a bad template never wastes a download.
    • ⏸️ Resumable downloads — checksum-verified partial-download records survive crashes and unclean shutdowns.
    • 🐢 Speed-capped downloading — throttle to a multiple of real-time playback speed instead of hammering the CDN.
    • 🔒 Collection locking — an advisory lock keeps two instances from stepping on the same collection directory.

    ⚠️ Known Issues

    • FLAC output is not yet implemented. Setting output_format: flac in collection.yml is accepted but downloads will fail with an "unsupported" error until encoding support lands.
    • cargo audit reports two HIGH-severity advisories (RUSTSEC-2026-0194, RUSTSEC-2026-0195 in quick-xml) and one MEDIUM-severity advisory (RUSTSEC-2023-0071 in rsa), all transitive and pinned by librespot-core 0.8.0. No compatible fixed version is currently resolvable without an upstream librespot-core release.

    📦 Installation

    git clone <this-repository>
cd librespot-dl
cargo install --path .

    Or just install librespot-dl binary from this release to your PATH!

    See the README for authentication setup, usage, and configuration.

    Full Changelog: see CHANGELOG.md

    Downloads