Hyprshell

Overview

Hyprshell (previously hyprswitch) is a Rust-based GUI designed to enhance window management in Hyprland. It provides a powerful and customizable interface for switching between windows using keyboard shortcuts and GUI. The application also includes a launcher for running applications, doing calculations, etc.

Features

• Window Switching: Switch between windows using keyboard shortcuts in a GUI.
• Customizable Keybindings: Define your own keybindings for window switching and GUI interactions.
• Config: Interactive config file generation for easy setup.
• Launcher Integration: Launch applications directly from the GUI, sorted by usage frequency.
• Theming: Customize the GUI appearance (gtk4) using CSS.
• Sorting and Filtering: windows sorted by position, can be filtered by class, workspace, or monitor.
• Dynamic Configuration: Automatically reloads configuration/style changes without restarting the application.

Installation

From Source

gtk4 and gtk4-layer-shell[1.1.1] must be installed

cargo install hyprshell

Arch Linux

paru -S hyprshell
# or
yay -S hyprshell

NixOS

This repository contains a flake and a home-manager module for configuration.

More information can be found in the NixOS section.

Usage

Run hyprshell --help to see available commands and options.

Config generation

To generate a default configuration file, run:

hyprshell config generate

This launches an interactive prompt to set up your configuration. The generated file will be located at ~/.config/hyprshell/config.ron.

If you want to modify these settings, look at the Documentation for the config file.

Config validation

To validate your configuration file, run:

hyprshell config check

This checks for any syntax errors or issues in your configuration file and shows a explanation of how to use hyprshell.

Initialization

Add the following to your Hyprland configuration (~/.config/hypr/hyprland.conf):

exec-once = hyprshell run &

Or enable the systemd service (generated with hyprshell config generate):

systemctl --user enable --now hyprshell.service

Env Variables

• HYPRSHELL_NO_LISTENERS: Disable all config listeners (config file, css file, hyprland config, monitor count)
• HYPRSHELL_SHOW_OUTPUT: Show the output of an opened application in the terminal.
• HYPRSHELL_NO_ALL_ICONS: Don't check for all icons on fs and just use the ones provided by the gtk4 icon theme.
• HYPRSHELL_RELOAD_TIMEOUT: Set the timeout for reloading the config file in milliseconds (default: 1000).

Feature Flags

• default: ["toml_config", "generate_config_command", "launcher_calc", "debug_command"]
• generate_config_command: Adds the hyprshell config generate command to interactively generate a config file.
• toml_config: Adds support for a toml config file.
• launcher_calc: Adds support for the calc plugin in the launcher.
• debug_command: Adds the hyprshell debug command to debug icons in the window mode.
• bar: Unused