lnchr 0.2.2

A fuzzy terminal app launcher
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

# lnchr

A fast, lightweight fuzzy launcher for your terminal.

Other launchers are often either too complex to configure, have much styling
in the way, or simply weren't fast enough. lnchr aims to be none of
that — minimal, no config, fast — and runs directly from your terminal emulator.

## Modes

The `run` mode scans `PATH` for executables.
The `drun` mode scans XDG data directories for `.desktop` files,
respecting fields like `Terminal`, `TryExec`, `NoDisplay`, and `Hidden`.

For desktop entries that require a terminal (`Terminal=true`), lnchr
looks for a terminal emulator by checking the `-T` flag first, then
the `TERMINAL` environment variable, and finally falls back to
common terminals.

## Usage

In order to use it like a normal app launcher you can bind it to a key and define rules.  
For example, in Hyprland:

```lua
hl.bind(mainMod .. " + SPACE", hl.dsp.exec_cmd("alacritty --class=lnchr -e lnchr drun -T alacritty"))
hl.bind(mainMod .. " + SHIFT + SPACE", hl.dsp.exec_cmd("alacritty --class=lnchr -e lnchr run"))

hl.window_rule({
    name = "floating lnchr",
    match = { class = "lnchr" },
    float = true,
})
```

## Installation

### NixOS

This repo can be added as a input of the flake.nix and the package installed like this:

```nix
{
  inputs = {
    lnchr.url = "git+https://codeberg.org/paul-hartwich/lnchr";
  };
}
```

```nix
{ pkgs, ... }:
{
  home.packages = with pkgs; [
    inputs.lnchr.packages.x86_64-linux.lnchr
  ];
};
```

### Cargo

In order to install the package with cargo, just run:

```bash
cargo install lnchr
```

## License

MIT License - see [LICENSE](LICENSE) file.