video2image
Video2Image is a Python command-line tool that extracts frames from video files and saves them as individual images. It supports batch processing of multiple video files and provides a progress bar for tracking extraction status.
Features:
- Extract frames from single video or batch process entire directories
- Support for multiple video formats (MP4, MKV, AVI, MOV)
- Output in JPG or PNG format
- Progress bar with frame count display
- Automatic output folder creation
Installation
pip install video2image
Usage
Extract frames from a single video
video2image -i /path/to/video.mp4 -o /path/to/output/folder
Extract frames from all videos in a directory
video2image -i /path/to/video/directory -o /path/to/output/folder
Command-line options
| Option | Description |
|---|---|
-i, --input |
Path to input video file or directory (required) |
-o, --output |
Path to output directory (default: same as input) |
-p, --parent |
Include parent directory in output path |
-f, --format |
Image format: jpg or png (default: jpg) |
-H, --show-help |
Show help message |
Examples
# Extract frames as PNG
video2image -i video.mp4 -o ./frames -f png
# Extract with parent directory structure
video2image -i /videos/project1/clip.mp4 -o /output -p
# Process all videos in current directory
video2image -i . -o ./extracted_frames
Building from Source
# Clone the repository
git clone https://github.com/sakthivelj/video2image.git
cd video2image
# Create virtual environment (optional)
python -m venv venv
source venv/bin/activate # Linux/Mac
# or: venv\Scripts\activate # Windows
# Install in development mode
pip install -e .
Requirements
- Python 3.8+
- opencv-python
- tqdm
License
This project is licensed under the MIT License. See the LICENSE file for details.
Author
Sakthivel J - sakthivel1023@gmail.com
Links
Metadata
Release files for video2image 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| video2image-1.4.0.tar.gz | 15.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| video2image-1.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.6 kB
Release files / video2image-1.4.0.tar.gz
| Download URL | video2image-1.4.0.tar.gz |
|---|---|
| Size | 15.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e83279b25cc238276d4affec14f2209892d34d667de76ed9538745bf9159190
|
|
BLAKE2b-256 checksum How to use checksums |
ce9724bdbf6b523411eb4b3cbf01d72c10cd581aeaa315ce43aaf265e43c6b98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|
Release files / video2image-1.4.0-py3-none-any.whl
| Download URL | video2image-1.4.0-py3-none-any.whl |
|---|---|
| Size | 14.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3b5d2629557e8bada1036bc0139498f2ba9f6f1bc48de32ba98c379e3c421a81
|
|
BLAKE2b-256 checksum How to use checksums |
0148d982f16cc8934bd3b5865e1b57457d6e0d476bb22948fcfc4f5ce2fec4cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.15
|