Smart Encoder

Smart Encoder is a powerful tool for video encoding that optimizes video quality while minimizing file size. It automatically selects the best encoding parameters based on video content and desired output characteristics.

Features

Automatic Codec Selection: Automatically selects the best video codec for encoding (default: libsvtav1).
CRF Optimization: Finds the optimal Constant Rate Factor (CRF) for the best quality-to-size ratio by ab-av1. If
suitable crf cannot be defined, use MANUAL_CRF(default: 23, usually recognized as visually lossless). If encoded file
size > original file size, increment CRF by MANUAL_CRF_INCREMENT_PERCENT (default: 15%) and encode again, until
encoded file size is smaller than original one.
Multi-Process Encoding: Supports encoding multiple files in parallel to speed up the process. # of processors can
be configured by command-line.
Comprehensive Logging: Logs success and error details for easy troubleshooting and monitoring.
Flexible Configuration: Customizable settings for advanced users through configuration files.

Requirements

Python 3.7+
FFmpeg installed and added to PATH
ab-av1 added to PATH for searching best codec and CRF.

Installation

Clone the repository:

git clone https://github.com/kerasty2024/smart_encoder.git
cd smart_encoder

Create a virtual environment and activate it:

python -m venv venv
venv/bin/activate  # On Windows use `venv\Scripts\activate`

Install the required packages:
```
pip install -r requirements.txt
```
Ensure FFmpeg & ab-av1 and so on (refer to Requirements) is installed and accessible from your command line.

Usage

Prepare your media files: Place the media files you want to encode in a source directory.

Run the encoder:

python -O main.py --processes 3 --move-raw-file  # you can also modify # of processes, depending on how powerful your environmet is.

Use --manual-mode if you wish to manually set encoding parameters. manual crf can be set in settings/video.py

python -O main.py --processes 1 --move-raw-file --manual-mode # you can also modify # of processes, depending on how powerful your environmet is.

If you want more message shown in console, remove -O option (change to debug mode).
other options can be found in main.py

Check logs:

Success logs are stored in the output directory with details of encoded files.
Error logs are available in the same directory for any issues encountered during encoding.

Configuration

.py files in settings directory allow you to adjust default settings for encoding parameters and language detection preferences. Customize this file to suit your needs before running the encoder.