GitLocker: The Coding Marketplace

Description:

pythumb 1.1.0

PyThumb

Simple command line utility and API for downloading YouTube thumbnails.
Supports JPEG and WebP formats in all sizes.
Previews (animated thumbnails) are not supported due to the lack of direct URL or API access.
Requires Python 3.6+
Table of contents

Installation

From source

Usage

CLI
API
Thumbnail sizes

License

Installation
Install via pip:
$ pip install pythumb

Or get binaries from the latest release.
From source
Use python instead of python3 on Windows
Download source code from the latest release, extract and cd into it.
(Optional) Create a virtual environment to manage packages easier.
Update pip and setuptools:
$ python3 -m pip install -U pip setuptools

Install this package:
$ python3 -m pip install .

Optionally you can build a standalone executable.
Prerequisites:

Git Bash (Windows)

On Linux install python3-dev:
$ sudo apt install python3-dev

Install PyInstaller:
$ python3 -m pip install pyinstaller

Run the build script for your OS:
$ chmod +x ./scripts/build.sh
$ ./scripts/build.sh <win / linux>

You can find the executable in ./pyi-dist/.
Usage
CLI
$ pythumb [options] <input>

To save a thumbnail to the current directory, simply pass the video URL or 11-character ID (recommended quoted):
$ pythumb "https://youtu.be/aqz-KE-bpKQ"
# or
$ pythumb "aqz-KE-bpKQ"

Use --help for more details.
API
Example
from pythumb import Thumbnail
t = Thumbnail('https://youtu.be/aqz-KE-bpKQ')
t.fetch()
t.save('.')
# ./aqz-KE-bpKQ.jpg

Thumbnail sizes

Name
Size

maxresdefault
1280x720

sddefault
640x480

hqdefault
480x360

mqdefault
320x180

default
120x90

Auto-generated previews (start, middle and end of the video)

Name
Size

maxres1
1280x720

maxres2
1280x720

maxres3
1280x720

sd1
640x480

sd2
640x480

sd3
640x480

hq1
480x360

hq2
480x360

hq3
480x360

mq1
320x180

mq2
320x180

mq3
320x180

1
120x90

2
120x90

3
120x90

License
MIT license. See LICENSE for more information.