Metadata-Version: 2.4
Name: youtubesnoop
Version: 0.1.4
Summary: YouTube video/music downloader with metadata tagging and cover art
Project-URL: Homepage, https://github.com/anderslatif/YoutubeSnoop
Project-URL: Repository, https://github.com/anderslatif/YoutubeSnoop
Project-URL: Issues, https://github.com/anderslatif/YoutubeSnoop/issues
Author: Anders
License: MIT
License-File: LICENSE
Keywords: downloader,flac,metadata,music,musicbrainz,youtube
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.8
Requires-Dist: click>=8.0.0
Requires-Dist: filetype>=1.2.0
Requires-Dist: musicbrainzngs>=0.7.1
Requires-Dist: mutagen>=1.47.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: yt-dlp>=2024.0.0
Description-Content-Type: text/markdown

# YoutubeSnoop

[![](https://img.shields.io/pypi/v/youtubesnoop.svg)](https://pypi.org/pypi/youtubesnoop/)

A Youtube downloader of the highest quality

---

## Installation

You can install it via pip:

```bash
$ pip install youtubesnoop
```

---

## Prerequisites

* [ffmpeg](https://ffmpeg.org/) 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:

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

It will download single tracks to this format:

```plaintext
{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:

```plaintext
{artist}/{year} - {albumTitle}
```

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

Each track will be named like this:

```plaintext
{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](https://mutagen.readthedocs.io/en/latest/) library to set the metadata with the help of [musicbrainz](https://musicbrainz.org/) to fix any mistakes. It uses [musicbrainzngs](https://pypi.org/project/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.



