Skip to main content

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

Release files for ytam 0.4.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ytam 0.4.5
File Size Uploaded
ytam-0.4.5.tar.gz 47.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ytam 0.4.5
File Interpreter ABI Platform
ytam-0.4.5-py3-none-any.whl Python 3 none any Details

Total release size: 93.0 kB

Release files / ytam-0.4.5.tar.gz

Download URL ytam-0.4.5.tar.gz
Size 47.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f77a999b172808a642c4364402a89e4c6def973ef9bb738d9ed465de2a91ef64
BLAKE2b-256 checksum
How to use checksums
5863e9f537310dac581819a7b010b8f8b9ff988fe5d7f4897354622be74ffebf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release files / ytam-0.4.5-py3-none-any.whl

Download URL ytam-0.4.5-py3-none-any.whl
Size 46.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
83c5cf46cbd5843c9aafb2d9448cba5f9911d7205870302fefb513b8467d0e57
BLAKE2b-256 checksum
How to use checksums
7b9ff6af1ad4d4ec9215925f32b9d0d1bf3b788c4eba162c2459f4b56046e41f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.24.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10

Release history Release notifications | RSS feed

This release

0.4.5 This release

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

0.0.35

2 release files

0.0.34

2 release files

0.0.33

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page