https://github.com/vpakarinen/image-video-converter
automating image and video conversion.
https://github.com/vpakarinen/image-video-converter
automation command-line ffmpeg file-processing filesystem-monitoring image-processing open-source productivity python utilities utility video-processing watchdog
Last synced: 11 months ago
JSON representation
automating image and video conversion.
- Host: GitHub
- URL: https://github.com/vpakarinen/image-video-converter
- Owner: vpakarinen
- License: mit
- Created: 2024-11-07T19:14:46.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-10T11:48:58.000Z (about 1 year ago)
- Last Synced: 2024-12-22T02:50:06.854Z (about 1 year ago)
- Topics: automation, command-line, ffmpeg, file-processing, filesystem-monitoring, image-processing, open-source, productivity, python, utilities, utility, video-processing, watchdog
- Language: Python
- Homepage:
- Size: 36.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Overview
Python application to automate the image and video conversion.
## Features
- **Command-Line Interface (CLI):** Allows users to specify input/output directories and target formats.
- **Configuration Management:** Easy-to-edit `config.yaml` configuration file to adjust settings.
- **Automatic Directory Monitoring:** Watches a specific folder for new image or video files.
- **Extensible Architecture:** Easily add support for additional formats in the future.
- **Robust Logging:** Tracks conversion processes and errors.
## Supported Formats
### Image Formats
- **JPG/JPEG**
- **PNG**
- **BMP**
- **WEBP**
- **RAW**
### Video Formats
- **MP4**
- **AVI**
- **MKV**
- **MOV**
- **WebM**
## Technology Stack
- **Logging:** Python's built-in `logging` module
- **Configuration Management:** [PyYAML](https://pyyaml.org/)
- **Programming Language:** Python 3.x
- **Directory Monitoring:** [Watchdog](https://python-watchdog.readthedocs.io/)
- **Video Processing:** [MoviePy](https://zulko.github.io/moviepy/)
- **Image Processing:** [Pillow](https://python-pillow.org/)
- **CLI Parsing:** [Argparse](https://docs.python.org/3/library/argparse.html)
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/vpakarinen/image-video-converter.git
cd image-video-converter
```
2. **Create a Virtual Environment** (Optional but Recommended)
```bash
python3 -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. **Install Dependencies**
```bash
pip install -r requirements.txt
```
## Usage
### 1. **Setup Folders**
Ensure that the `input` and `output` directories exist in the project's root directory.
### 2. **Run the Application**
It's essential to run the application first before adding files to the `input` folder to ensure real-time detection.
**Note:** Running the application without any arguments will use the default settings specified in `config/config.yaml`.
### 3. **Add Files for Conversion**
With the application running, add your image or video files to the `input` directory.