anydl is an open-source Python desktop application built with Flet. It serves as a user-friendly graphical interface (GUI) that orchestrates several industry-standard command-line download engines.
Running anydl as simple as possible. It runs locally as a fast, responsive web application directly in your browser.
🪟 For Windows Users:
You don't need to install anything! The start_windows.bat script will automatically download and set up a portable version of Python and FFmpeg for you if they are missing from your system.
🍎 macOS / 🐧 Linux Users: Before using the app, you must install the following on your system:
- Python 3.8 or newer: Pre-installed on most Linux distros. Mac users can download it here.
- FFmpeg: Required to convert video and audio formats.
- macOS: Install via Homebrew:
brew install ffmpeg - Linux: Install via your package manager (e.g.,
sudo apt install ffmpegorsudo dnf install ffmpeg)
- macOS: Install via Homebrew:
-
Download the Repository: Click the green "Code" button at the top and select "Download ZIP", then extract it. (Or clone via terminal:
git clone https://github.com/sytrusz/anydl.git) -
Launch the Application: Open the extracted folder and run the startup script for your operating system:
- 🪟 Windows: Double-click the
start_windows.batfile. - 🍎 macOS / 🐧 Linux: Run the
start_linux.shscript in your terminal (./start_linux.sh).
- 🪟 Windows: Double-click the
That's it! The script will automatically set everything up and launch the app in your default web browser.
- Select your tool: Click one of the cards (Spotify, YouTube, TikTok, etc.) on the home screen.
- Choose a folder: Click the folder icon at the bottom to set your download directory.
- Download: Paste your URL and click Download.
- 🎥 Video Downloads: Download the "Best Video" (automatically merged to MP4) from YouTube, TikTok, Facebook, Instagram, and X.
- 🎵 Music Downloads: High-quality MP3 downloads from Spotify and SoundCloud with full metadata.
- 🚀 Spotify Rate-Limit Bypassing: Add your own Spotify Developer API keys via the Settings menu to bypass annoying rate limits on user-created playlists.
- 📁 Smart Playlist Folders: Playlists are automatically organized into neatly named subfolders (
anydl@sytrus - [Playlist Name]). - 📊 Progress & Stats: Watch your downloads complete with a live progress bar, and get detailed summaries of successful/missing songs upon completion.
- 📂 Custom Save Locations: Easily choose where your files go using your operating system's native folder picker.
- 🎨 Modern UI: A clean, distraction-free interface with Dark/Light mode support.
This project is built upon the incredible work of the following repositories:
- yt-dlp: The engine used for YouTube, TikTok, Facebook, X (Twitter), and Instagram downloads.
- spotDL: The engine used for Spotify track and playlist downloads.
- scdl: The engine used for SoundCloud audio downloads.
Massive thanks to the open-source community:
- Flet: The UI framework.
- yt-dlp: The video engine.
- spotDL: The Spotify engine.
- scdl: The SoundCloud engine.
This project is open-source. Feel free to fork, modify, and distribute it!