Skip to content

Stashify v1.0.0

Choose a tag to compare

@github-actions github-actions released this 13 Nov 00:07
· 12 commits to main since this release

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"