Metadata-Version: 2.4
Name: keyframe-scout
Version: 0.1.0
Summary: Intelligent video keyframe extraction tool
Home-page: https://github.com/cjj198909/keyframe-scout
Author: Jiajun Chen
Author-email: cjj198909@gmail.com
Project-URL: Bug Tracker, https://github.com/cjj198909/keyframe-scout/issues
Project-URL: Documentation, https://github.com/cjj198909/keyframe-scout#readme
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Video
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python>=4.5.0
Requires-Dist: numpy>=1.19.0
Requires-Dist: Pillow>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-cov>=2.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Requires-Dist: mypy>=0.910; extra == "dev"
Requires-Dist: pre-commit>=2.15; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# KeyFrame Scout 🎬

[![PyPI version](https://badge.fury.io/py/keyframe-scout.svg)](https://badge.fury.io/py/keyframe-scout)
[![Python Support](https://img.shields.io/pypi/pyversions/keyframe-scout.svg)](https://pypi.org/project/keyframe-scout/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Intelligent video keyframe extraction tool that automatically identifies and extracts the most representative frames from videos using motion, scene, and content analysis.

## ✨ Features

- **Smart Frame Selection**: Automatically identifies frames with significant changes using optical flow, scene detection, and content analysis
- **Multiple Extraction Modes**:
  - `adaptive`: Automatically adjusts frame count based on video duration
  - `interval`: Extract frames at fixed time intervals
  - `fixed`: Extract a specific number of frames
- **Resolution Control**: Output frames at original or preset resolutions (1080p, 720p, 480p, etc.)
- **Batch Processing**: Process multiple videos in one command
- **Flexible Output**: Support for JPEG and PNG with quality control
- **Progress Tracking**: Real-time analysis progress updates

## 📦 Installation

```bash
pip install keyframe-scout
