hypr-presto 0.3.0

Launch your favorite apps with a single keystroke. HyprPresto is a minimal, keyboard-centric application launcher for Linux. Activate it, press one key, and your app is running.
hypr-presto-0.3.0 is not a library.

HyprPresto

current version: 0.1.0

JP -> here}

A minimal, keyboard-centric application launcher for Linux, designed for speed and efficiency. HyprPresto allows you to launch your favorite applications with a single keystroke.

Features

  • Instant Launch: Trigger applications with a single key press.
  • Modern UI: Clean, dark-themed interface built with GTK4.
  • Wayland Native: Built with gtk4-layer-shell, perfect for compositors like Hyprland and Sway.
  • Lightweight: Fast startup and minimal resource usage.
  • Simple Configuration: Easy-to-read TOML configuration.

Usage

demo

  1. Ensure you have your config.toml ready.
  2. Run the application: 
    hypr-presto
  3. The launcher window will appear.
  4. Press the key corresponding to the app you want to launch (e.g., press f).
  5. The app will launch, and HyprPresto will close automatically.
  6. To close without launching, press Esc.

Dependencies

To run HyprPresto, you need the following installed on your system:

  • GTK4
  • gtk4-layer-shell

To build from source, you will also need:

  • Rust (cargo)
  • blueprint-compiler

How to Install

HyprPresto is now available on crates.io. You can install it with the following command.

cargo install hypr-presto

It is also available as a binary release at Release.

  1. Go to the Releases page.
  2. Download the latest hypr-presto binary.
  3. Make it executable: 
    chmod +x hypr-presto
  4. (Optional) Move it to a directory in your $PATH, e.g., /usr/local/bin: 
    sudo mv hypr-presto /usr/local/bin/

Configuration

HyprPresto follows the XDG Base Directory Specification for its configuration.

Path: ~/.config/hypr-presto/config.toml

Structure

The configuration file uses the TOML format. Define your shortcuts under the [apps] section. The key is the single character you want to press, and the value is the Desktop Entry ID of the application (usually the filename of the .desktop file without the extension).

Example config.toml

[apps]
f = "firefox"                 # Press 'f' to launch Firefox
g = "com.mitchellh.ghostty"   # Press 'g' to launch Ghostty
c = "code-oss"                # Press 'c' to launch VS Code

my config: https://github.com/Uliboooo/dotfiles/tree/main/.config/hypr-presto

Note: To find the correct App ID, look at the filenames in /usr/share/applications/ (e.g., for spotify.desktop, use spotify).

Integration with Hyprland

You can bind HyprPresto to a key in your hyprland.conf:

bind = $mainMod, P, exec, hypr-presto(bin path)

Links