Skip to main content

video2image

PyPI version Python 3.8+ License: MIT Build Status GitHub stars GitHub forks

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)

Source distribution for video2image 1.4.0
File Size Uploaded
video2image-1.4.0.tar.gz 15.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for video2image 1.4.0
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

1.4.0 This release

2 release files

1.3.0

2 release files

1.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page