CLI tool for searching YouTube/YTMusic and downloading audio/video from 1000+ platforms
Project description
fm-dlp — Download from YouTube, YTMusic, and 1000+ sites
CLI tool for searching YouTube/YTMusic and downloading audio/video from 1000+ platforms
🚀 Quick Start
pip install fm-dlp # Python 3.10+ & FFmpeg required
fm-dlp config ~/Music # Set download directory
fm-dlp search "artist" # Search tracks
fm-dlp download "URL" --codec flac # Download audio
📋 Commands
search
fm-dlp search <query> [--limit 10] [--yt-video] [--album] [--raw] [--only-url] [--no-color]
| Option | Description |
|---|---|
--limit N |
Maximum number of results (default: 10) |
--yt-video |
Search YouTube videos instead of YouTube Music |
--album |
Search for albums instead of individual tracks |
--raw |
Output raw JSON/Python dict format |
--only-url |
Output only URLs without any formatting |
--no-color |
Disable colored output in search results |
download
fm-dlp download <urls> [--codec CODEC] [--kbps 256] [--jobs 5] [--quiet] [--no-metadata] [--path PATH] [--cookies COOKIES] [--no-color]
URLs: Single, multiple (space/comma), or file path (one URL per line, # for comments)
| Option | Description |
|---|---|
--codec |
Audio: mp3, aac, flac, m4a, opus, vorbis, wav, alac Video: mp4, mkv, webm, mov, avi, flv |
--kbps |
Audio bitrate 64–320 (default: 256) |
--jobs |
Number of parallel downloads (default: 5) |
--quiet |
Suppress yt-dlp output messages |
--no-metadata |
Skip metadata and thumbnail embedding |
--path |
Override download directory |
--cookies |
Browser name (brave, chrome, chromium, edge, opera, vivaldi, whale, firefox, safari) or path to cookies file |
--no-color |
Disable colored output in download messages |
config
fm-dlp config <path> [--no-color]
| Option | Description |
|---|---|
path |
Default download directory |
--no-color |
Disable colored output in configuration messages |
update
fm-dlp update [--no-color]
Self-update to the latest version from GitHub with automatic OS detection.
| Option | Description |
|---|---|
--no-color |
Disable colored output in update messages |
| Behavior | Description |
|---|---|
| Binary mode (PyInstaller) | Downloads the appropriate executable for your OS (.exe on Windows, no extension on macOS/Linux) and replaces the current binary |
| Script mode (pip install) | Updates the package via pip or uv (whichever is available, uv preferred for faster installation) |
Features:
- Automatic OS detection (Windows, macOS, Linux)
- Always updates to the latest GitHub release (no version checking)
- Cross-platform support
- Fallback to pip if uv is not installed
- Preserves executable permissions on Unix systems
- Error handling with user-friendly messages:
- GitHub API connection failures
- Missing assets for current OS
- Permission denied (with admin/sudo suggestion)
- Package installation errors (with detailed output)
Note: The application may need to be restarted after updating, especially when running as a binary.
📄 License & Acknowledgments
MIT License — Built with:
| Library | Purpose |
|---|---|
| yt-dlp | Download engine |
| ytmusicapi | YouTube Music API |
| mutagen | Metadata tagging |
| platformdirs | Config paths |
| argss | CLI framework |
Author: Fkernel653
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
fm_dlp-4.2.1.tar.gz
(30.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
fm_dlp-4.2.1-py3-none-any.whl
(19.3 kB
view details)
File details
Details for the file fm_dlp-4.2.1.tar.gz.
File metadata
- Download URL: fm_dlp-4.2.1.tar.gz
- Upload date:
- Size: 30.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b0fcd992a609c8136fc9467adb00574239b432d86470974cff6b04d0c136776
|
|
| MD5 |
31ce952cea842d2d9503f31bf7adb080
|
|
| BLAKE2b-256 |
57dba2423bac465f9c59b66cfd48e045952d4e31413fa681dbf9369737d51d6d
|
File details
Details for the file fm_dlp-4.2.1-py3-none-any.whl.
File metadata
- Download URL: fm_dlp-4.2.1-py3-none-any.whl
- Upload date:
- Size: 19.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.25 {"installer":{"name":"uv","version":"0.11.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9b4b63aeeb1ddc23d973a7ff8bfdb1897a7c4615c2031dc8ee4b8f8e6e83f2e3
|
|
| MD5 |
9848b13ac7ad1496b822db86dca23fcd
|
|
| BLAKE2b-256 |
9f0758ab38fc9dbc6de9c5718ade1ca703c4503d218ea970675f13a7182dfec5
|
