Skip to content

Releases

Stashify v1.5.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 21:01
d67dfb2

English

Downloads are verified after the fact, SoundCloud backs up YouTube, and downloads can drop straight into a playlist file.

New features

  • SoundCloud fallback. When YouTube yields nothing acceptable (blocked, age-restricted, geo-locked), SoundCloud is tried next with a strict 15-second duration cap so 30-second previews are never saved as tracks.
  • ffprobe integrity verification. Every downloaded file is probed before tagging; corrupt files are deleted and reported at the end, suspicious durations (for example a 10-hour loop mis-matched as the song) are flagged in the line output. Disable with --no-verify.
  • --m3u playlist output. Writes an Extended M3U playlist (stashify.m3u in the output folder) of the downloaded files with relative paths, ready for VLC, foobar2000 or similar.
  • --cookies-from-browser. Pass chrome, chromium, edge, firefox or brave to yt-dlp when YouTube requires a browser session.

Bug fixes

  • Console output encoding. Stdout and stderr are switched to UTF-8 (with replacement) so non-Latin titles print instead of crashing a cp1252 console.
  • Overly permissive matcher. YouTube candidates with duration off by more than 120 seconds are now rejected in favor of the SoundCloud fallback, instead of being saved as-is.
  • Verifier failures no longer delete files. If ffprobe is missing or times out, the download is kept and reported as "could not verify"; only confirmed-corrupt files are deleted and reported as failed.

Usage

pip install --upgrade stashify-cli
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID" --m3u



Bahasa Indonesia

Unduhan diverifikasi setelah selesai, SoundCloud menjadi backup YouTube, dan unduhan bisa langsung masuk ke file playlist.

Fitur baru

  • Fallback ke SoundCloud. Saat YouTube tidak memberikan apa pun yang layak (diblokir, age-restricted, geo-locked), SoundCloud dicoba berikutnya dengan batas selisih durasi 15 detik yang ketat, sehingga preview 30 detik tidak pernah tersimpan sebagai track.
  • Verifikasi integritas ffprobe. Setiap file yang diunduh diperiksa sebelum ditag; file rusak dihapus dan dilaporkan di akhir, durasi mencurigakan (misalnya loop 10 jam yang tercocok sebagai lagu) ditandai pada baris output. Nonaktifkan dengan --no-verify.
  • Output playlist --m3u. Menulis Extended M3U playlist (stashify.m3u di folder output) dari file yang diunduh dengan path relatif, siap dipakai VLC, foobar2000 atau sejenisnya.
  • --cookies-from-browser. Berikan chrome, chromium, edge, firefox atau brave ke yt-dlp saat YouTube mewajibkan sesi browser.

Perbaikan bug

  • Encoding output console. Stdout dan stderr dialihkan ke UTF-8 (dengan replacement) agar judul non-Latin tercetak, bukan crash di console cp1252.
  • Matcher terlalu longgar. Kandidat YouTube dengan selisih durasi lebih dari 120 detik sekarang ditolak dan beralih ke fallback SoundCloud, bukan disimpan apa adanya.
  • Verifikasi yang gagal tidak menghapus file. Jika ffprobe tidak ada atau timeout, unduhan tetap disimpan dan dilaporkan sebagai "could not verify"; hanya file yang benar-benar corrupt yang dihapus dan dilaporkan sebagai gagal.

Penggunaan

pip install --upgrade stashify-cli
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID" --m3u

Stashify v1.4.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 21:31
ff7a0af

English

Stashify gets a built-in health check, faster dry runs and more reliable lyrics.

New features

  • stashify doctor. Checks Python, FFmpeg, downloads folder, Spotify embed pages, YouTube search and the lyrics API, and prints a pass/fail report. Use it when a download fails and you want to know which part of the stack is broken.

Improvements

  • Lyrics from lrclib.net. Better matching using artist, title, album and duration, with lyrics.ovh as fallback. Instrumental tracks get no lyrics instead of mis-matched ones.
  • Skip detail lookups when not needed. --dry-run and url no longer fetch per-track details, cutting network traffic for large playlists.
  • Symmetric cover and lyrics flags. --cover, --no-cover, --lyrics and --no-lyrics work as a pair, so the CLI can override the config in both directions.

Bug fixes

  • meta --no-cover / --no-lyrics honored. The command read the config file and ignored the flag, now the flag wins.
  • url gains --provider. The flag was missing from the url command, now all metadata commands accept it.
  • Consistent shared flags. --provider and --no-details moved to one shared parser so every metadata command offers them.

Usage

pip install --upgrade stashify-cli
stashify doctor
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Stashify sekarang punya health check bawaan, dry run lebih cepat, dan lirik yang lebih andal.

Fitur baru

  • stashify doctor. Memeriksa Python, FFmpeg, folder Downloads, embed pages Spotify, pencarian YouTube dan lyrics API, lalu mencetak laporan pass/fail. Gunakan saat unduhan gagal dan kamu ingin tahu bagian stack mana yang rusak.

Peningkatan

  • Lirik dari lrclib.net. Matching lebih akurat dengan artist, title, album dan durasi, dengan lyrics.ovh sebagai fallback. Track instrumental tidak diberi lirik nyasar.
  • Lewati detail lookup saat tidak dibutuhkan. --dry-run dan url tidak lagi mengambil detail per track, menghemat jaringan untuk playlist besar.
  • Flag cover dan lirik simetris. --cover, --no-cover, --lyrics dan --no-lyrics bekerja sebagai pasangan, sehingga CLI bisa menimpa config di kedua arah.

Perbaikan bug

  • meta --no-cover / --no-lyrics dihormati. Sebelumnya command membaca config file dan mengabaikan flag, sekarang flag yang menang.
  • url mendapat --provider. Sebelumnya flag ini tidak ada di command url, sekarang semua command metadata menerimanya.
  • Flag bersama yang konsisten. --provider dan --no-details pindah ke satu parser bersama sehingga semua command metadata menawarkannya.

Penggunaan

pip install --upgrade stashify-cli
stashify doctor
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Stashify v1.3.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 17:36
1931cb2

English

Stashify now ships as a properly packaged PyPI distribution, ready to publish with a trusted publisher.

New features

  • PyPI packaging. Stashify is distributed on PyPI as stashify-cli (the name stashify already belongs to someone else). The stashify command and import name are unchanged; pip install stashify-cli is the new recommended install.

Improvements

  • Trusted publishing. A manual publish workflow builds the wheel and sdist, checks them with twine check, smoke tests the wheel and publishes over OIDC without any stored API token.
  • Complete metadata. Project URLs, SPDX license expression, license file and classifiers set; PyPI now renders the full README.
  • Pre-commit hook. Optional .pre-commit-config.yaml runs ruff and gitleaks before each commit.

Usage

Until the first PyPI publish (one-time maintainer setup, then run Publish from the Actions tab on the tag):

pip install git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

After the package is live on PyPI:

pip install stashify-cli
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Stashify sekarang dikemas sebagai distribusi PyPI yang rapi, siap diterbitkan dengan trusted publisher.

Fitur baru

  • PyPI packaging. Stashify didistribusikan di PyPI sebagai stashify-cli (nama stashify milik orang lain). Command dan nama import stashify tidak berubah; pip install stashify-cli adalah cara install yang direkomendasikan.

Peningkatan

  • Trusted publishing. Workflow publish manual membangun wheel dan sdist, memeriksanya dengan twine check, smoke test wheel, dan menerbitkan lewat OIDC tanpa token API yang tersimpan.
  • Metadata lengkap. Project URLs, ekspresi lisensi SPDX, license file dan classifiers diatur; PyPI sekarang merender README sepenuhnya.
  • Pre-commit hook. .pre-commit-config.yaml opsional menjalankan ruff dan gitleaks sebelum setiap commit.

Penggunaan

Sampai publish PyPI pertama (setup maintainer satu kali, lalu jalankan Publish dari tab Actions pada tag):

pip install git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Setelah paket masuk ke PyPI:

pip install stashify-cli
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Stashify v1.2.1

Choose a tag to compare

@github-actions github-actions released this 13 Nov 15:05

English

Internal audit: every entry point re-checked, real end-to-end downloads verified, security pass re-run.

Bug fixes

  • Sync state portability. stashify.sync.json stores forward slashes, and older files with OS backslashes are read correctly, so deletes never silently fail after a folder is moved between OSes.
  • Bitrate validation. --bitrate now rejects malformed values up front instead of feeding them to the converter.
  • Clear error for unwritable output. Writing --save-file to an unwritable path now reports a clear error instead of a raw OS traceback.

Improvements

  • Parallel and ordered URL lookup. stashify url resolves tracks in parallel and keeps the input order.
  • Deeper JSON hardening. RecursionError from deeply nested embed pages produces a clear error, and WAV tagging is covered by a round trip test.

Usage

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Audit internal: setiap entry point diperiksa ulang, unduhan end-to-end nyata diverifikasi, security pass dijalankan lagi.

Perbaikan bug

  • Portabilitas sync state. stashify.sync.json menyimpan forward slash, dan file lama dengan backslash OS dibaca dengan benar, sehingga delete tidak pernah gagal diam-diam saat folder dipindah antar OS.
  • Validasi bitrate. --bitrate sekarang menolak nilai yang salah sejak awal, bukan memberikannya ke converter.
  • Error jelas untuk output yang tidak bisa ditulis. Menulis --save-file ke path yang tidak bisa ditulis sekarang melaporkan error yang jelas, bukan traceback OS mentah.

Peningkatan

  • URL lookup paralel dan berurutan. stashify url me-resolve track secara paralel dan menjaga urutan input.
  • Penguatan JSON lebih dalam. RecursionError dari halaman embed yang sangat dalam menghasilkan error yang jelas, dan tagging WAV dibuktikan dengan round trip test.

Penggunaan

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Stashify v1.2.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 01:56

English

Downloads now land in the operating system's Downloads folder, and large playlists download in parallel.

New features

  • Parallel downloads. --jobs N downloads up to 8 tracks at once, default 2, results are written in input order and duplicate target names never clobber each other.
  • Fallback search. If YouTube returns nothing for artist - title, Stashify retries without the dash and with audio appended before giving up.

Improvements

  • Downloads folder default. Output defaults to the OS downloads folder (%USERPROFILE%\Downloads on Windows, ~/Downloads or XDG_DOWNLOAD_DIR on macOS and Linux), override with -o, output_dir or STASHIFY_DOWNLOAD_DIR.
  • Output location printed. Every run prints Saving to: so the destination is always visible.
  • Parallel metadata. Per-track detail lookups and metadata enrichment run four at a time.

Usage

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Unduhan sekarang mendarat di folder Downloads milik OS, dan playlist besar diunduh secara paralel.

Fitur baru

  • Download paralel. --jobs N mengunduh hingga 8 track sekaligus, default 2, hasil ditulis mengikuti urutan input dan nama target yang sama tidak pernah menimpa satu sama lain.
  • Fallback search. Jika YouTube tidak mengembalikan apa pun untuk artist - title, Stashify mencoba lagi tanpa strip dan dengan audio di belakang sebelum menyerah.

Peningkatan

  • Default folder Downloads. Output default ke folder Downloads OS (%USERPROFILE%\Downloads di Windows, ~/Downloads atau XDG_DOWNLOAD_DIR di macOS dan Linux), ubah dengan -o, output_dir atau STASHIFY_DOWNLOAD_DIR.
  • Lokasi output dicetak. Setiap run mencetak Saving to: agar tujuan selalu terlihat.
  • Metadata paralel. Lookup detail per track dan enrichment metadata berjalan empat sekaligus.

Penggunaan

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Stashify v1.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 01:09

English

Stashify works out of the box with any Spotify account: metadata now comes from Spotify's public pages, no developer app or Premium needed.

New features

  • Embed provider. Metadata is read from Spotify's public embed pages, so tracks, albums, artist top tracks and public playlists resolve without an account, login or API key.
  • Per-track enrichment. Artists, release year and cover art are resolved per track for playlists, disable with --no-details.

Improvements

  • Public-page diagnostics. Private or removed links now produce a clear message instead of a silent failure.
  • Official API updated. February 2026 Web API changes are applied: playlists and artist top tracks are rejected with guidance on --provider api (tracks and albums still work there), and 403 responses now include the server's message.

Usage

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Stashify langsung berfungsi dengan akun Spotify apa pun: metadata sekarang diambil dari halaman publik Spotify, tanpa developer app atau Premium.

Fitur baru

  • Embed provider. Metadata dibaca dari public embed pages Spotify, sehingga track, album, artist top tracks dan playlist publik di-resolve tanpa akun, login atau API key.
  • Per-track enrichment. Artists, tahun rilis dan cover art di-resolve per track untuk playlist, nonaktifkan dengan --no-details.

Peningkatan

  • Public-page diagnostics. Link privat atau yang dihapus sekarang menghasilkan pesan yang jelas, bukan kegagalan diam.
  • Official API updated. Perubahan Web API Februari 2026 diterapkan: playlist dan artist top tracks ditolak dengan panduan di --provider api (tracks dan album tetap berfungsi di sana), dan respons 403 sekarang menyertakan pesan dari server.

Penggunaan

pip install --upgrade git+https://github.com/nekonaru/stashify.git
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"

Stashify v1.0.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 00:07

English

Stashify resolves any Spotify link to a properly tagged audio file on your machine, sourced from YouTube.

New features

  • Download command. Track, album, playlist and artist links download to local files as MP3, M4A, Opus, FLAC or WAV, with cover art, lyrics, album, track number, release year and ISRC written into the tags.
  • Best-match source. YouTube candidates are scored on duration and word overlap, low-scoring matches are rejected instead of downloaded.
  • Save command. Dump the resolved metadata for a link as JSON without downloading audio.
  • URL command. Print the matched source URL per track for inspection.
  • Meta command. Retag existing audio files with the metadata from a Spotify link, in file order.
  • Sync command. Keep a folder in sync with a playlist through a stashify.sync.json state file, new tracks are downloaded and removed tracks are deleted, everything else is untouched.
  • Path templates. Output names come from a template with {artist}, {title} and friends, subfolders included, illegal characters removed automatically.
  • Dry run. --dry-run prints the matched source per track without downloading anything.
  • Config file. Non-secret preferences live in a per-user config.json, command line flags always win.

Improvements

  • Safe file naming. Template segments are sanitized for every supported OS and collisions are handled predictably.
  • Security policy. SECURITY.md published, with credentials read from the environment only.
  • CI. Ruff and the test suite run on Python 3.10 and 3.12 on every push and pull request.

Usage

pip install git+https://github.com/nekonaru/stashify.git
export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"



Bahasa Indonesia

Stashify me-resolve link Spotify apa pun menjadi audio file dengan tag metadata lengkap di mesin kamu, diambil dari YouTube.

Fitur baru

  • Download command. Link track, album, playlist dan artist diunduh ke file lokal sebagai MP3, M4A, Opus, FLAC atau WAV, dengan cover art, lirik, album, nomor track, tahun rilis dan ISRC tertulis di tag.
  • Best-match source. Kandidat YouTube dinilai dari kecocokan durasi dan kata, match dengan skor rendah ditolak, bukan diunduh.
  • Save command. Dump metadata hasil resolve dari sebuah link sebagai JSON tanpa mengunduh audio.
  • URL command. Cetak source URL yang dipilih per track untuk inspeksi.
  • Meta command. Retag file audio yang sudah ada dengan metadata dari link Spotify, sesuai urutan file.
  • Sync command. Jaga folder tetap sinkron dengan playlist lewat state file stashify.sync.json, track baru diunduh dan track yang hilang dihapus, sisanya tidak disentuh.
  • Path templates. Nama output diambil dari template dengan {artist}, {title} dan kawan-kawan, termasuk subfolder, karakter ilegal dihapus otomatis.
  • Dry run. --dry-run mencetak source yang dipilih per track tanpa mengunduh apa pun.
  • Config file. Preferensi non-secret disimpan di config.json per user, flag command line selalu lebih diutamakan.

Peningkatan

  • Safe file naming. Segment template disanitasi untuk semua OS dan collision ditangani secara prediktif.
  • Security policy. SECURITY.md dipublikasikan, dengan credential hanya dibaca dari environment.
  • CI. Ruff dan pytest suite berjalan di Python 3.10 dan 3.12 di setiap push dan pull request.

Penggunaan

pip install git+https://github.com/nekonaru/stashify.git
export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
stashify download "https://open.spotify.com/playlist/PLAYLIST_ID"