README
¶
Hexecute
A gesture-based launcher for Wayland. Launch apps by casting spells! 🪄
Installation
Nix / NixOS
If you're a lucky Nix user, you can:
Try it out without installing:
nix run github:m31-galaxy/Hexecute
Install to your profile:
nix profile install github:m31-galaxy/Hexecute
Add to your NixOS configuration:
# flake.nix
{
inputs.hexecute.url = "github:m31-galaxy/Hexecute";
}
# configuration.nix
{
environment.systemPackages = with pkgs; [
inputs.hexecute.packages.${pkgs.system}.default
];
}
Executable download
Download the latest version from the release page, and place it somewhere in your $PATH.
Don't forget to rename the downloaded binary to hexecute and make it executable:
mv hexecute-1.2.3-blah hexecute
chmod +x hexecute
Build from Source
Clone the repository:
git clone https://github.com/m31-galaxy/Hexecute
cd Hexecute
If you have Nix installed, simply run nix build.
Otherwise, make sure you have Go (and all dependent Wayland (and X11!?) libs) installed, then run:
mkdir -p bin
go build -o bin ./...
./bin/hexecute
Usage
Setting a Keybind
The recommended way to use Hexecute is to bind it to a keyboard shortcut in your compositor.
Listed below are some examples for popular compositors using the SUPER + SPACE keybind.
Hyprland
If you're using Hyprland, add the following line to your ~/.config/hypr/hyprland.conf:
bind = SUPER, SPACE, exec, hexecute
Sway
If you're using Sway, add the following line to your ~/.config/sway/config:
bindsym $mod+space exec hexecute
Learning a Gesture
To configure a gesture to launch an application, run hexecute --learn [command] in a terminal. Hexecute should launch - simply draw your chosen gesture 3 times and it will be mapped to the command.
Managing Gestures
To view all your configured gestures, run hexecute --list in a terminal.
To delete a previously assigned gesture, use the hexecute --remove [gesture] command.
All gestures are saved in the ~/.config/hexecute/gestures.json file. This file can be manually shared, edited, backed up, or swapped.
Directories