https://github.com/alexheretic/vimg
CLI for video images. Generates animated video contact sheets fast.
https://github.com/alexheretic/vimg
Last synced: 4 days ago
JSON representation
CLI for video images. Generates animated video contact sheets fast.
- Host: GitHub
- URL: https://github.com/alexheretic/vimg
- Owner: alexheretic
- License: mit
- Created: 2023-03-08T20:59:13.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-12T15:38:28.000Z (17 days ago)
- Last Synced: 2025-04-12T16:40:59.368Z (17 days ago)
- Language: Rust
- Size: 2.08 MB
- Stars: 21
- Watchers: 2
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vimg
CLI for video images. Generate animated video contact sheets fast.
Uses _ffmpeg_.
_Note: Support for animated avif isn't everywhere yet, try viewing with firefox/chromium._
### Command: vcs
Create a new contact sheet for a video.
Extracts capture frames and joins into sheet(s) then encodes into an animated, or static, vcs avif.
```
vimg vcs [OPTIONS] -c -H -n
```
See [examples](examples.md).
### Command: extract
Extract capture bmp images from a video using ffmpeg.
```
vimg extract [OPTIONS] -n
```
### Command: join
Join same-sized capture images into a single grid image.
```
vimg join [OPTIONS] --columns --output ...
```
## Install
### Arch Linux
Available in the [AUR](https://aur.archlinux.org/packages/vimg).
### Windows
Pre-built **vimg.exe** included in the [latest release](https://github.com/alexheretic/vimg/releases/latest).
### Using cargo
Latest release
```sh
cargo install vimg
```
Latest code direct from git
```sh
cargo install --git https://github.com/alexheretic/vimg
```
### Requirements
**ffmpeg** that's not too old should be in `$PATH`.
## Minimum supported rust compiler
Maintained with [latest stable rust](https://gist.github.com/alexheretic/d1e98d8433b602e57f5d0a9637927e0c).