# Movie Barcodes
The Lodger: A Story of the London Fog (1927) - Alfred Hitchcock - [Public Domain](https://archive.org/details/TheLodgerAStoryOfTheLondonFog_579)
Circular Barcode | Horizontal Barcode
:-------------------------:|:-------------------------:
 | 
# Overview
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.
# Features
- Horizontal and Circular Barcodes
- Fast frame skipping for efficiency.
- Supports `.mp4`, `.webm` & `.mkv` files
- Multiprocessing support for parallel processing.
- Customizable color extraction function (Average or K-means).
- Progress tracking and estimated time remaining.
# Usage
```bash
# 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)
# Examples
## Sequential Processing
```python
python -m src.main -i "path/to/video" --width 200 -w 1
```
## Parallel Processing
```python
python -m src.main -i "path/to/video" --width 200 -w 8
```
# Development Setup
```bash
# 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"
```
# Todo
- [ ] Optimize K-means to speed up the process
- [ ] Add a small GUI with all options available
- [ ] Add option to modify the barcode's height (current is frame's height)
- [ ] Ensure the software can handle various video formats beyond MP4
- [ ] Allow the software to process multiple videos at once
- [ ] Develop POC on Hugging Face Space
- [ ] Remove the logs creation when using package
# More Examples
## Barbie (2023) - Greta Gerwig
```python
movie-barcodes -i "barbie.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "barbie.mp4" --width 1920 --height 1080 -t "horizontal"
```
Circular Barcode | Horizontal Barcode
:-------------------------:|:-------------------------:
 | 
## Le Fabuleux Destin d'Amélie Poulain (2001) - Jean-Pierre Jeunet
```python
movie-barcodes -i "amelie.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "amelie.mp4" --width 1920 --height 1080 -t "horizontal"
```
Circular Barcode | Horizontal Barcode
:-------------------------:|:-------------------------:
 | 
## Your Name / Kimi no Na wa / 君の名は (2016) - Makoto Shinkai
```python
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
:-------------------------:|:-------------------------:
 | 
## Drive (2011) - Nicolas Winding Refn
```python
movie-barcodes -i "Drive.mp4" -t "circular" -m "smoothed"
movie-barcodes -i "Drive.mp4" --width 1920 --height 1080 -t "horizontal"
```
Circular Barcode | Horizontal Barcode
:-------------------------:|:-------------------------:
 | 
## The Royal Tenenbaums (2001) - Wes Anderson
```python
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
:-------------------------:|:-------------------------:
 | 
Raw data
{
"_id": null,
"home_page": "https://github.com/Wazzabeee/movie-barcodes",
"name": "movie-barcodes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "visualization, python, opencv, color extraction, data science, machine learning, movies, computer vision, multiprocessing, parallel computing, barcode, image processing, multithreading, data visualization, video processing, color barcode",
"author": "Cl\u00e9ment Delteil",
"author_email": "clement45.delteil45@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/e1/e7/1de5b94e32118d0cec00dfb435cd01e5da4b505a42db790ed8711b9d7f3e/movie-barcodes-0.5.4.tar.gz",
"platform": null,
"description": "# Movie Barcodes\nThe Lodger: A Story of the London Fog (1927) - Alfred Hitchcock - [Public Domain](https://archive.org/details/TheLodgerAStoryOfTheLondonFog_579)\n\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n\n\n\n\n\n\n\n\n\n# Overview\n\nCompress every frame of a movie in a single color barcode.\n\nThis 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.\n\nDesigned 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.\n\n# Features\n- Horizontal and Circular Barcodes\n- Fast frame skipping for efficiency.\n- Supports `.mp4`, `.webm` & `.mkv` files\n- Multiprocessing support for parallel processing.\n- Customizable color extraction function (Average or K-means).\n- Progress tracking and estimated time remaining.\n\n# Usage\n```bash\n# Install the package\n$ pip install movie-barcodes\n\n# Generate a movie barcode\n$ movie-barcodes -i \"path/to/video.mp4\"\n\n# Arguments available\nusage: 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]\n```\n\n***Mandatory Arguments:***\n- `-i`, `--input_video_path`: The path to the input video file. (Required, type: str)\n\n***Optional Arguments:***\n- `-d`, `--destination_path`: The path where the output image will be saved. If not provided, defaults to a pre-defined location. (Optional, type: str)\n\n- `-t`, `--barcode_type`: The type of barcode to generate. Options are horizontal or circular. Default is horizontal. (Optional, type: str)\n\n- `-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)\n\n- `-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)\n\n- `--width`: The output image's width in pixels. If not specified, the width will be the same as the input video. (Optional, type: int)\n\n- `--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\n- `-n`, `--output_name`: Custom name for the output barcode image. If not provided, a name will be automatically generated. (Optional, type: str)\n\n- `-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)\n\n# Examples\n## Sequential Processing\n```python\npython -m src.main -i \"path/to/video\" --width 200 -w 1\n```\n## Parallel Processing\n```python\npython -m src.main -i \"path/to/video\" --width 200 -w 8\n```\n\n# Development Setup\n```bash\n# Clone this repository\n$ git clone https://github.com/Wazzabeee/movie-barcodes\n\n# Go into the repository\n$ cd movie-barcodes\n\n# Install requirements\n$ pip install -r requirements.txt\n$ pip install -r requirements_lint.txt\n\n# Install precommit\n$ pip install pre-commit\n$ pre-commit install\n\n# Run tests\n$ pip install pytest\n$ pytest tests/\n\n# Run package locally\n$ python -m src.main -i \"path_to_video.mp4\"\n```\n\n# Todo\n\n- [ ] Optimize K-means to speed up the process\n- [ ] Add a small GUI with all options available\n- [ ] Add option to modify the barcode's height (current is frame's height)\n- [ ] Ensure the software can handle various video formats beyond MP4\n- [ ] Allow the software to process multiple videos at once\n- [ ] Develop POC on Hugging Face Space\n- [ ] Remove the logs creation when using package\n\n# More Examples\n## Barbie (2023) - Greta Gerwig\n```python\nmovie-barcodes -i \"barbie.mp4\" -t \"circular\" -m \"smoothed\"\nmovie-barcodes -i \"barbie.mp4\" --width 1920 --height 1080 -t \"horizontal\"\n```\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n## Le Fabuleux Destin d'Am\u00e9lie Poulain (2001) - Jean-Pierre Jeunet\n```python\nmovie-barcodes -i \"amelie.mp4\" -t \"circular\" -m \"smoothed\"\nmovie-barcodes -i \"amelie.mp4\" --width 1920 --height 1080 -t \"horizontal\"\n```\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n## Your Name / Kimi no Na wa / \u541b\u306e\u540d\u306f (2016) - Makoto Shinkai\n```python\nmovie-barcodes -i \"Your Name.mp4\" -t \"circular\" -m \"smoothed\"\nmovie-barcodes -i \"Your Name.mp4\" --width 1920 --height 1080 -t \"horizontal\"\n```\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n## Drive (2011) - Nicolas Winding Refn\n```python\nmovie-barcodes -i \"Drive.mp4\" -t \"circular\" -m \"smoothed\"\nmovie-barcodes -i \"Drive.mp4\" --width 1920 --height 1080 -t \"horizontal\"\n```\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n## The Royal Tenenbaums (2001) - Wes Anderson\n```python\nmovie-barcodes -i \"royal_tenenbaums.mp4\" -t \"circular\" -m \"smoothed\"\nmovie-barcodes -i \"royal_tenenbaums.mp4\" --width 1920 --height 1080 -t \"horizontal\"\n```\nCircular Barcode | Horizontal Barcode\n:-------------------------:|:-------------------------:\n | \n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "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.",
"version": "0.5.4",
"project_urls": {
"Homepage": "https://github.com/Wazzabeee/movie-barcodes"
},
"split_keywords": [
"visualization",
" python",
" opencv",
" color extraction",
" data science",
" machine learning",
" movies",
" computer vision",
" multiprocessing",
" parallel computing",
" barcode",
" image processing",
" multithreading",
" data visualization",
" video processing",
" color barcode"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "322018d83c8b3c2aef069204201155b41d7baa7af04e82b570405afa123b22c5",
"md5": "0ee05db96071da78880b7b123a52ab8a",
"sha256": "90446871830ed2ab9a68d7ded9e54582a38228bc1289a12b7091a3e6db033725"
},
"downloads": -1,
"filename": "movie_barcodes-0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0ee05db96071da78880b7b123a52ab8a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 27852,
"upload_time": "2024-09-01T15:29:54",
"upload_time_iso_8601": "2024-09-01T15:29:54.724461Z",
"url": "https://files.pythonhosted.org/packages/32/20/18d83c8b3c2aef069204201155b41d7baa7af04e82b570405afa123b22c5/movie_barcodes-0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e1e71de5b94e32118d0cec00dfb435cd01e5da4b505a42db790ed8711b9d7f3e",
"md5": "0f041c5e97e1158af324343ffba59148",
"sha256": "1d3a715e95e899efa96b148ede2e23c1ba8c0c78b2dea64d0b496891a04e3c58"
},
"downloads": -1,
"filename": "movie-barcodes-0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "0f041c5e97e1158af324343ffba59148",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 23843,
"upload_time": "2024-09-01T15:29:55",
"upload_time_iso_8601": "2024-09-01T15:29:55.744127Z",
"url": "https://files.pythonhosted.org/packages/e1/e7/1de5b94e32118d0cec00dfb435cd01e5da4b505a42db790ed8711b9d7f3e/movie-barcodes-0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-01 15:29:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Wazzabeee",
"github_project": "movie-barcodes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "movie-barcodes"
}
JSON
