Synthwave

A self-hosted YouTube Music playlist downloader with a modern web interface, automated scheduling, and Docker support. Download and organize your music playlists with metadata, album artwork, and automatic M3U playlist generation.

Designed to work around Gonic (A Subsonic Compatible Music Streaming Server).

Main Dashboard - Configuration & Download Management

Playlist Management with Preview Cards

Real-time Download Progress & Logs

Integrated File Browser with Audio Playback

Automated Scheduling with Cron Jobs

git clone https://github.com/PranavVerma-droid/Synthwave.git
cd Synthwave/docker
cp .env.example .env

docker compose up -d

# OR, if you want, you can run the latest nightly build (latest commit):
# docker compose -f docker-compose-dev.yml up --build -d

# Then, Visit:
# http://your-server-url:5000

git clone https://github.com/PranavVerma-droid/Synthwave.git
cd Synthwave

# Dependencies:
sudo apt-get update && sudo apt-get install -y \
    ffmpeg \
    libavcodec-extra \
    libavformat-dev \
    libavutil-dev \
    libswscale-dev \
    libswresample-dev \
    libavfilter-dev \
    imagemagick \
    findutils \
    curl \
    nodejs \
    npm

pip install -r requirements.txt

# Then, Start the App:
python3 app.py

# Then visit:
# http://your-server-url:5000

1. Add Playlists: Paste YouTube playlist or album URLs in the web interface
2. Configure Settings: Adjust download paths, timeouts, and retry limits
3. Start Download: Click "Start Download" to begin processing
4. Schedule Downloads: Enable cron scheduling for automatic updates
5. Monitor Progress: Watch real-time progress and logs in the dashboard

• YouTube Playlists: https://www.youtube.com/playlist?list=...
• YouTube Albums: https://music.youtube.com/playlist?list=OLAK5uy_...

The application configuration is stored in config/config.yaml and can be edited through the web interface or directly in the file.

• The Config For this app is created in the config/config.yaml file AFTER the first run.
• You can edit the config via the web panel or just by editing the file.

• The Script will Do Two Passes of your links:
  • Albums: First Pass
  • Playlists: Second Pass
• It will download all albums to the BASE FOLDER of the Config, like this:

BASE_FOLDER/
      Album 1/
        Artist Name - Song Name - Youtube ID.mp3

• It will automatically embed the index, album / song cover, and artist name to the metadata of the file.
• Then, it moves on to playlists, in Pass 2.
• It will then scan the playlists one-by-one. If a song that is already in one of the albums, then it will NOT download it again. It will keep it in its internal queue.
• All songs that are NOT downloaded to any albums will be added to the "Unsorted Songs" album.
• After it is done downloading all, it will create a .m3u file inside the PLAYLIST_M3U_FOLDER folder from the Config.

PLAYLIST_M3U_FOLDER/
    YOUTUBE_PLAYLIST_ID.m3u

• There are also many edge cases that are accounted for, one example:
  • Lets say that there is a song inside the unsorted albums, and before the next run, I added the parent album which it belongs to. It will then MOVE the song from the unsorted album to its album, fix the container metadata, and eventually when it reaches the playlist, update the .m3u.

MIT License - see LICENSE for details.

Pranav Verma

• GitHub: @PranavVerma-droid