Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tterb/yt2mp3
:arrow_down: Search, Download, and Convert YouTube videos to MP3
https://github.com/tterb/yt2mp3
cli download mp3 music python video youtube
Last synced: 24 days ago
JSON representation
:arrow_down: Search, Download, and Convert YouTube videos to MP3
- Host: GitHub
- URL: https://github.com/tterb/yt2mp3
- Owner: tterb
- License: mit
- Created: 2018-03-21T00:55:42.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-05-14T13:13:05.000Z (over 3 years ago)
- Last Synced: 2024-10-12T05:08:38.240Z (about 1 month ago)
- Topics: cli, download, mp3, music, python, video, youtube
- Language: Python
- Homepage:
- Size: 443 KB
- Stars: 98
- Watchers: 4
- Forks: 4
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: docs/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# YouTube to MP3
## Description
This program simplifies the process of searching, 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 use the data to find a corresponding YouTube video, if a URL is not provided. The video will then be downloaded, converted, and the gathered data will be used to populate the metadata of the MP3.
Once finished, the resulting MP3 file will be saved to your *Downloads* directory, with the following file-structure `Music/{artist}/{track}.mp3`.
***Note:*** 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 the YouTube thumbnail will be used as the album artwork.
## Getting Started
### Prerequisites
The program only requires that you have Python 3.4+ and [ffmpeg](https://www.ffmpeg.org/) or [libav](https://www.libav.org/) installed. For more information, check out the [additional setup](https://yt2mp3.readthedocs.io/en/latest/additional_setup.html).
### Install
You can install the program with the following command:
```sh
$ pip install yt2mp3
```
## Usage
The program can be executed as shown:
```sh
$ yt2mp3 [-options]
```
#### Options:
| Arguments | |
|-------------------|-------------------------------------------------------|
| `-t, --track` | Specify the track name query |
| `-a, --artist` | Specify the artist name query |
| `-c, --collection`| Specify the album name query
| `-u, --url` | Specify a Youtube URL or ID |
| `-p, --playlist` | Specify a Youtube playlist URL or ID |
| `-o, --overwrite` | Overwrite the file if one exists in output directory |
| `-r, --resolution`| Specify the resolution for the cover-art |
| `-q, --quiet` | Suppress program command-line output |
| `-v, --verbose` | Display a command-line progress bar |
| `--version` | Show the version number and exit |
| `-h, --help` | Display information on usage and functionality |
## Documentation
Further documentation is available on [Read The Docs](https://yt2mp3.readthedocs.io/en/latest/)
## Contributing
If you'd like to contribute to the project, feel free to suggest a [feature request](https://github.com/tterb/yt2mp3/issues/new?template=feature_request.md) and/or submit a [pull request](https://github.com/tterb/yt2mp3/pulls?q=is%3Apr+is%3Aopen+sort%3Aupdated-desc).