Compress every frame of a movie in a single color barcode. Transform entire movies into stunning single-barcode visualizations. Capture the essence of cinematic storytelling through dominant color extraction from each frame.
GPL-2.0 License
The Lodger: A Story of the London Fog (1927) - Alfred Hitchcock - Public Domain
Circular Barcode | Horizontal Barcode |
---|---|
Compress every frame of a movie in a single color barcode.
This project is a robust and highly configurable utility designed to extract dominant colors from video files and generate color barcodes. Built with Python and OpenCV, the tool offers multiple algorithms for color extraction, including average color, K-means clustering, and HSV/BGR histograms. The output can be generated in various forms, like horizontal and circular barcodes, providing a visually intuitive summary of the color distribution in the video.
Designed with performance in mind, the application supports both sequential and parallel processing. It scales automatically based on the available CPU cores but can be fine-tuned for a specified number of workers. This makes it suitable for analyzing both short clips and full-length movies with high efficiency.
.mp4
, .webm
& .mkv
files# Install the package
$ pip install movie-barcodes
# Generate a movie barcode
$ movie-barcodes -i "path/to/video.mp4"
# Arguments available
usage: movie-barcodes [-h] -i INPUT_VIDEO_PATH [-d [DESTINATION_PATH]] [-t {horizontal,circular}] [-m {avg,kmeans,hsv,bgr,smoothed}] [-w WORKERS] [--width WIDTH] [--height HEIGHT] [-n [OUTPUT_NAME]] [-a]
Mandatory Arguments:
-i
, --input_video_path
: The path to the input video file. (Required, type: str)Optional Arguments:
-d
, --destination_path
: The path where the output image will be saved. If not provided, defaults to a pre-defined location. (Optional, type: str)
-t
, --barcode_type
: The type of barcode to generate. Options are horizontal or circular. Default is horizontal. (Optional, type: str)
-m
, --method
: The algorithm for extracting the dominant color from frames. Options are avg (average), kmeans (K-Means clustering), hsv (HSV histogram), bgr (BGR histogram) and smoothed versions. Default is avg. (Optional, type: str)
-w
, --workers
: Number of parallel workers for processing. By default, the script will use all available CPU cores. Setting this to 1 will use sequential processing. (Optional, type: int)
--width
: The output image's width in pixels. If not specified, the width will be the same as the input video. (Optional, type: int)
--height
: The output image's height in pixels. If not specified, the height will be the same as the input video. (Optional, type: int)
-n
, --output_name
: Custom name for the output barcode image. If not provided, a name will be automatically generated. (Optional, type: str)
-a
, --all_methods
: If set to True, all methods for color extraction will be employed, overriding the --method argument. Default is False. (Optional, type: bool)
python -m src.main -i "path/to/video" --width 200 -w 1
python -m src.main -i "path/to/video" --width 200 -w 8
# Clone this repository
$ git clone https://github.com/Wazzabeee/movie-barcodes
# Go into the repository
$ cd movie-barcodes
# Install requirements
$ pip install -r requirements.txt
$ pip install -r requirements_lint.txt
# Install precommit
$ pip install pre-commit
$ pre-commit install
# Run tests
$ pip install pytest
$ pytest tests/
# Run package locally
$ python -m src.main -i "path_to_video.mp4"
movie-barcodes -i "barbie.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "barbie.mp4" --width 1920 --height 1080 -t "horizontal"
Circular Barcode | Horizontal Barcode |
---|---|
movie-barcodes -i "amelie.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "amelie.mp4" --width 1920 --height 1080 -t "horizontal"
Circular Barcode | Horizontal Barcode |
---|---|
movie-barcodes -i "Your Name.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "Your Name.mp4" --width 1920 --height 1080 -t "horizontal"
Circular Barcode | Horizontal Barcode |
---|---|
movie-barcodes -i "Drive.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "Drive.mp4" --width 1920 --height 1080 -t "horizontal"
Circular Barcode | Horizontal Barcode |
---|---|
movie-barcodes -i "royal_tenenbaums.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "royal_tenenbaums.mp4" --width 1920 --height 1080 -t "horizontal"
Circular Barcode | Horizontal Barcode |
---|---|