Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anufrievroman/waypaper
GUI wallpaper manager for Wayland and Xorg Linux systems
https://github.com/anufrievroman/waypaper
feh gtk3 hyprland i3 linux swaybg swaywm swww wallpaper wallpaper-app wallpaper-changer wallpaper-manager wayland-compatibility
Last synced: 3 months ago
JSON representation
GUI wallpaper manager for Wayland and Xorg Linux systems
- Host: GitHub
- URL: https://github.com/anufrievroman/waypaper
- Owner: anufrievroman
- License: gpl-3.0
- Created: 2023-08-08T02:43:34.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2024-03-04T15:44:36.000Z (3 months ago)
- Last Synced: 2024-03-04T18:59:55.134Z (3 months ago)
- Topics: feh, gtk3, hyprland, i3, linux, swaybg, swaywm, swww, wallpaper, wallpaper-app, wallpaper-changer, wallpaper-manager, wayland-compatibility
- Language: Python
- Homepage: https://anufrievroman.gitbook.io/waypaper
- Size: 641 KB
- Stars: 194
- Watchers: 2
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-wayland - waypaper - GUI frontend for swaybg/swww to switch wallpapers (Wallpaper)
- awesome-hyprland - waypaper
README
# Waypaper
GUI wallpaper setter for Wayland and Xorg window managers. It works as a frontend for popular wallpaper backends like `swaybg`, `swww`, `wallutils` and `feh`. You can check a [demo on reddit](https://www.reddit.com/r/unixporn/comments/15lbhuc/hyprland_waypaper_gui_wallpaper_setter_for_wayland/). See details in [the documentation](https://anufrievroman.gitbook.io/waypaper).
![screenshot](screenshot.jpg)
## Features
- Vim keys
- Support for GIF animations (with `swww`)
- Support for multiple monitors (with `swww`)
- Works on both Wayland (with `swww` or `swaybg` or `wallutils`) and Xorg (with `feh` or `wallutils`)
- Restores wallpaper at launch of your WM
- Caching for fast loading
## InstallationYou need to install at least one of the backends and Waypaper, which works as a frontend.
### 1. Install a backend
Install a preferred backend from your package manager: [swww](https://github.com/Horus645/swww) or [swaybg](https://github.com/swaywm/swaybg) on Wayland or [feh](https://github.com/derf/feh) on Xorg or [wallutils](https://github.com/xyproto/wallutils) on both.
### 2. Install Waypaper
Waypaper is available as a package in different repositories listed below:
#### On all distributions
`pipx install waypaper`
If `pipx` is not found, you first need to install `pipx` from your package manager, it's sometimes called `python-pipx`.
#### On Arch-based distributions
`yay -S waypaper-git`
The [waypaper-git](https://aur.archlinux.org/packages/waypaper-git) package is available in AUR, thanks to *metak*. Please upvote to support the project.
#### On NixOS
The `waypaper` package is available thanks to Basil Keeler.
#### On OpenSUSE
Users of OpenSUSE [reported issue with installation](https://github.com/anufrievroman/waypaper/issues/30) via `pipx install waypaper`. This might be resolved by installing the `python311-pycairo-devel` package.
### Dependencies
- `swww` or `swaybg` or `feh` or `wallutils`
- gobject python library (it might be called `python-gobject` or `python3-gi` or `python3-gobject` in your package manager.)
- `python-importlib_metadata`
- `python-platformdirs`## Usage
`waypaper` command will run GUI application.
### Options
To restore your wallpaper at launch, add `waypaper --restore` to your startup config.
See more [details on user arguments in the documentation](https://anufrievroman.gitbook.io/waypaper/usage).
### Configuration
See [configuration details in the documentation](https://anufrievroman.gitbook.io/waypaper/configuration).
### Troubleshooting
See typical problems [explained in the documentation](https://anufrievroman.gitbook.io/waypaper/troubleshooting)
## Contribution and support
Feel free to propose PR and suggest the improvements. I'll highly appreciate help with packaging for various distributions. If you wish to contribute with translation into your language, please see the `translations.py` file.
I am not a professional developer and work on open-source projects in my free time. If you'd like to support the development, consider donations via [buymeacoffee](https://www.buymeacoffee.com/angryprofessor) or cryptocurrencies:
- BTC `bc1qpkzmutdqfxkce34skt09vll97s5smpa0r2tyzj`
- ETH `0x6f1Ce9cA181458Fc153a5f7cBF88044736C3b00C`
- BNB `0x40f22c372758E35C905458cAF8BB17f51ac133d1`
- LTC `ltc1qtu33qyv2xlzxda5mmrmk943zpksq8q75tuh85p`