Skip to main content

Simplifies the process of searching, downloading and converting Youtube videos to MP3 files

Project description

YouTube to MP3

PyPi PyPI - Python Version License

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:

pip install yt2mp3

Usage

The program can executed via Python 3 as follows:

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.

Development

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

# 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yt2mp3-1.0.4.tar.gz (6.4 kB view hashes)

Uploaded Source

Built Distribution

yt2mp3-1.0.4-py3-none-any.whl (6.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page