Wanted & Downloads
Track what you want and monitor download progress.
The Wanted page gives you an overview of everything you've marked for download and the status of active download jobs.
Wanted Statuses
Each track in your library has one of these statuses:
| Status | Meaning |
|---|---|
| Unmonitored | Track exists in the database but is not tracked for download |
| Wanted | Track is marked for download — yoink will attempt to acquire it |
| In Progress | Download is currently active |
| Acquired | Track has been downloaded and tagged |
Download Jobs
Download jobs progress through these stages: queued → resolving (finding the best source) → downloading → completed or failed.
How the Download Worker Works
yoink runs a background download worker that:
- Polls for queued download jobs
- Resolves playback info from the best available download source (Tidal or SoulSeek)
- Downloads the audio file
- Tags it with metadata (title, artist, album, cover art, lyrics if enabled)
- Moves the tagged file to
MUSIC_ROOT
Library reconciliation runs periodically to sync the filesystem state with the database, ensuring the UI reflects what's actually on disk.