Skip to main content

a convenient Python library for capturing cover image from video

Project description

CoverSnap

A convenient Python library for capturing cover image from video.

codecov CI-test pip-test Release PyPI version GitHub

Installation

You can install CoverSnap using pip (python >= 3.8):

pip install coversnap

CLI

usage: coversnap [-h] -i INPUT -o OUTPUT

Capture image from video and save it to file, return black image if failed

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --INPUT INPUT
                        absolute path to input video
  -o OUTPUT, --OUTPUT OUTPUT
                        absolute path to output image

Python

To capture a cover image from a video, use the capture_image function provided by the CoverSnap library. Here's an example of how to use it:

import os
import cv2
from coversnap import capture_image

input_video = "path/to/video.mp4"
output_image = "path/to/output.jpg"

# Capture the cover image from the video
img = capture_image(input_video)

# Save the captured image to the specified file
_, file_extension = os.path.splitext(output_image)
cv2.imencode(file_extension, img)[1].tofile(output_image)

Development

Environment Setup

Before getting started with development, make sure you have the following tools and dependencies installed:

  • Python 3.8 or higher
  • PDM (Python Development Master)

Installing Development Dependencies

In the project's root directory, run the following command to install the development dependencies:

pdm run dev

Running Tests

pdm run test

This will run the tests and generate test coverage reports. The test results will be displayed in the terminal, and XML and HTML format coverage reports will also be generated.

Code Style Checking and Static Type Checking

pdm run lint

This will run the code style checking and static type checking. The results will be displayed in the terminal.

License

CoverSnap is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coversnap-0.0.4.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

coversnap-0.0.4-py3-none-any.whl (5.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page