Metadata-Version: 2.4
Name: panescape
Version: 0.3.1
Summary: True-to-scale wallpapers across monitors of different sizes, resolutions and orientations (Linux: GNOME, KDE Plasma, sway, Hyprland)
Author: Kieran Ralston
License-Expression: MIT
Project-URL: Homepage, https://github.com/keo99/panescape
Project-URL: Documentation, https://keo99.github.io/panescape/
Project-URL: Issues, https://github.com/keo99/panescape/issues
Keywords: wallpaper,multi-monitor,gnome,slideshow,bezel
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications :: Qt
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Desktop Environment
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10.1
Requires-Dist: ruamel.yaml>=0.18
Provides-Extra: gui
Requires-Dist: PySide6-Essentials>=6.5; extra == "gui"
Requires-Dist: keyring>=23; extra == "gui"
Provides-Extra: photo
Requires-Dist: numpy>=1.24; extra == "photo"
Requires-Dist: pillow-heif>=0.13; extra == "photo"
Provides-Extra: test
Requires-Dist: pytest>=7; extra == "test"
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# panescape

[![CI](https://github.com/keo99/panescape/actions/workflows/ci.yml/badge.svg)](https://github.com/keo99/panescape/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/panescape)](https://pypi.org/project/panescape/)

**True-to-scale wallpapers for multi-monitor setups on Linux.** Your monitors
become panes of one window onto a single picture, even when they differ in size,
resolution, orientation and height.

![The same photo spanned by pixels (top) and by panescape (bottom) across two portrait 28" 4K screens and a lower landscape 24" 1080p screen](https://raw.githubusercontent.com/keo99/panescape/main/docs/images/comparison.jpg)

Most spanning tools work in **pixels**. A 28" 4K panel packs about 1.7× more
pixels per millimetre than a 24" 1080p panel, so with pixel spanning the picture
changes size at every screen edge and the horizon breaks. panescape works in
**millimetres**. It uses each panel's real lit area, the bezels, the gaps and the
vertical offsets you measure. Then it resamples each monitor's slice to that
monitor's native resolution.

**Documentation: [keo99.github.io/panescape](https://keo99.github.io/panescape/)**

## Install

```bash
pipx install 'panescape[gui]'    # or without [gui] for the command line only
panescape-gui
```

Linux with Python 3.10 or newer. Wallpapers and slideshows are applied on
**GNOME**, **KDE Plasma 6**, **sway** and **Hyprland**; on other desktops
panescape makes per-monitor images for your own tool
([Desktops](https://keo99.github.io/panescape/desktops/)).

## The Window

[![The layout editor](https://raw.githubusercontent.com/keo99/panescape/main/docs/images/gui-layout.png)](https://keo99.github.io/panescape/window/)

Describe your desk to scale (angled screens too), calibrate it on your real screens
or from phone photos, tag and frame
your pictures, find new ones on Unsplash, and apply one picture or a
slideshow that changes every screen at once. A *Getting started* guide walks
you through it the first time. See [The Window](https://keo99.github.io/panescape/window/).

## Quick Start on the Command Line

```bash
mkdir ~/panescape && cd ~/panescape
panescape init                     # pictures/, configurations/, backgrounds/, setup.yml
panescape detect --write my_desk   # a layout from your current displays
$EDITOR configurations/my_desk.yml # set gaps, offsets, bezels (mm)
panescape calibrate --watch        # test pattern; re-applies on every save
cp ~/Pictures/some-wide-photo.jpg pictures/
panescape make                     # check backgrounds/my_desk/*/preview.jpg
panescape apply
```

`preview.jpg` draws your desk to scale. The yellow outline is the part of the photo that was used:

![Preview of the example desk](https://raw.githubusercontent.com/keo99/panescape/main/docs/images/preview.jpg)

More: [Getting Started](https://keo99.github.io/panescape/getting-started/), [Configuration](https://keo99.github.io/panescape/configuration/),
[Command Line](https://keo99.github.io/panescape/cli/).

## Contributing

Bug reports and pull requests are welcome, especially new monitor models and
backends for more desktops. See [Development](https://keo99.github.io/panescape/development/).

## Credits

Images use "Panorama of the valley of the Triglav mountain massif" by
otrow_photography, released under
[CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/) via
[Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Panorama_of_the_valley_of_the_Triglav_mountain_massif.jpg).
The Unsplash tab is for personal use with your own key; panescape is not
affiliated with or endorsed by Unsplash.

## License

MIT © Kieran Ralston
