The most efficient way to move between windows. For Hyprland.
Cogito ergo jaunteo. I think, therefore I jaunte.
— Alfred Bester, The Stars My Destination
Jaunt works similarly to classic Alt + Tab switchers, but it is scoped to only one program's windows.
-
To switch to a window, press
Super + <key>, where<key>is configured per program by you, for example:Super + t: TerminalSuper + w: Web browserSuper + s: Spotify- etc...
-
Keep holding down the
Superto see all windows of<key>'s program (if it's not running it gets launched) -
Keep tapping
<key>to cycle the focused window -
Or press
Super + <number>to go straight to a window, using the numbers shown beside them (windows 1-9, and only when the program has more than one) -
Release
Superto go to the currently selected window
Clicking anywhere outside the switcher closes it, which is the way out if a keybind ever isn't.
# flake.nix
{
inputs.jaunt.url = "github:mawkler/jaunt";
}# ...then in your NixOS configuration:
{
imports = [ inputs.jaunt.nixosModules.default ];
services.jaunt = {
enable = true;
# If you prefer configuring with Nix (doesn't hot-reload)
# settings = {
# keys.apps = {
# t = "ghostty";
# w = { cmd = "brave"; app_id = "brave-browser"; };
# }
# # ...
# };
};
}This runs the daemon as a user service, which needs the session in systemd, e.g. programs.hyprland.withUWSM = true. Without settings it reads ~/.config/jaunt/config.toml (which supports hot-reloading). See Configuration for mor info.
Click to expand
-
Install Jaunt:
git clone https://github.com/mawkler/jaunt cargo install --path jaunt
-
Add this to your
~/.config/hypr/hyprland.lua:
hl.on("hyprland.start", function() hl.exec_cmd("jaunt daemon") end)Configuration is in ~/.config/jaunt/config.toml, and it hot-reloads Jaunt on save.
jaunt default-config prints the default config.
Example configuration:
Click to expand
[keys]
next = "Tab" # only bound while the switcher is open; Super is implied
previous = "Shift + Tab"
cancel = "Escape"
close = "q" # close the highlighted window; unset by default
[keys.apps] # Super + key
t = "ghostty"
s = "spotify"
w = { cmd = "brave", app_id = "brave-browser" } # when the window class isn't the command
"Shift + a" = "teams" # a key may carry modifiers, but then has no Shift to go back with
[switcher]
delay = 90 # milliseconds Super is held before the switcher appears
width = "50%" # of the screen, or pixels
max_height = "40%" # previews shrink to fit
icons = true # icons rather than initials
background_opacity = 0.92 # the panel
foreground_opacity = 1 # the sheet holding the windows
theme = "default"
numbers = { action = "select" } # or "switch": a number key goes to its window at once
[previews]
enabled = true
height = 150 # pixels
[names] # by window class; otherwise the desktop entry's name
brave-browser = "Brave"The built-in themes live in themes/, and includes default, light, catppuccin, nord, one-dark and tokyo-night.
To create your own, put it in ~/.config/jaunt/themes/<name>.toml, and set theme = "<name>" (or a path) in your config.
A theme only needs the colors it changes. The rest come from its base, or from default if it doesn't have one.
base = "nord" # optional: the theme to start from
background = "#15171c" # the panel
surface = "#20232b" # the sheet and its tab
accent = "#6b8cff" # the selected window
text = "#c4cad8" # window titles and keys
bright = "#eef1f7" # the heading and the selected window's title
muted = "#78819a" # secondary text and hintsA theme can also go straight into your config, written the same way:
[switcher.theme]
base = "nord"
accent = "#ff8800"To set up the development environment (requires Nix), run
nix developThe switcher's QML in shell/ is built into the binary. JAUNT_SHELL=$PWD/shell jaunt daemon runs it from the checkout instead, reloading on every save.
This project started out as hand-chiseled. I have since pivoted to relying heavily on agentic LLMs.