A commandline utility that enables the creation of albums from Youtube playlists.
Project description
ytam - YouTube Album Maker
A commandline utility that enables the creation of albums from Youtube playlists.
Getting Started
Prerequisites
To be able to use the mp4 to mp3 conversion feature, ffmpeg must be installed.
Debian:
sudo apt-get install ffmpeg
Windows:
- Download ffmpeg binaries from here
- Add the bin\ directory to Windows PATH
Installing
pip install ytam
Usage:
usage: ytam [-h] [-t TITLES] [-d DIRECTORY] [-s START] [-e END] [-A ALBUM]
[-a ARTIST] [-i IMAGE] [-p PROXY] [-3 [MP3]] [-k [CHECK]]
URL
positional arguments:
URL the target URL of the playlist to download
optional arguments:
-h, --help show this help message and exit
-t TITLES, --titles TITLES
a plain text file containing the desired titles and
artists of the songs in the playlist, each on a new
line. Format: title<@>artist
-d DIRECTORY, --directory DIRECTORY
the download directory (defaults to 'music' - a
subdirectory of the current directory)
-s START, --start START
from which position in the playlist to start
downloading (defaults to 1)
-e END, --end END position in the playlist of the last song to be
downloaded (defaults to last position in the playlist)
-A ALBUM, --album ALBUM
the name of the album that the songs in the playlist
belongs to (defaults to playlist title)
-a ARTIST, --artist ARTIST
the name of the artist that performed the songs in the
playlist (defaults to Unknown)
-i IMAGE, --image IMAGE
the path to the image to be used as the album cover.
Only works when -A flag is set
-p PROXY, --proxy PROXY
list of proxies to use. Must be enclosed in string
quotes with a space separating each proxy. Proxy
format: <protocol>-<proxy>
-3 [MP3], --mp3 [MP3]
converts downloaded files to mp3 format and deletes
original mp4 file. Requires ffmpeg to be installed on
your machine
-k [CHECK], --check [CHECK]
checks whether ytam is working as it should by trying
to download a pre-defined playlist and setting pre-
defined metadata. Setting this argument causes ytam to
ignore ALL others
Tests
TODO
Built With
- pytube - Lightweight Python library for downloading videos
- mutagen - For MP4 metadata tagging
- argparse - For parsing commandline arguments
- ffmpeg - For mp4 to mp3 conversion
Authors
- jayathungek - Initial work - jayathungek
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 Distribution
ytam-0.4.5.tar.gz
(47.0 kB
view hashes)
Built Distribution
ytam-0.4.5-py3-none-any.whl
(46.0 kB
view hashes)