optilibre 2.2.0

Video and Image optimizer

Optilibre

Optilibre is a simple python program to automatically optimize video and images files using ffmpeg and other image optimizers. See Supported formats to have a list of supported file format you can convert to/from.

Official repo : https://gitlab.com/daufinsyd/optilibre

Installation

Simply install it using pip:

pip3 install optilibre

Usage

Copy the optilibre.example.conf to optilibre.conf and change the values according to your need.

optilibre optimize --config /path/to/opilibre.conf

You can find a systemd service and timer in systemd folder, which you can copy to /etc/systemd/system/ .

Requirements

See Supported formats .

Configuration

Copy and edit optilibre.example.conf to optilibre.conf . For each folder you want to process, create a new entry as shown in the example file.

You can put the configuration of a section in another optilibre.toml configuration file (see optiimage.example.toml and optivideo.example.toml for an example) by referencing it in optilibre.conf.

Video

• The directive [optivideo] configure the video encoder.
• The directive [optivideo.meta] defines which meta args should ffmpeg use.
• The directive [optivideo.audio] defines which codec should ffmpeg use to audio.
• The directive [optivideo.video] defines which codec should ffmpeg use to video.
• The directive [optivideo.codecs.CODEC] defines a list of options for ffmpeg to be passed through. See man ffmpeg.
• The directive [optivideo.filters] configure filters to exclude videos not matching the filters.

Filters

• min_file_size_mb : minimum size for the image in MB to be considered for processing
• min_storage_density : minimum size per pixel per second for the video to be considered for processing (ignores fps)

Image

• The directive [optiimage] configure the image encoder.
• The directive [optiimage.codecs.CODEC] defines a list of options for the image encoder to be passed through. See man <image_encoder>.
• The directive [optiimage.filters] configure filters to exclude images not matching the filters.

Filters

• min_file_size_mb : minimum size for the image in MB to be considered for processing
• min_bpp : minimum bits per pixel for the image to be considered for processing

Supported formats

Video

• any -> h264 (requires ffmpeg with libx264 encoder)
• any -> h265 (requires ffmpeg with libx265 encoder)

Images

• jpeg -> jpeg (requires jpegoptim)
• any jpeg -> jpeg-xl (requires cjxl)