$ cargo install gyr
Or build from Git:
$ git clone https://git.sr.ht/~f9/gyr && cd gyr $ cargo build --release
target/release/gyrto somewhere in your
Gyr is in the Arch Linux AUR (
Other distros may come soon-ish
Alternatively, pre-built binaries for Linux (x86_64 and aarch64) and FreeBSD 13.1 (x86_64) are available in the releases.
gyr from a terminal. Scroll through the app list, find some app typing chars, run selected pressing ENTER. Pretty straightforward.
Oh, yes: go to the bottom with the left arrow, top with right. Cancel pressing Esc.
Alternative bindings are Ctrl-Q to cancel, Ctrl-Y to run the app, Ctrl-N scroll down and Ctrl-P to scroll up (VIM bindings).
Note for Sway: When
swaymsg execis used to run the program. This allows Sway to spawn the program in the workspace Gyr was run in.
You can configure some stuff with cli flags, see
Gyr also has a history feature, so most used entries will be sorted first. This can be reset with
There's also a config file which can be placed in
Verbosity levels (
-vvv, each level adds logs to the previous one):
-v: will make the launched binary inherit Gyr's
stdio. (which means you'll see the logs)
-vv: will show the path of each app in the info
-vvv: adds some debug information (number of times the apps were run, etc.)
This is what I have on my config file:
$ cat ~/.config/sway/config ... set $menu alacritty --title launcher -e gyr bindsym $mod+d exec $menu for_window [title="^launcher$"] floating enable, resize set width 500 height 430, border none ...
Feature requests and bug reports are most welcome.
I'll accept patchsets fixing bugs or adding requested features.
NOTE: The preferred way to contribute is via SourceHut, tickets can be opened at https://todo.sr.ht/~f9/gyr
The GitLab releases & issues are kept for convenience, but merge requests are closed.
Notable changes will be documented in the CHANGELOG file
BSD 2-Clause (c) 2020-2022 Namkhai B.