Freedom251 › Desktop Wallpaper Software
Superpaper

What Superpaper is
Superpaper is a free, open-source wallpaper manager for multi-monitor computers, with support for Linux and Windows and partial support for macOS. It can place a single image across all displays, assign separate images to individual displays, or span images across groups of displays. Its advanced spanning controls include pixel-density, bezel, and perspective corrections, along with manual pixel offsets. Superpaper also supports slideshows from local sources, configurable file order, and a tray applet for slideshow control. For automation, it provides a command-line interface and can run a script after a wallpaper change. Listed Linux environments and window managers include KDE, XFCE, GNOME, Cinnamon, LXDE/LXQt, MATE, Budgie, Pantheon, i3, and BSPWM. Linux users can install an AppImage or follow the project's PyPI instructions, which require Python 3.6 or later. Windows users can choose an installer or portable package for Windows 10 and 11. The MIT License governs the project. macOS support is partial: it has no hotkeys, and installation requires setting up dependencies and running the project. The command-line interface cannot configure or use perspective settings, and adding wallpapers by folder does not include subfolders.
Who it suits
Superpaper suits people who manage wallpaper across multiple displays on Linux or Windows and want control over image spanning, alignment, or local slideshows. It may also suit users who want command-line or script-based automation, provided their needed settings are available through those routes.
What it does well
- Supports one image, separate images, or spanning across display groups.
- Includes pixel-density, bezel, and perspective corrections for spanning.
- Offers local slideshows with configurable file order.
- Can run a script after a wallpaper change.
- Free and open source under the MIT License.
- Provides Linux AppImage and Windows installer or portable downloads.
What to know first
- macOS support is partial, with no hotkeys.
- macOS installation requires setting up dependencies and running the project.
- Perspective settings are unavailable through the command-line interface.
- Wallpaper folders do not include their subfolders.
Limits
macOS support is partial, with no hotkeys, and requires dependency setup and running the project. The command-line interface cannot configure or use perspective settings. Adding wallpapers by folder excludes subfolders.
Getting started
- Open the project at https://github.com/hhannine/superpaper.
- On Linux, download the AppImage or follow the PyPI installation instructions with Python 3.6 or later.
- On Windows 10 or 11, use the installer or portable package.
- On macOS, set up the required dependencies and run the project.
- Choose whether to use one image across displays, separate images, or spanning across display groups.
- For slideshows, select local sources and configure file order.
Verdict
Choose Superpaper if you need detailed multi-monitor wallpaper placement on Linux or Windows, especially with local slideshows or automation. It is free and open source. macOS users should account for partial support, and command-line users cannot configure perspective settings.
Questions
Is Superpaper free?
Yes. Superpaper is free and open source under the MIT License.
Which operating systems does it support?
It supports Linux and Windows, with partial support for macOS. Windows downloads are for Windows 10 and 11.
How can I install it on Linux?
Linux downloads include an AppImage. The project also documents installation from PyPI with Python 3.6 or later.
What can it do across multiple displays?
It can use one image across all displays, different images per display, or span images across display groups. Spanning options include pixel-density, bezel, and perspective corrections and manual pixel offsets.
Can Superpaper run slideshows?
Yes. It supports slideshows from local sources, configurable file order, and a tray applet for control.
Are perspective settings available from the command line?
No. Perspective settings cannot currently be configured or used through the command-line interface.
Facts from Superpaper's own pages
- Advanced spanning
- Advanced span mode includes pixel-density, bezel, and perspective correction, plus manual pixel offsets. · github.com, 11 Oct 2026
- Automation
- It offers a command-line interface and can run a script after a wallpaper change. · github.com, 4 Oct 2026
- CLI limit
- Perspective settings cannot currently be configured or used through the command-line interface. · github.com, 4 Oct 2026
- CLI limitation
- Perspective settings cannot currently be configured or used through the command-line interface. · github.com, 11 Oct 2026
- Custom commands
- Users can supply a custom command to set the wallpaper when their system is not built in. · github.com, 11 Oct 2026
- Display layouts
- It can set one image across all displays, different images per display, or span images across groups of displays. · github.com, 4 Oct 2026
- Downloads
- The project provides a Linux AppImage and Windows installer and portable package; macOS requires installing dependencies and running the project. · github.com, 11 Oct 2026
- Known limitation
- The README says macOS support is partial and hotkeys are unavailable on macOS. · github.com, 11 Oct 2026
- License
- The repository publishes Superpaper under the MIT License, which permits use, copying, modification, distribution, sublicensing, and sale subject to its terms. · github.com, 11 Oct 2026
- Linux environments
- Listed supported Linux desktop environments and window managers include KDE, XFCE, GNOME, Cinnamon, LXDE/LXQt, MATE, Budgie, Pantheon, i3, and BSPWM. · github.com, 4 Oct 2026
- Linux installation
- Linux users can install Superpaper from PyPI, which requires Python 3.6 or later, or use the AppImage package. · github.com, 11 Oct 2026
- Linux support
- The project lists support for desktop environments and window managers including KDE, GNOME, XFCE, Cinnamon, i3, and BSPWM. · github.com, 11 Oct 2026
- macOS limit
- The project says macOS support is partial, with no hotkeys, and that installation requires setting up dependencies and running the project. · github.com, 4 Oct 2026
- Purpose
- Superpaper is a cross-platform multi-monitor wallpaper manager. · github.com, 11 Oct 2026
- Slideshow
- It supports slideshows with configurable file order from local sources and offers a tray applet for slideshow control. · github.com, 11 Oct 2026
- Support
- The project README asks users who find Superpaper useful to consider supporting development through PayPal or GitHub Sponsors. · github.com, 11 Oct 2026
- Troubleshooting
- The README directs users to enable logging or run Superpaper with --debug, then check the logs and create an issue if problems occur. · github.com, 11 Oct 2026
- Wallpaper folder limit
- When adding wallpapers by folder, the project says subfolders are not included. · github.com, 4 Oct 2026
- Wallpaper layouts
- It can set one image across all displays, use a different image on each display, or span images across groups of displays. · github.com, 11 Oct 2026
- Windows installation
- A Windows installer and portable package are available for Windows 10 and 11. · github.com, 4 Oct 2026
Where Superpaper stands on Freedom251
- Desktop Wallpaper Software#22 of 34