Extending Hyprland's features

Pyprland is a host process for multiple Hyprland extensions, aiming at simplicity and efficiency.

It provides a variety of plugins you can enable to your liking.

New users need to read the getting started page.

→ Documentation

→ Changes log

→ Discussions

→ Contact / Community discord (fab31)

Dependencies

• Hyprland >= 0.30 (versions < 1.8 can run on Hyprland 0.25)
• Python >= 3.11
• aiofiles (python package) (Only in Git / Pyprland >= 2.0)

Latest major changes

2.0

• New dependency: aiofiles

  • fully asynchronous plugins, including file operations

• Added hysteresis support for scratchpads in 2.0.1

  Active when using unfocus="hide"

  Default value of 0.4 seconds should be fine for most usages. If it feels too slow for you, set a lower value or hysteresis=0 to completely disable it.

  Share the value which is optimal for you on discuss anything! The current value can be refined later.

1.10

• New fetch_client_menu plugin (shows a menu to bring a window to the active desktop)
• Dynamic menus can be achieved by shortcuts_menu

1.9

• New shortcuts_menu plugin

1.8

• toggle_minimized command renamed to toggle_special and moved to a separate plugin for clarity

  • add the toggle_special plugin to your config and rename the command in your hyprland.conf & scripts!
  • was provided by expose

• monitors plugin improved a lot. If you were disappointed with a previous experience, give another chance to the latest 1.8 version.

• New layout_center plugin

• Automated testing have improved a lot

1.7

• BREAKING CHANGE monitors plugin uses now a new syntax - full rewrite (expect a behavior change)

Developers

If you feel like contributing, you are welcome. It can be done in many different ways:

• bug reporting or proposing solid feature requests
• Improving the wiki (catching/fixing mistakes, helping with the formal structure, additional content, better wording, etc...)
• Writing new plugins
• Improving existing plugins
• Improving test coverage

Check the creating a pull request document if you are not familiar with it

Star History