Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thib1984/ytdlmusic

ytdlmusic is a command-line program to search and download music files from YouTube without use browser.
https://github.com/thib1984/ytdlmusic

downloader ffmpeg hacktoberfest hacktoberfest2021 id3v2-tag m4a mp3 ogg pypi python youtube youtube-dl youtube-search

Last synced: about 1 month ago
JSON representation

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

Host: GitHub
URL: https://github.com/thib1984/ytdlmusic
Owner: thib1984
License: mit
Created: 2021-04-10T16:39:27.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-05-01T06:11:11.000Z (7 months ago)
Last Synced: 2024-09-29T03:23:03.894Z (about 2 months ago)
Topics: downloader, ffmpeg, hacktoberfest, hacktoberfest2021, id3v2-tag, m4a, mp3, ogg, pypi, python, youtube, youtube-dl, youtube-search
Language: Python
Homepage:
Size: 332 KB
Stars: 6
Watchers: 3
Forks: 3
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        # 🎵 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](https://pypi.org/project/ytdlmusic/)

# :warning: 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](https://pypi.org/project/yt_dlp/), a fork of [youtube-dl](https://github.com/ytdl-org/youtube-dl)

- [youtube-search-python](https://pypi.org/project/youtube-search-python/)

# 💫 How use **ytdlmusic**

`ytdlmusic [KEY WORDS]`

![demo_1](https://user-images.githubusercontent.com/45128847/137580908-ce3f1b17-a2b3-4530-bc90-df00fbaf1cfc.gif)

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`

![demo_2](https://user-images.githubusercontent.com/45128847/137581058-e0cca29b-9ad1-472e-bbb0-4fce94b984a0.gif)

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](INSTALL.md)

# :question: FAQ

See [this page](FAQ.md)

# :construction_worker: Contribution

## For contributors

Go to [CONTRIBUTING.md](CONTRIBUTING.md). You have to read and accept this [Code of conduct](./CODE_OF_CONDUCT.md).

## Tanks to contributors

Thanks to contributors and dependency authors :

- [albenquer](https://github.com/albenquer), [dlicois](https://github.com/dlicois) and [Jean-Phi Baconnais](https://github.com/jeanphibaconnais) for contributions !

- [Hitesh Kumar Saini](https://github.com/alexmercerind) for [youtube-search-python](https://github.com/alexmercerind/youtube-search-python)

- [yt-dlp](https://github.com/yt-dlp) for [yt-dlp](https://github.com/yt-dlp/yt-dlp)

- [devsnd](https://github.com/devsnd) for [tinytag](https://github.com/devsnd/tinytag)

- [avian2](https://github.com/avian2) for [unidecode](https://github.com/avian2/unidecode)

- [tartley](https://github.com/tartley) for [colorama](https://github.com/tartley/colorama)

- [vaultboy](https://pypi.org/user/vaultboy) for [termcolor](https://pypi.org/project/termcolor/)

- [Federico Carboni](https://github.com/FedericoCarboni) for [setup-ffmpeg](https://github.com/FedericoCarboni/setup-ffmpeg)

- [pypa](https://github.com/pypa) for [gh-action-pypi-publish](https://github.com/pypa/gh-action-pypi-publish)

- [elgohrf](https://github.com/elgohr) for [Github-Release-Action](https://github.com/elgohr/Github-Release-Action)

# :package: Changelog

See [this page](CHANGELOG.md)

# License

MIT License

Copyright (c) 2021 [thib1984](https://github.com/thib1984)

See [this page](LICENSE.txt) for details