Repository navigation
Releases
Stashify v1.5.0
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. --m3uplaylist output. Writes an Extended M3U playlist (stashify.m3uin the output folder) of the downloaded files with relative paths, ready for VLC, foobar2000 or similar.--cookies-from-browser. Passchrome,chromium,edge,firefoxorbraveto 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" --m3uBahasa 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.m3udi folder output) dari file yang diunduh dengan path relatif, siap dipakai VLC, foobar2000 atau sejenisnya. --cookies-from-browser. Berikanchrome,chromium,edge,firefoxataubraveke 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" --m3uStashify v1.4.0
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-runandurlno longer fetch per-track details, cutting network traffic for large playlists. - Symmetric cover and lyrics flags.
--cover,--no-cover,--lyricsand--no-lyricswork as a pair, so the CLI can override the config in both directions.
Bug fixes
meta --no-cover/--no-lyricshonored. The command read the config file and ignored the flag, now the flag wins.urlgains--provider. The flag was missing from theurlcommand, now all metadata commands accept it.- Consistent shared flags.
--providerand--no-detailsmoved 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-rundanurltidak lagi mengambil detail per track, menghemat jaringan untuk playlist besar. - Flag cover dan lirik simetris.
--cover,--no-cover,--lyricsdan--no-lyricsbekerja sebagai pasangan, sehingga CLI bisa menimpa config di kedua arah.
Perbaikan bug
meta --no-cover/--no-lyricsdihormati. Sebelumnya command membaca config file dan mengabaikan flag, sekarang flag yang menang.urlmendapat--provider. Sebelumnya flag ini tidak ada di commandurl, sekarang semua command metadata menerimanya.- Flag bersama yang konsisten.
--providerdan--no-detailspindah 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
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 namestashifyalready belongs to someone else). Thestashifycommand and import name are unchanged;pip install stashify-cliis 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.yamlruns 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(namastashifymilik orang lain). Command dan nama importstashifytidak berubah;pip install stashify-cliadalah 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.yamlopsional 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
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.jsonstores 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.
--bitratenow rejects malformed values up front instead of feeding them to the converter. - Clear error for unwritable output. Writing
--save-fileto an unwritable path now reports a clear error instead of a raw OS traceback.
Improvements
- Parallel and ordered URL lookup.
stashify urlresolves 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.jsonmenyimpan 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.
--bitratesekarang menolak nilai yang salah sejak awal, bukan memberikannya ke converter. - Error jelas untuk output yang tidak bisa ditulis. Menulis
--save-fileke path yang tidak bisa ditulis sekarang melaporkan error yang jelas, bukan traceback OS mentah.
Peningkatan
- URL lookup paralel dan berurutan.
stashify urlme-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
English
Downloads now land in the operating system's Downloads folder, and large playlists download in parallel.
New features
- Parallel downloads.
--jobs Ndownloads 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 withaudioappended before giving up.
Improvements
- Downloads folder default. Output defaults to the OS downloads folder (
%USERPROFILE%\Downloadson Windows,~/DownloadsorXDG_DOWNLOAD_DIRon macOS and Linux), override with-o,output_dirorSTASHIFY_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 Nmengunduh 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 denganaudiodi belakang sebelum menyerah.
Peningkatan
- Default folder Downloads. Output default ke folder Downloads OS (
%USERPROFILE%\Downloadsdi Windows,~/DownloadsatauXDG_DOWNLOAD_DIRdi macOS dan Linux), ubah dengan-o,output_diratauSTASHIFY_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
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
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.jsonstate 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-runprints 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.mdpublished, 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-runmencetak source yang dipilih per track tanpa mengunduh apa pun. - Config file. Preferensi non-secret disimpan di
config.jsonper 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.mddipublikasikan, 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"