Pyprland

Discussions • Plugins • Dotfiles • Changes History • Share

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.

<details> <summary> About Pyprland (latest stable is: <b>2.6.2</b>) </summary>

🎉 Hear what others are saying:

• Elsa in Mac some tutorial article for fedora in Korean with a nice short demo video
• Archlinux Hyprland dotfiles + video
• "It just works very very well" - The Linux Cast (video) - February 2024
• You NEED This in your Hyprland Config - LibrePhoenix (video) - October 2023 (*Now TOML format is preferred over JSON)

</details> <details> <summary> Contributing </summary>

Check out the creating a pull request document for guidance.

• Report bugs or propose features here
• Improve our wiki
• Read the internal ticket list for some PR ideas

and if you have coding skills you can also

• Enhance the coverage of our tests
• Propose & write new plugins or enhancements

</details> <details> <summary> Dependencies </summary>

• Python >= 3.11
  • aiofiles (optional but recommended)
  • pillow (optional, required for rounded borders in wallpapers)

</details> <details> <summary> Latest major changes </summary>

Check the Releases change log 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:

$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 allows general monitor settings
• scratchpads
  • better multi-window support
  • better preserve_aspect implementation (i3 "compatibility")

2.2

• Added wallpapers and system_notifier plugins.
• Deprecated class_match in scratchpads
• Added gbar in 2.2.6
• scratchpads supports multiple client windows (using 2.2.19 is recommended)
• monitors and scratchpads supports rotation in 2.2.13
• Improve Nix support

2.1

• Requires Hyprland >= 0.37
• Monitors plugin improvements.

2.0

• New dependency: aiofiles
• Added hysteresis support for scratchpads.

1.10

• New fetch_client_menu and shortcuts_menu plugins.

1.9

• Introduced shortcuts_menu plugin.

1.8

• Requires Hyprland >= 0.30
• Added layout_center plugin.

</details> <a href="https://star-history.com/#fdev31/pyprland&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=fdev31/pyprland&type=Timeline&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=fdev31/pyprland&type=Timeline" /> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=fdev31/pyprland&type=Timeline" /> </picture> </a>