Extract frames

A Rust-based command-line application for extracting frames from video files using FFmpeg, supporting both sequential and parallel processing modes.

Table of Contents

• Features
• Usage
• Command Line Arguments
• Requirements
• Development
• Building and Testing
• Contributing
• Troubleshooting

Features

• Support for parallel processing using multiple CPU cores
• Robust error handling for file operations and FFmpeg interactions
• Comprehensive test suite for core functionality

Usage

The application provides several command-line options to control frame extraction.

Basic Usage

To extract frames from a video file using default settings (every 30th frame):

cargo run -- --file input.mp4

The extracted frames will be saved as PNG files in the frames directory.

Extract One Frame Per Second

To extract one frame per second using the seek-based method:

cargo run -- --file input.mp4 --use-seek

Parallel Processing

To enable parallel processing by splitting the video into segments and processing them concurrently:

cargo run -- --file input.mp4 --multicore

Command Line Arguments

• --file <PATH>: Specify input video file (default: "video.mp4")
• --use-seek: Enable seek-based frame extraction (one frame per second)
• --multicore: Enable parallel processing using multiple CPU cores

Requirements

• FFmpeg installed and available in system PATH
• Rust toolchain (including cargo)

Development

To contribute to this project, you'll need:

1. Rust toolchain (nightly version recommended)
2. just init-macos or just init-linux

Building and Testing

1. Clone the repository
2. Run just build to compile the application
3. Run just test to execute the test suite
4. Run cargo run -- --help to see command-line options

Building on Ubuntu

You need to install these packages:

sudo apt install libavcodec-dev libavformat-dev libswscale-dev libavfilter-dev libavdevice-dev libavutil-dev yasm

Contributing

Contributions are welcome! Please submit pull requests with clear descriptions of changes and ensure that all tests pass before submitting.

Troubleshooting

• If you encounter issues with FFmpeg, ensure it's installed and available in your system's PATH.
• If you experience errors during parallel processing, verify that your system has sufficient resources (CPU cores and memory).
• For other issues, please check the issues page or submit a new issue with detailed information about your problem.