Skip to main content

YouTube video/music downloader with metadata tagging and cover art

Project description

YoutubeSnoop

A Youtube downloader of the highest quality


Installation

You can install it via pip:

$ pip install youtubesnoop

Prerequisites

  • ffmpeg must be installed and available in your PATH.

Usage

A simple command-line tool that downloads Youtube videos in the highest quality available.

Just provide a Youtube URL:

$ youtubesnoop https://www.youtube.com/watch?v=dQw4w9WgXcQ

It will download single tracks to this format:

{title}.flac

Downloading Album Playlists

Provide a playlist URL and it will create a folder for the artist and nest it with the year and album title:

{artist}/{year} - {albumTitle}

This fits my personal need to download albums from Youtube playlists.

Each track will be named like this:

{tracknumber}. {title}.flac

It will try to infer the metadata from the playlist and set it in the downloaded files. Otherwise it will prompt you for it. It uses the mutagen library to set the metadata with the help of musicbrainz to fix any mistakes. It uses musicbrainzngs to download cover art as Cover.jpg or Cover.png and place it in the folder and added to the metadata of each track.

Videos

It downloads as flac files per default but with the --video flag it will download the video as mp4 instead.


403 Forbidden Errors

Youtube constantly changes their API. The solution is likely to upgrade the yt-dlp dependency that this package uses under the hood.

Run:

$ pip install --upgrade youtubesnoop

Or:

$ pipx upgrade yt-dlp

Windows Note

It has been tested on Windows (Powershell) and MacOS.

For Powershell, remember to wrap the URL in quotes to avoid issues with special characters such as & being interpreted.

On Windows, don't use Git Bash since prompt_toolkit has issues with it ANSI escape codes etc.

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

youtubesnoop-0.1.5.tar.gz (56.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

youtubesnoop-0.1.5-py3-none-any.whl (13.9 kB view details)

Uploaded Python 3

File details

Details for the file youtubesnoop-0.1.5.tar.gz.

File metadata

  • Download URL: youtubesnoop-0.1.5.tar.gz
  • Upload date:
  • Size: 56.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.17

File hashes

Hashes for youtubesnoop-0.1.5.tar.gz
Algorithm Hash digest
SHA256 6aa6a5a2dc493228bc125741bcbb668e8e442e13d4722028c70f2e191ea043ad
MD5 0f7230fe04512a86edb2f0ea938a6167
BLAKE2b-256 b0f35ae91b1e80c1a4786d04b2447e0346c1ba703bef1dd51f494dd06f2cd0ce

See more details on using hashes here.

File details

Details for the file youtubesnoop-0.1.5-py3-none-any.whl.

File metadata

File hashes

Hashes for youtubesnoop-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 91540be3b6cbfe863860e08cbec6bfbdbbc21d23522cb7a8e5c5d58c3d5e8e5a
MD5 07a86539551ff0d9e67b24461d5b9e18
BLAKE2b-256 3171cf50dc1704d8c5de20948efbccd41b50a2ceb5347c9f4fa3fa2eb705d16f

See more details on using hashes here.

Supported by

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