Using your own media

Custom Themes

Images are organized as “themes”, by directory.

Put your images under ~/.lebiniou/images/<my_theme_name>.

Then start, using the -t switch with your theme name, prefixed with a ~:

$ lebiniou -t ~my_theme_name

Or a comma-separated list of themes:

$ lebiniou -t ~theme1,~theme2

Use the images from lebiniou-data package by removing the leading ~:

$ lebiniou -t biniou,zebulon,~theme1,~theme2

Since version 3.54.0, themes can be selected in the settings screen of the web interface.

For older versions, set this in your ~/.lebiniourc configuration file. For example:

[Engine]
Themes = biniou,~theme1,~theme2

Aspect Ratio

Le Biniou stretches the images to fit the entire output screen (default output resolution is 960x540).

If you prefer to preserve their aspect ratio, you will need to edit them so it matches the Le Biniou's output one. It consists in putting the images in a “black box” with the desired aspect ratio.

Be aware that it could not look good in Le Biniou, depending on the images (for example photos).

A quick solution is to use ImageMagick:

Installation for Debian-based distributions:

sudo apt install imagemagick

Then in a terminal:

convert input_image -resize 960x540 -background black -gravity center -extent 960x540 output_image

Replace the two 960x540 occurrences with the Le Biniou output resolution you use if it's not the default one.

You can also use another color background than black.

If you want to convert a whole folder/theme, you'll need to use the mogrify command instead. It overwrites the files, so you should make a backup if you want to keep the original files:

cp -r my_theme my_theme_backup
mogrify -resize 960x540 -background black -gravity center -extent 960x540 my_theme/*