Repository navigation
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" --m3u