Self-host yoink
v3.1.0Music link downloader with lossless audio and full metadata
- Stars
- 151
- Port
- 3000 (HTTP web interface)
ghcr.io/yoinkify/yoink
What is yoink?
yoink is a self-hosted music downloader that accepts Spotify, Apple Music, or YouTube links and produces audio files with complete metadata. It handles tracks, playlists, albums, and artists, outputting lossless FLAC or ALAC plus 320 kbps MP3 with ID3 tags, cover art, synchronized lyrics, genre, track numbers, and explicit flags. The app fetches audio from multiple sources — Deezer, Tidal, and YouTube — trying each in order until one works, while metadata comes from Spotify with Deezer and iTunes as backups. No user accounts or data storage are required. It runs as a Next.js 16 application with Tailwind CSS 4, using ffmpeg for conversion and tagging. Self-hosting uses Docker with prebuilt container images for amd64 and arm64 architectures, plus a provided docker-compose.release.yml file. All environment variables are optional — it functions immediately with YouTube via yt-dlp and public APIs. Optional credentials for Spotify, Deezer, and Tidal enable lossless audio and better reliability. The project is licensed under AGPL-3.0. The previously hosted live instance is currently unavailable due to hosting costs.
Should you self-host yoink?
yoink scores 45/100 on selfhost.directory (how scoring works) and ranks #32 of 59 in Music Streaming. It has 151 GitHub stars.
It shipped 2 stable releases in the past year. The latest, v3.1.0, came out on 12 September 2026. New versions land roughly every 5 months.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is koel (75/100, 17 320 stars). It scores higher overall, so compare the two before you pick. See yoink vs koel side by side.
Features
- Apple Music catalog matching
- Cross-platform link resolution
- Diagnostic log retention
- Feedback tracking
- Full metadata tagging
- Lossless Audio
- Metadata fallback chain
- Multi-source audio pipeline
- Music download from links
- No Accounts Required
- Rate LimitingSelf-hosted instances have no rate limits by default
- Search by song name
- Source throttling
yoink README
More in Music Streaming
YuE-GPYuEGP is a self-hosted tool for generating full songs from lyrics using YuE models, optimized for consumer GPUs with 10+ GB VRAM.
airsonic-advancedSelf-hosted, open-source web media streamer forked from Airsonic: faster scanning, websocket UI updates, Sonos, Chromecast and ListenBrainz support.
airstationRun your own internet radio station with a web control panel and listener player. Streams via HLS, stores data in SQLite, processes audio with FFmpeg.
AirwaveAirwave is a self-hosted, open-source shared radio creating a synchronized MP3 stream from YouTube, SoundCloud, Mixcloud, Spotify, and local files for browsers and Sonos.
ampdSelf-hosted web client for MPD with themes, cover art, scrobbling, and keyboard shortcuts built in today.
asknavidromeAskNavidrome is an open-source Alexa skill that streams your music from a Subsonic server like Navidrome to Amazon Echo devices, without subscription fees or ads.
auddly-serverAuddly is an open-source, self-hosted music streaming server with a REST API for your personal library, playlists, Last.fm scrobbling, and Spotify artist images.
AudioMuse-AIOpen-source, self-hosted sonic-analysis tool that builds playlists, a 2D music map and semantic search for Navidrome, Jellyfin, Emby, Plex, LMS and Lyrion libraries.
aurralOpen-source self-hosted music discovery with personalized recommendations, rotating playlist flows, and library management. Works standalone or with Lidarr.
Black CandySelf-hosted, open-source music streaming server you run in a single Docker container, with SQLite by default, optional PostgreSQL, and native iOS and Android apps.
cicadaCicada is a self-hosted, open-source multi-user music streaming service with PWA, 2FA, lyrics, and music sharing. Runs as a single binary or via Docker.
cloudtunesOpen-source, self-hosted web music player that unifies your Dropbox files and YouTube videos, with playlists, Last.fm scrobbling and MusicBrainz metadata.
0 comments