Synthwave

- ** Intelligent download management **: Support YouTube playlist and album batch download, automatic deduplication, avoid repeated downloads - ** Complete metadata support **: Automatically embed complete metadata such as artist information, album cover, track number, etc. - ** Automatic scheduling **: Built-in Cron timed tasks, support automatic update of playlists, keep music libraries up to date - ** M3U playlist generation **: Automatically generate standard M3U playlist files, compatible with music servers such as Gonic - ** Real-time progress monitoring **: WebSocket pushes download progress and logs in real time to keep track of download status at any time - ** File browser **: Built-in file manager that supports online preview and playback of downloaded music - ** Smart Classification **: Automatically classifies music files by album, and unclassified songs are classified as "Unsorted Songs" - ** Advanced configuration **: Support advanced parameter configuration such as timeout settings, retry times, and concurrency limits - **Cookie support **: Support the import of YouTube cookies and access to member-specific content Note: Need Piggy Page or Kitty to cooperate with this ### Step 1: Access the application Click the app to open, or open the web page ### Step 2: Basic configuration It is recommended to configure the following parameters for the first time: 1. ** Music storage path **: The default is `/music`, no modification is required 2. ** Playlist path **: Default to `/playlists`, no modification is required 3. ** Timeout settings **: - Metadata acquisition timeout: 1200 seconds recommended - Download timeout: 3600 seconds recommended 4. ** Number of retries **: 5 times recommended ### Step 3: Add a playlist 1. Open YouTube Music and find the playlist or album you want to download 2. Copy the playlist link in the following format: - Playlist: `www.youtube.com/playlist? list= PLRBp0Fe 2GpgmsW46rJyudVFly6IYjFBIK`(non-copyrighted music, testable) - Album: `music.youtube.com/playlist? list=OLAK5uy_xxxxxx` 3. In the Synthwave interface, paste the link into the "Add Playlist" input box 4. Click the "Add" button ### Step 4: Start downloading 1. Verify that all playlists that need to be downloaded have been added 2. Click the "Start Download" button 3. View real-time progress and logs on the Download Progress tab ** Download process instructions **: - ** Scan for the first time **: Download all albums (link with `OLAK5uy_` logo) - ** Second scan **: Download songs from the playlist - If the song already exists in an album, skip the download and quote it directly - If the song does not belong to any album, download it to the Unsorted Songs folder - ** Generate playlists **: Generate a `.m3u` file for each playlist ### Step 5: Configure scheduled tasks (optional) If you want to update playlists automatically, you can enable scheduled tasks: 1. On the Automation tab, enable the Scheduled Tasks switch 2. Configure Cron expressions, such as: - Executed at 2 a.m. every day: `0 2 * *` - Executed at 3 a.m. every Sunday: `0 3 * * 0` 3. Click "Save Configuration" Scheduled tasks automatically check for playlist updates and download new songs. ### Step 6: Browse and play files In the File Browser tab, you can: - Browse downloaded music files - Preview and play music online - View file metadata information --- ##Advanced Features ### Cookie Configuration If you need to download member-specific content or private playlists, you can configure YouTube cookies: 1. Export YouTube cookies using a browser plug-in such as "Get cookies.txt" 2. Save the cookie file as `cookies.txt` 3. Click Choose cookies.txt in the application, select File Upload, and the Status: V Cookies file uploaded and enabled display indicates that the upload was successful. ###Download mode configuration The application supports three download modes: - **both** (default): Download album and playlist at the same time - **playlists_only*: Download playlists only, skip album scanning - **Albums_only*: Only download albums, skip playlist scanning Select from the "Download Mode" drop-down menu on the configuration page. ###Debugging Mode If you encounter download problems, you can enable debugging mode to obtain detailed logs: 1. Enable "debug mode" on the configuration page 2. start the download again 3. View the detailed yt-dlp output on the "Debug Log" tab --- ##Common Questions ### Q1: What should I do if the download speed is slow? **A**: Download speed is affected by the following factors: - YouTube server speed limit - network bandwidth limitations - Audio transcoding speed Suggestion: - Avoid downloading during peak network times - Increase the "download timeout" time appropriately - Reduce the number of concurrent downloads ### Q2: What should I do if some songs fail to download? **A**: Possible reasons: - The video has been deleted or made private - regional restrictions - copyright restrictions Solution: - Check if the video can play correctly on YouTube - Try configuring cookies (if it is member content) - Check the error log for specific reasons for the failure