Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hyprutils/hyprlauncher

GUI for launching applications, written in blazingly fast Rust! 🚀🦀
https://github.com/hyprutils/hyprlauncher

applauncher css gui hyprland hyprutils launcher rust wayland xorg

Last synced: 1 day ago
JSON representation

GUI for launching applications, written in blazingly fast Rust! 🚀🦀

Awesome Lists containing this project

README

        

Hyprlauncher


[![Grind Compliant](https://img.shields.io/badge/Grind-Compliant-blue)](https://github.com/The-Grindhouse/guidelines)

An unofficial [daemon-like](https://en.wikipedia.org/wiki/Daemon_(computing)) GUI for launching applications, built with GTK4 and Rust. 🚀🦀

## Preview
![Preview](.github/preview.png)

## Usage

> [!TIP]
> For optimal performance, bind Hyprlauncher to a keyboard shortcut instead of launching it from a terminal. While the initial launch takes a moment to daemonize, subsequent launches are near-instant (~28-30ms).

Example Hyprland config bind:
```conf
bind = $mainMod_SHIFT, E, exec, hyprlauncher
```

## Configuration
For configuration options and customization, see [configuration.md](configuration.md).

The configuration file is located at `~/.config/hyprlauncher/config.toml`

Changes to the configuration file are applied instantly without needing to restart.

## Installation

[![Packaging status](https://repology.org/badge/vertical-allrepos/hyprlauncher.svg)](https://repology.org/project/hyprlauncher/versions)

### Requirements
- GTK4
- GTK4-Layer-Shell
- Pango

### GitHub Releases
See Hyprlauncher's [releases page](https://github.com/hyprutils/hyprlauncher/releases) for downloadable binaries.

### Arch Linux
There are 2 different [AUR](https://aur.archlinux.org) packages available:

- [hyprlauncher](https://aur.archlinux.org/packages/hyprlauncher) - Latest release built from source
- [hyprlauncher-bin](https://aur.archlinux.org/packages/hyprlauncher-bin) - Latest release in binary form

Install the preferred package with:
```bash
git clone https://aur.archlinux.org/.git
cd
makepkg -si
```

Or, if you're using an [AUR Helper](https://wiki.archlinux.org/title/AUR_helpers), it's even simpler (using [paru](https://github.com/Morganamilo/paru) as an example):
```bash
paru -S
```

## Building from source
1. Install Rust (preferably `rustup`) through your distro's package or [the official script](https://www.rust-lang.org/tools/install)
2. Clone this repository:
`git clone https://github.com/hyprutils/hyprlauncher && cd hyprlauncher`
3. Compile the app with `cargo build --release` or run it directly with `cargo run --release`

## Credits:
- [Nyx](https://github.com/nnyyxxxx) - Implementing the GUI, and maintaining the project
- [Adam](https://github.com/adamperkowski) - Code improvements, and maintaining the project
- [Vaxry](https://github.com/vaxerski) - Hyprland
- [rust-gtk](https://github.com/gtk-rs/gtk4-rs) - The GTK4 library
- [Hyprland](https://github.com/hyprwm/Hyprland) - The wayland compositor

Copyright (C) 2024 HyprUtils