Skip to content

Stashify v1.5.0

Latest

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