Metadata-Version: 2.1
Name: yt2mp3
Version: 1.0.5
Summary: Simplifies the process of searching, downloading and converting Youtube videos to MP3 files
Home-page: https://github.com/tterb/yt2mp3
Author: Brett Stevenson
Author-email: bstevensondev@gmail.com
License: UNKNOWN
Download-URL: https://github.com/tterb/yt2mp3/archive/1.0.5.tar.gz
Keywords: youtube,convert,mp3,download,itunes,music,cli
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Description-Content-Type: text/markdown
Requires-Dist: pydub (==0.21.0)
Requires-Dist: mutagen (==1.40.0)
Requires-Dist: curses-menu (==0.5.0)
Requires-Dist: requests (==2.18.4)
Requires-Dist: setuptools (==39.2.0)
Requires-Dist: itunespy (==1.5.5)
Requires-Dist: pytube (==9.2.2)
Requires-Dist: Pillow (==5.1.0)
Requires-Dist: lxml (==4.2.3)
Requires-Dist: beautifulsoup4 (==4.6.0)

# YouTube to MP3  

<p align="right">
  <img src="https://img.shields.io/pypi/v/yt2mp3.svg" alt="PyPi"/>
  <img src="https://pypip.in/py_versions/yt2mp3/badge.svg" alt="PyPI - Python Version"/>
  <a href="https://github.com/tterb/yt2mp3/blob/master/LICENSE"><img src="https://img.shields.io/github/license/tterb/yt2mp3.svg" alt="License"/></a>
</p>  

<p align="center">
  <img src="https://user-images.githubusercontent.com/16360374/42131622-f496ba52-7cba-11e8-9891-cf0835793c4d.gif" width="700"/>
</p>

## Description  
This program aims to simplify the process of downloading and converting Youtube videos to MP3 files from the command-line. All you need is the video URL or the name of the artist/track you're looking for.  
The program will attempt to retrieve data for a song matching the provided input by querying the iTunes API and then use the data to find a corresponding YouTube video, if a URL is not provided.  
The video will then be downloaded, converted, and the retrieved data will be used to populate the metadata of the MP3.  
Additionally, if a URL is provided and no match is found for the song data, the program will prompt the user for the track/artist and use the YouTube thumbnail as the album artwork.  

## Install  
You can install the program with the following command:  
```sh
pip install yt2mp3
```

## Usage  
The program can executed via Python 3 as follows:  
```sh
yt2mp3 [-options]
```

#### Options:  
| Arguments        |                                                  |
|------------------|--------------------------------------------------|
| `-t, --track`    | Specify the track name query                     |
| `-a, --artist`   | Specify the artist name query                    |
| `-u, --url`      | Specify a Youtube URL or ID                      |
| `-q, --quiet`    | Suppress program command-line output             |
| `-v, --verbose` | Display a command-line progress bar              |
| `-h, --help`     | Displays information on usage and functionality  |  

Once complete, the resulting MP3 file will be saved to your *Downloads* directory, with the following file-structure `Music/{artist}/{track}.mp3`.  

***Note:*** Displaying the progress bar currently has a significant impact on download performance, due to [#180](https://github.com/nficano/pytube/issues/180).  


## Development  
You can download and install the app with the following commands:  

```sh
# Clone the repository / most up to date is on saftyBranch
git clone https://github.com/tterb/yt2mp3

# Navigate to the directory
cd yt2mp3

# Install program dependencies
pip install -r requirements.txt
```

<br>  


