wallcrop 0.0.5

A tool for cropping an image into smaller images for use as individual desktop wallpapers

Wallcrop

Wallcrop is a simple tool for cropping an image into smaller images for use as individual desktop wallpapers in a multi-monitor setup.

It can either arrange by size in pixels, or by the actual size of the monitors in cm.

Installation:

The easiest way to install would be using pip in a virtual environment:

python -m venv venv
source venv/bin/activate
pip install wallcrop

Usage

In order to crop up some images you need to let wallcrop know about your monitor setup. This is done in a yaml file, here called monitors.yml, an example for this file can be found in examples/monitors.yml.

The monitors.yml contains a list of monitors, each with a name, height and width of the monitor (if your monitor is vertical just swap these) and x and y position of the top left corner of the monitor in pixels. If you want to use the actual-monitor-size option (arranging not by the size in pixels, but the actual size of the screens in cm) you need to additionally add values for x_cm, y_cm, width_cm and height_cm for each monitor. Gaps between monitors should be accounted for in x_cm and y_cm.

To crop all images in a folder use

wallcrop -m path/to/your/monitors.yml path/to/your/images/*

For more options see

wallcrop -h

wallswitch

as a treat, there also is wallswitch for setting the wallpapers following the wallcrop structure. this currently only supports swww as a wallpaper daemon and only works if the names of the monitors in the monitors.yml correspond to the names of the outputs

creating the monitors file on Hyprland

There is also an experimental tool for automatically creating a monitors.yml from your hyprland config, see

wallcrop_create_monitors -h

for more info