Features: injects a download button into the YouTube player and SoundCloud pages, shows concurrent download progress and completion via extension notification popups, includes a CLI tool, and runs a server listening on port 5000 on your computer network that starts on system startup.
Commands (useful references):
- Download via CLI:
spotifytool "https://www.youtube.com/watch?v=VIDEO_ID"
- Check server health (replace localhost if checking from another machine on the network):
curl http://localhost:5000/health
Dependencies and setup scripts:
- Dependencies: Python 3.11+, yt-dlp, FFmpeg, scdl (SoundCloud), pipx (recommended)
- Setup scripts:
./setup_server.sh— installs the package (pipx) and creates/loads a launchd agent so the server runs on startup./setup_dev.sh— installs development dependencies (use for local development)