Giter VIP home page Giter VIP logo

ytmdl's Introduction

YouTube Music Downloader

Download songs from YouTube by getting the audio from YouTube and the metadata from sources like Itunes and Gaana.


Why this?   |   Prerequisites   |   Setup   |   Usage   |   Change Defaults   |   Acknowledgements   

forthebadge made-with-python

Travis (.org) License PyPI AUR PyPI - Downloads PRs Welcome

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.

Prerequisites

  • Python 3.x
  • ffmpeg

Setup

  • PyPi

  • AUR

  • Gentoo

  • Manual

    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] [--proxy URL] [--url URL] [-s]
             [--list PATH TO LIST] [--nolocal] [--version] [--level LEVEL]
             [--disable-file] [--list-level]
             [SONG_NAME [SONG_NAME ...]]

positional arguments:
  SONG_NAME             Name of the song to download.

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.
  -s, --setup           Setup the config file
  --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.
  --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)

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

Supported options to change are:

Name
SONG_DIR Directory to save the songs in after editing
SONG_QUALITY Quality of the song

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.

ytmdl's People

Contributors

0xflotus avatar alx99 avatar biswaroop1547 avatar deepjyoti30 avatar dopsi avatar njkevlani avatar xgqt avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.