wallcrop 0.0.4

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.

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

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