mmdl - Mega Music Downloader
❓
What is mmdl MMDL is a cli app which allows you to quickly and efficiently download one or multiple songs from YouTube.
Why
-
🕖 Fast: Thanks to async code and multithreading. -
⚡ Simple: Typemmdl go
and get started with downloading songs. -
✨ Powerful- Find songs based on songs query/title
- Skip already existing songs
- Add metadata such as artist name and artwork
👇
Requirements -
Python 3
-
FFmpeg
Here is a quick guide: https://github.com/adaptlearning/adapt_authoring/wiki/Installing-FFmpeg
❤️
Install Make sure you have installed FFmpeg. Else this programm won’t work.
pip install mmdl
🔥
Usage Go
Very quick and easy way of running the cli. Few questions will be asked via prompts. This is the recommended way!
mmdl go
Download
Fast and traditional way of running the cli. Pass arguments and have your songs downloaded. Useful for automation scripts.
mmdl download <method> #(add -h for more information)
Methods
-
File
mmdl download file <location>
: Get songs from file. Then download them. -
List
mmdl download list "Term1" "Term2" ...
ormmdl download list -a
for a prompt: Add multiple songs as cli arguments or enter them in a prompt. -
YTMusic (beta)
mmdl download ytmusi
: Download multiple songs from YouTube Music liked songs playlist (via parsing HTML) -
Single
mmdl download single song name
: Download a single song.
⚡
Support
🐛
Bugs Please open a issue with some information to reproduce your problem.
❓
Questions Please start/check a discussion.
🤜
Contributing We welcome contributions very much. They are appreciated.
Steps
- Check for bugs/issues you would like to solve.
- Fork the repo and make your changes.
- Send a pull request.
🥂
Credits The following amazing libraries helped me make this project:
- https://github.com/tmbo/questionary - Questionary by Tom Bocklisch and Kian Cross
- https://github.com/alexmercerind/youtube-search-python - Youtube Search Python by Hiteh Kumar Saini
- https://github.com/willmcgugan/rich - Rich by Will McGugan
- https://github.com/ytdl-org/youtube-dl - YoutubeDl
⚖️
License The MIT License (MIT)
Copyright (c) 2021 - techboy-coder