{"id":13533434,"url":"https://github.com/anufrievroman/waypaper","last_synced_at":"2025-05-14T17:07:09.789Z","repository":{"id":186876061,"uuid":"675910838","full_name":"anufrievroman/waypaper","owner":"anufrievroman","description":"GUI wallpaper manager for Wayland and Xorg Linux systems","archived":false,"fork":false,"pushed_at":"2025-05-12T13:33:00.000Z","size":13309,"stargazers_count":578,"open_issues_count":5,"forks_count":32,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-05-12T14:51:51.123Z","etag":null,"topics":["feh","gtk3","hyprland","hyprpaper","i3","linux","swaybg","swaywm","swww","wallpaper","wallpaper-app","wallpaper-changer","wallpaper-manager","wayland-compatibility"],"latest_commit_sha":null,"homepage":"https://anufrievroman.gitbook.io/waypaper","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anufrievroman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-08T02:43:34.000Z","updated_at":"2025-05-12T14:34:28.000Z","dependencies_parsed_at":"2023-08-08T04:21:41.948Z","dependency_job_id":"30790486-d7dc-4ec7-82bd-db209eda3e69","html_url":"https://github.com/anufrievroman/waypaper","commit_stats":{"total_commits":210,"total_committers":22,"mean_commits":9.545454545454545,"dds":0.519047619047619,"last_synced_commit":"068c2eaad9f9c6899a57ea5c4cfc7b52db6ce75a"},"previous_names":["anufrievroman/waypaper"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anufrievroman%2Fwaypaper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anufrievroman%2Fwaypaper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anufrievroman%2Fwaypaper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anufrievroman%2Fwaypaper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anufrievroman","download_url":"https://codeload.github.com/anufrievroman/waypaper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253870888,"owners_count":21976613,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["feh","gtk3","hyprland","hyprpaper","i3","linux","swaybg","swaywm","swww","wallpaper","wallpaper-app","wallpaper-changer","wallpaper-manager","wayland-compatibility"],"created_at":"2024-08-01T07:01:19.804Z","updated_at":"2025-05-14T17:07:09.767Z","avatar_url":"https://github.com/anufrievroman.png","language":"Python","funding_links":["https://www.buymeacoffee.com/angryprofessor"],"categories":["Tools","Wallpaper","Linux"],"sub_categories":["Wallpaper","Other"],"readme":"# Waypaper\n\nGUI wallpaper setter for Wayland and Xorg window managers. It works as a frontend for popular wallpaper backends like `swaybg`, `swww`, `wallutils`, `hyprpaper`, `mpvpaper` and `feh`. See [demo](https://www.youtube.com/watch?v=O9OL7iH_KVY) and [documentation](https://anufrievroman.gitbook.io/waypaper).\n\n![screenshot](screen.jpg)\n\n## Features\n\n- Vim keys\n- Supports GIF animations (with `swww` or `mpvpaper`)\n- Supports videos (with `mpvpaper`)\n- Supports multiple monitors (with `swww` or `swaybg` or `hyprpaper` or `mpvpaper`)\n- Works on Wayland (with `swww` or `swaybg` or `hyprpaper` or `wallutils` or `mpvpaper`)\n- Works on Xorg (with `feh` or `wallutils`)\n- Restores wallpaper after restart (`waypaper --restore`)\n- Fast and minimal (315 kB)\n\n## Installation\n\nInstall at least one of the backends and Waypaper, which works as a frontend.\n\n### 1. Install a backend\n\nInstall a preferred backend from your package manager: [swww](https://github.com/Horus645/swww) or [swaybg](https://github.com/swaywm/swaybg) or [hyprpaper](https://github.com/hyprwm/hyprpaper) on Wayland or [feh](https://github.com/derf/feh) on Xorg or [mpvpaper](https://github.com/GhostNaN/mpvpaper) or [wallutils](https://github.com/xyproto/wallutils) on both.\n\n### 2. Install Waypaper\n\nInstall `waypaper`, which is available in different repositories:\n\n#### On all distributions\n\n`pipx install waypaper`\n\nIf `pipx` is not found, you first need to install `pipx` from your package manager, it's sometimes called `python-pipx`.\n\n#### On Arch-based distributions\n\n`yay -S waypaper`\n\nThe [waypaper](https://aur.archlinux.org/packages/waypaper) package and unstable developer package [waypaper-git](https://aur.archlinux.org/packages/waypaper-git) are available in AUR, thanks to *metak*. Please upvote to support the project.\n\n#### On NixOS\n\nThe `waypaper` package is available thanks to Basil Keeler.\n\n#### On OpenSUSE\n\nUsers of OpenSUSE [reported issue with installation](https://github.com/anufrievroman/waypaper/issues/30) via `pipx install waypaper`. This can be resolved by installing the `python311-pycairo-devel` and `python312-gobject-devel` packages first.\n\n#### On Fedora\n\nWaypaper is available in an external repository owned by Solopasha. You can add this repository as `sudo dnf copr enable solopasha/hyprland` and install as `sudo dnf install waypaper`.\n\n### Dependencies\n\n- `swww` or `swaybg` or `feh` or `wallutils` or `hyprpaper` or `mpvpaper`\n- gobject python library (it might be called `python-gobject` or `python3-gi` or `python3-gobject` in your package manager.)\n- `python-imageio`\n- `python-imageio-ffmpeg`\n- `python-screeninfo`\n- `python-platformdirs`\n\n## Usage\n\n`waypaper` command will run GUI application.\n\nTo restore your wallpaper after restart, add `waypaper --restore` to [your WM startup config](https://anufrievroman.gitbook.io/waypaper/usage).\n\n## Documentation\n\n- [CLI options](https://anufrievroman.gitbook.io/waypaper/usage#cli-options)\n- [Configuration](https://anufrievroman.gitbook.io/waypaper/configuration)\n- [Keybindings](https://anufrievroman.gitbook.io/waypaper/keybindings)\n- [Troubleshooting](https://anufrievroman.gitbook.io/waypaper/troubleshooting)\n- [Automatically changing wallpaper](https://anufrievroman.gitbook.io/waypaper/usage#automatically-changing-wallpaper)\n- [Set wallpaper after restart](https://anufrievroman.gitbook.io/waypaper/usage)\n\n## Contribution\n\nFeel free to propose PR and suggest the improvements. I'll appreciate help with packaging for various distributions. If you wish to contribute with translation into your language, please see the `translations.py` file. Here are a few guiding principles for contribution:\n\n- Please do not apply automatic code formatting tools on the entire code base.\n- Please propose features separately, don't combine unrelated changes into one PR.\n- For big changes, please open an issue first to discuss, otherwise PR might be declined.\n- If the changes involve hundreds of lines of code, probably something is wrong. Most things can be done with small adjustments.\n\n## Support\n\nI 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:\n\n- Cards and PayPal: [BuyMeACoffee](https://www.buymeacoffee.com/angryprofessor)\n- BTC `bc1qpkzmutdqfxkce34skt09vll97s5smpa0r2tyzj`\n- ETH `0x6f1Ce9cA181458Fc153a5f7cBF88044736C3b00C`\n- BNB `0x40f22c372758E35C905458cAF8BB17f51ac133d1`\n- LTC `ltc1qtu33qyv2xlzxda5mmrmk943zpksq8q75tuh85p`\n- XMR `4AHRhpNYUZcPVN78rbUWAzBuvMKQdpwStS5L3kjunnBMWWW2pjYBko1RUF6nQVpgQPdfAkM3jrEWrWKDHz1h4Ucd4gFCZ9j`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanufrievroman%2Fwaypaper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanufrievroman%2Fwaypaper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanufrievroman%2Fwaypaper/lists"}