https://github.com/hyprland-community/pyprland
Scratchpads & many goodies for Hyprland [maintainer=@fdev31]
https://github.com/hyprland-community/pyprland
asyncio color-scheme desktop extension eyecandy hacktoberfest hyprland hyprland-ipc menus multiscreen productivity python quality-of-life scratchpad scriptable shortcuts wallpaper-changer
Last synced: 3 months ago
JSON representation
Scratchpads & many goodies for Hyprland [maintainer=@fdev31]
- Host: GitHub
- URL: https://github.com/hyprland-community/pyprland
- Owner: hyprland-community
- License: mit
- Created: 2023-04-27T20:01:13.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-03-04T23:06:37.000Z (3 months ago)
- Last Synced: 2026-03-05T03:37:49.022Z (3 months ago)
- Topics: asyncio, color-scheme, desktop, extension, eyecandy, hacktoberfest, hyprland, hyprland-ipc, menus, multiscreen, productivity, python, quality-of-life, scratchpad, scriptable, shortcuts, wallpaper-changer
- Language: Python
- Homepage:
- Size: 3.46 MB
- Stars: 654
- Watchers: 6
- Forks: 31
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-hyprland - pyprland
README
[](https://github.com/hyprwm/Hyprland)
[](https://discord.com/channels/1458202721294356522/1458202722892386519)
[](https://hyprland-community.github.io/pyprland)
[Discussions](https://github.com/hyprland-community/pyprland/discussions) • [Plugins](https://hyprland-community.github.io/pyprland/Plugins.html) • [Dotfiles](https://github.com/fdev31/dotfiles) • [Changes History](https://github.com/hyprland-community/pyprland/releases) • [Share](https://github.com/hyprland-community/pyprland/discussions/46)
## Power up your desktop
A plugin system that extends your graphical environment with features like scratchpads, dynamic popup nested menus, custom notifications, easy monitor settings and more.
Think of it as a *Gnome tweak tool* for Hyprland, with options that can run on any desktop. With a fully plugin-based architecture, it's lightweight and easy to customize.
Contributions, suggestions, bug reports and comments are welcome.
About Pyprland (latest stable is: 2.6.2)
[](https://repology.org/project/pyprland/versions)
🎉 Hear what others are saying:
- [Elsa in Mac](https://elsainmac.tistory.com/915) some tutorial article for fedora in Korean with a nice short demo video
- [Archlinux Hyprland dotfiles](https://github.com/DinDotDout/.dotfiles/blob/main/conf-hyprland/.config/hypr/pyprland.toml) + [video](https://www.youtube.com/watch?v=jHuzcjf-FGM)
- ["It just works very very well" - The Linux Cast (video)](https://youtu.be/Cjn0SFyyucY?si=hGb0TM9IDvlbcD6A&t=131) - February 2024
- [You NEED This in your Hyprland Config - LibrePhoenix (video)](https://www.youtube.com/watch?v=CwGlm-rpok4) - October 2023 (*Now [TOML](https://toml.io/en/) format is preferred over [JSON](https://www.w3schools.com/js/js_json_intro.asp))
Contributing
Check out the [creating a pull request](https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) document for guidance.
- Report bugs or propose features [here](https://github.com/hyprland-community/pyprland/issues)
- Improve our [wiki](https://hyprland-community.github.io/pyprland/)
- Read the [internal ticket list](https://github.com/hyprland-community/pyprland/blob/main/tickets.rst) for some PR ideas
and if you have coding skills you can also
- Enhance the coverage of our [tests](https://github.com/hyprland-community/pyprland/tree/main/tests)
- Propose & write new plugins or enhancements
Dependencies
- **Python** >= 3.11
- **aiofiles** (optional but recommended)
- **pillow** (optional, required for rounded borders in `wallpapers`)
Latest major changes
Check the [Releases change log](https://github.com/hyprland-community/pyprland/releases) for more information
### 3.0.0
- Dynamic shell completions
- Better error handling and configuration validation
- Removed hard dependency on Hyprland
- General polish including a couple ofbreaking changes
- remove old or broken options
- fixes
### 2.5
- wallpapers plugin refactored, supports rounded corners and pause
- fcitx5 switcher plugin (appeared in late 2.4)
### 2.4
- Scratchpads are now pinned by default (set `pinned = false` for the old behavior)
- Version >=2.4.4 is required for Hyprland 0.48.0
- A snappier `pypr-client` command is available, meant to be used in the keyboard bindings (NOT to start pypr on startup!), eg:
```sh
$pypr = uwsm-app -- pypr-client
bind = $mainMod SHIFT, Z, exec, $pypr zoom ++0.5
```
### 2.3
- Supports *Hyprland > 0.40.0*
- Improved code kwaleetee
- [monitors](https://hyprland-community.github.io/pyprland/monitors) allows general monitor settings
- [scratchpads](https://hyprland-community.github.io/pyprland/scratchpads)
- better multi-window support
- better `preserve_aspect` implementation (i3 "compatibility")
### 2.2
- Added [wallpapers](https://hyprland-community.github.io/pyprland/wallpapers) and [system_notifier](https://hyprland-community.github.io/pyprland/system_notifier) plugins.
- Deprecated [class_match](https://hyprland-community.github.io/pyprland/scratchpads_nonstandard) in [scratchpads](https://hyprland-community.github.io/pyprland/scratchpads)
- Added [gbar](https://hyprland-community.github.io/pyprland/gbar) in 2.2.6
- [scratchpads](https://hyprland-community.github.io/pyprland/scratchpads) supports multiple client windows (using 2.2.19 is recommended)
- [monitors](https://hyprland-community.github.io/pyprland/monitors) and [scratchpads](https://hyprland-community.github.io/pyprland/scratchpads) supports rotation in 2.2.13
- Improve [Nix support](https://hyprland-community.github.io/pyprland/Nix)
### 2.1
- Requires Hyprland >= 0.37
- [Monitors](https://hyprland-community.github.io/pyprland/monitors) plugin improvements.
### 2.0
- New dependency: [aiofiles](https://pypi.org/project/aiofiles/)
- Added [hysteresis](https://hyprland-community.github.io/pyprland/scratchpads#hysteresis-optional) support for [scratchpads](https://hyprland-community.github.io/pyprland/scratchpads).
### 1.10
- New [fetch_client_menu](https://hyprland-community.github.io/pyprland/fetch_client_menu) and [shortcuts_menu](https://hyprland-community.github.io/pyprland/shortcuts_menu) plugins.
### 1.9
- Introduced [shortcuts_menu](https://hyprland-community.github.io/pyprland/shortcuts_menu) plugin.
### 1.8
- Requires Hyprland >= 0.30
- Added [layout_center](https://hyprland-community.github.io/pyprland/layout_center) plugin.
