Youtube Music Downloader
Project description
YouTube Music Downloader
Download songs from YouTube by getting the audio from YouTube and the metadata from sources like Itunes and Gaana.
Why this? | Support the Project | Prerequisites | Setup | Usage | Change Defaults | Acknowledgements | Need Help
Why this?
This app downloads a song by getting the audio from Youtube sources using youtube-dl and then adds song information like artist name, album name, release date, thumbnail etc by fetching it from sources like Itunes and Gaana.
NO. YoutubeDL doesn't do that. All youtube-dl does is lets you download audio from a video that you specify. This app is not yet another youtube-dl clone.
Support the Project?
If you like my work, consider buying me a coffee or donating. In case you want to become a patron, join my Pateron
Prerequisites
- Python 3.x
- ffmpeg
Setup
-
PyPi
Available in PyPi here
pip install ytmdl
AUR
Available in AUR here
yay -S ytmdl
Gentoo
Available in src_prepare-overlay here
# First set up src_prepare-overlay (as root) emerge -av --noreplace app-eselect/eselect-repository eselect repository enable src_prepare-overlay emaint sync -r src_prepare-overlay # Finally emerge ytmdl (as root) emerge -av --autounmask net-misc/ytmdl
Manual
-
Hate your stable life? Love living on the bleeding edge?
Clone the repo and install manually.
git clone https://github.com/deepjyoti30/ytmdl && cd ytmdl && sudo python setup.py install
-
Usage
usage: ytmdl [-h] [-q] [--song SONG-METADATA] [--choice CHOICE]
[--artist ARTIST] [--album ALBUM] [--disable-metaadd]
[--skip-meta] [-m] [--proxy URL] [--url URL]
[--list PATH TO LIST] [--nolocal] [--format FORMAT] [--trim]
[--version] [--pl-start NUMBER] [--pl-end NUMBER]
[--pl-items ITEM_SPEC] [--ignore-errors] [--level LEVEL]
[--disable-file] [--list-level]
[SONG_NAME [SONG_NAME ...]]
positional arguments:
SONG_NAME Name of the song to download. Can be an URL to a
playlist as well. It will be automatically recognized.
optional arguments:
-h, --help show this help message and exit
-q, --quiet Don't ask the user to select songs if more than one
search result. The first result in each case will be
considered.
--proxy URL Use the specified HTTP/HTTPS/SOCKS proxy. To enable
SOCKS proxy, specify a proper scheme. For example
socks5://127.0.0.1:1080/. Pass in an empty string
(--proxy "") for direct connection
--url URL Youtube song link.
--list PATH TO LIST Download list of songs. The list should have one song
name in every line.
--nolocal Don't search locally for the song before downloading.
--format FORMAT The format in which the song should be downloaded.
Default is [MP3]. Available options are [m4a]
--trim, -t Trim out the audio from the song. Use underlying
speech and music segmentation engine to determine and
keep only the music in the file. Useful in songs where
there are speeches, noise etc before/after the start
of the song. Default is false.
--version show the program version number and exit
Metadata:
--song SONG-METADATA The song to search in Metadata. Particularly useful
for songs that have the names in a different language
in YouTube. For Example, greek songs.
--choice CHOICE The choice that the user wants to go for. Usefull to
pass along with --quiet. Choices start at 1
--artist ARTIST The name of the song's artist. Pass it with a song
name.
--album ALBUM The name of the song's album. Pass it with a song
name.
--disable-metaadd Disable addition of passed artist and album keyword to
the youtube search in order to get a more accurate
result. (Default: false)
--skip-meta Skip setting the metadata and just copy the converted
song to the destination directory. '--manual-meta'
will override this option, pass only one of them.
-m, --manual-meta Manually enter song details.
Playlist:
--pl-start NUMBER Playlist video to start at (default is 1)
--pl-end NUMBER Playlist video to end at (default is last)
--pl-items ITEM_SPEC Playlist video items to download. Specify indices of
the videos present in the playlist seperated by commas
like: '--playlist-items 1, 2, 4, 6' if you want to
download videos indexed 1, 2, 4 and 6. Range can also
be passed like: '--playlist-items 1-3, 5-7' to
download the videos indexed at 1, 2, 3, 5, 6, 7.
--ignore-errors Ignore if downloading any video fails in a playlist.
If passed, the execution will move to the next video
in the passed playlist.
Logger:
--level LEVEL The level of the logger that will be used while
verbosing. Use `--list-level` to check available
options.
--disable-file Disable logging to files
--list-level List all the available logger levels.
Change Defaults
The defaults can be changed by editing the config file in ytmdl folder in your .config folder
NOTE: The config will be created automatically the first time you run
ytmdl
and will be present in~/.config/ytmdl/config
In case you want to create the config before the first run and edit it accordingly, do it the following way.
mkdir -p ~/.config/ytmdl; curl https://raw.githubusercontent.com/deepjyoti30/ytmdl/master/config > ~/.config/ytmdl/config
This will download the default config from the repo to your ~/.config/ytmdl
directory.
Supported options to change are:
Name | |
---|---|
SONG_DIR |
Directory to save the songs in after editing |
SONG_QUALITY |
Quality of the song |
METADATA_PROVIDERS |
Which API providers to use for metadata |
SONG_DIR also takes values that are extracted from the song
Example format is /your/desired/path$Album->Artist->Title
to save in the following way
|--your
|--desired
|--path
|--Album
|--Artist
|--Title
|--Song.mp3
Adding any tag at the end of the SONG_DIR between [] will be considered the name of the song.
Example format is /your/desired/path$Album->Artist->[Title]
to save in the following way
|--your
|--desired
|--path
|--Album
|--Artist
|--Title.mp3
Supported options are:
Name | |
---|---|
Artist |
Artist Of the Song |
Album |
Album Of the Song |
Title |
Title Of the Song |
Genre |
Genre Of the Song |
TrackNumber |
TrackNumber Of the Song |
ReleaseDate |
ReleaseDate Of the Song |
Acknowledgements
-
Inspired from https://github.com/tterb/yt2mp3
-
Thanks to the developers of youtube-dl, itunespy, mutagen, colorama and Python.
-
Thanks to itunes and gaana for their awesome API's.
-
Thanks to Nishan Pantha for search logic.
-
Thanks to Biswaroop for testing in windows.
Need Help
Join the Telegram group for support.
Project details
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 Distributions
Built Distribution
Hashes for ytmdl-2020.7.26-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d9fd2671dcb7b80a122dce1b639a367a85fc47dafbcf17b8a90e7592f8412b0e |
|
MD5 | e270285f718ec44d6e4823adf5f234f3 |
|
BLAKE2b-256 | 6a604c377d3d2c29347fccbd21036cd8058f6d90e9fc34feb7fd97bc67e3a9df |