thib1984 / ytdlmusic

ytdlmusic is a command-line program to search and download music files from YouTube without use browser.

🎵 ytdlmusic

ytdlmusic is a command-line program that allows you to search and download music files from YouTube without using a browser. This package is available directly from pypi

⚠️ Disclaimer

Downloading restricted content with this software may be illegal, depending on the laws in your country.

This package uses two important dependencies:

• yt_dlp, a fork of youtube-dl
• youtube-search-python

💫 How use ytdlmusic

ytdlmusic [KEY WORDS]

If the key word has an url format, ytdmusic will download directly the file.

💫 How use ytdlmusic in batch mode

You can use a command to loop through a CSV file and download all MP3 files from it.

ytdlmusic --batch path_file had_header sep columns_to_concatenate

The CSV file (used in the demo's example) looks like this:

song_column;artist_column;unused column
limujii;above;no
nomyn;awake;use
eyazttyzaeyz;zhhezhahkzaj;inexistant
scandinavianz;avalon;information

🚀 Other commands and flags

ytdlmusic , ytdlmusic --help or ytdlmusic -h displays help message.

ytdlmusic --update or ytdlmusic -u upgrades ytdlmusic.

ytdlmusic --fullupdate or ytdlmusic -U upgrades ytdlmusic and the dependencies : yt-dlp and youtube-search-python.

ytdlmusic --version or ytdlmusic -v displays the version of ytdlmusic and its dependencies.

You can also add these flags to your commands (except for help and version) :

--auto or -y : uses auto mode, which chooses the first item for classic use auto-accept other commands.

--choices X or -N X : sets the number of choices (default=5, min=1, max=10).

--k or --keep : keeps the YouTube video title for the filename.

--t or --tag : uses tags of the downloaded file to rename it.

--m4a or -f : uses M4A format.

--ogg or -o : uses OGG format.

--Q or --quality : sets the quality to 320kbs instead of 256kbs for MP3 format.

--nocover : do not add cover art (from youtube thumbnail) to file produced.

--quiet or -q : gives less output.

--verbose or -d : gives more output.

--nocolor or -n : disable colors and emojis in sysout.

⚙️ Install

See this page

❓ FAQ

See this page

👷 Contribution

For contributors

Go to CONTRIBUTING.md. You have to read and accept this Code of conduct.

Tanks to contributors

Thanks to contributors and dependency authors :

• albenquer, dlicois and Jean-Phi Baconnais for contributions !
• Hitesh Kumar Saini for youtube-search-python
• yt-dlp for yt-dlp
• devsnd for tinytag
• avian2 for unidecode
• tartley for colorama
• vaultboy for termcolor
• Federico Carboni for setup-ffmpeg
• pypa for gh-action-pypi-publish
• elgohrf for Github-Release-Action

📦 Changelog

See this page

License

MIT License

Copyright (c) 2021 thib1984

See this page for details

ytdlmusic's Issues

Add a code of conduct

I think add a code of conduct is a good think 😄