Project

thumbsdown

0.0
No release in over 3 years
Low commit activity in last 3 years
thumbsdownaladac/thumbsdownHomepageDocumentationSource CodeBug TrackerWiki
Script to generate a thumbnail grid in the form of a PNG file from a video source
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Popularity
Downloads
2,466
Stars
0
Forks
0
Watchers
1
 Releases
Current version
0.1.0
Total releases
1
First release
2018-07-03
Latest release
2018-07-03
 Pull Requests
Open Pull Requests
0
Closed Pull Requests
0
Merged Pull Requests
1
Pull Request Acceptance Rate
100%
 Development
Primary Language
Rust
Licenses
MIT
Average date of last 50 commits
2022-04-26
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.16
rake
~> 10.0

Runtime

tqdm
>= 0
 Project Readme

Thumbsdown

Generate thumbnail grids from video files.

example

Requirements

Installation

Quick install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/aladac/thumbsdown/master/install.sh | bash

From crates.io

cargo install thumbsdown

From source

cargo install --path .

From GitHub releases

Download the binary for your platform from Releases.

Platform Binary
Linux x86_64 thumbsdown-linux-amd64
Linux ARM64 thumbsdown-linux-arm64
macOS ARM64 thumbsdown-macos-arm64

Usage

thumbsdown [OPTIONS] <VIDEO>

Arguments:
  <VIDEO>  Path to the video file

Options:
  -s, --start <START>              Start time in seconds [default: 1]
  -t, --thumbs <THUMBS>            Number of thumbnails to generate [default: 20]
  -c, --columns <COLUMNS>          Number of columns in the grid [default: 5]
  -o, --output <OUTPUT>            Output file path [default: thumbs.png]
  -T, --temp <TEMP>                Temporary directory (default: system temp)
  -w, --width <WIDTH>              Thumbnail width in pixels [default: 320]
  -v, --verbose                    Enable verbose output
  -f, --force                      Overwrite existing output file
  -k, --keep-frames <KEEP_FRAMES>  Keep extracted frames in specified directory
      --no-grid                    Skip grid generation (only extract frames)
  -h, --help                       Print help
  -V, --version                    Print version

Examples

# Basic usage - 20 thumbnails in a 5-column grid
thumbsdown video.mp4

# 12 thumbnails in a 4-column grid, custom output
thumbsdown -t 12 -c 4 -o preview.png video.mp4

# Verbose mode, overwrite existing output
thumbsdown -v -f -t 8 -c 4 video.mp4

# Extract frames only (no grid)
thumbsdown --no-grid -k ./frames video.mp4

# Generate grid and keep individual frames
thumbsdown -k ./frames video.mp4

License

Available as open source under the terms of the MIT License.