Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alexitx/pythumb
Simple command line utility and API for downloading YouTube thumbnails
https://github.com/alexitx/pythumb
cli client command-line downloader image python thumbnail thumbnails utility youtube
Last synced: 10 days ago
JSON representation
Simple command line utility and API for downloading YouTube thumbnails
- Host: GitHub
- URL: https://github.com/alexitx/pythumb
- Owner: alexitx
- License: mit
- Created: 2020-11-30T01:29:22.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2022-03-04T16:04:25.000Z (over 2 years ago)
- Last Synced: 2024-10-15T22:33:38.506Z (21 days ago)
- Topics: cli, client, command-line, downloader, image, python, thumbnail, thumbnails, utility, youtube
- Language: Python
- Homepage:
- Size: 70.3 KB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# PyThumb
![version][shields-version]
![python version][shields-python]
![python wheel][shields-wheel]
![license][shields-license]
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](#installation)
- [From source](#from-source)
- [Usage](#usage)
- [CLI](#cli)
- [API](#api)
- [Thumbnail sizes](#thumbnail-sizes)
- [License](#license)
## Installation
Install via pip:
```sh
$ pip install pythumb
```
Or get binaries from the [latest release][latest-release].
### From source
###### *Use `python` instead of `python3` on Windows*
Download source code from the [latest release][latest-release], extract and `cd` into it.
(Optional) Create a [virtual environment][virtual-environment] to manage packages easier.
Update pip and setuptools:
```sh
$ python3 -m pip install -U pip setuptools
```
Install this package:
```sh
$ python3 -m pip install .
```
---
Optionally you can build a standalone executable.
Prerequisites:
- [Git Bash][git] (Windows)
On Linux install python3-dev:
```sh
$ sudo apt install python3-dev
```
Install PyInstaller:
```sh
$ python3 -m pip install pyinstaller
```
Run the build script for your OS:
```sh
$ chmod +x ./scripts/build.sh
$ ./scripts/build.sh
```
You can find the executable in `./pyi-dist/`.
## Usage
### CLI
```sh
$ pythumb [options]
```
To save a thumbnail to the current directory, simply pass the video URL or 11-character ID (recommended quoted):
```sh
$ pythumb "https://youtu.be/aqz-KE-bpKQ"
# or
$ pythumb "aqz-KE-bpKQ"
```
Use `--help` for more details.
### API
#### Example
```py
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][license] for more information.
[shields-version]: https://img.shields.io/github/v/tag/alexitx/pythumb?color=e65c5c&label=version&style=flat-square
[shields-python]: https://img.shields.io/badge/python-3.6--3.10-2996cc?style=flat-square
[shields-wheel]: https://img.shields.io/pypi/wheel/pythumb?color=7acc29&style=flat-square
[shields-license]: https://img.shields.io/github/license/alexitx/pythumb?color=e67a45&style=flat-square
[latest-release]: https://github.com/alexitx/pythumb/releases
[wiki]: https://github.com/alexitx/pythumb/wiki
[license]: https://github.com/alexitx/pythumb/blob/main/LICENSE
[git]:https://gitforwindows.org
[virtual-environment]: https://www.geeksforgeeks.org/creating-python-virtual-environment-windows-linux