Hyprgrass

Gestures for your touch screen

Warning

Even though hyprgrass is mostly stable now, there used to be some bugs that render your touch device unusable until you unload the plugin/close Hyprland see issue #27, keep a keyboard in hand the first time you try this. This plugin is still in alpha, expect breaking changes!

Please open an issue if you find any bugs. Feel free to make a feature request if you have a suggestion.

Features/Roadmap

• Workspace Swipe
• Custom commands
• Swipe From Edge
• Multi-finger swipe

Installation

Dependencies

Besides Hyprland (duh), this plugin has the following dependencies:

glm

# build dependencies
meson
ninja

# extra dependencies for hyprgrass-pulse
libpulseaudio

Install via hyprpm

First, install all dependencies. Then, run these commands:

hyprpm add https://github.com/horriblename/hyprgrass
hyprpm enable hyprgrass

# optional integration with pulse-audio, see examples/hyprgrass-pulse/README.md
hyprpm enable hyprgrass-pulse

You can add exec-once = hyprpm reload -n to your hyprland config to have plugins loaded at startup. -n will make hyprpm send a notification if anything goes wrong (e.g. update needed)

see hyprland wiki for more info

Debug builds

Debug builds provide a more detailed stack trace during crashes, which can help me identify issues when reporting crashes.

git clone https://github.com/horriblename/hyprgrass
cd hyprgrass

meson setup build -Dbuildtype=debug
meson compile -Cbuild

# note that relative paths won't work
hyprctl plugin load "$PWD/build/src/libhyprgrass.so"

Attach your crash logs (in ~/.cache/hypr/hyprlandCrashReport{pid}.txt) when you report a crash.

Manual compilation

meson setup build
ninja -C build

On the meson setup step you can pass these options:

• -Dbuildtype=debug for debug builds
• -Dhyprgrass-pulse=true to enable building hyprgrass-pulse

Install via nix

Flakes are highly recommended (because I don't know how to do anything without them)

Put this in your flake.nix file:

{
   inputs = {
      # ...
      hyprland.url = "github:hyprwm/Hyprland";
      hyprgrass = {
         url = "github:horriblename/hyprgrass";
         inputs.hyprland.follows = "hyprland"; # IMPORTANT
      };
   };
}

and in your home-manager module:

wayland.windowManager.hyprland = {
   plugins = [
      inputs.hyprgrass.packages.${pkgs.system}.default

      # optional integration with pulse-audio, see examples/hyprgrass-pulse/README.md
      inputs.hyprgrass.packages.${pkgs.system}.hyprgrass-pulse
   ];
};

Configuration

See docs

Other touch screen goodies

Touch screen related tools I liked.

On-screen keyboards:

• squeekboard: has auto show/hide but doesn't work well with IME (fcitx/IBus etc.)
• wvkbd: relatively simple keyboard but still has most important features.
• fcitx-virtual-keyboard-adapter: NOT a keyboard but an fcitx addon that auto show/hides any on-screen keyboard.

Miscellanaeious:

• iio-hyprland: auto screen rotation
• Hyprspace: an overview plugin for hyprland
• nwg-drawer: app drawer. Surprisingly, there's not a lot of those

Acknowledgements

• Special thanks to wayfire for the awesome wf-touch library!
• Some parts are based on AOSP, licensed under Apache License 2.0
• Example plugins are heavily based on Waybar, licensed under MIT License