zmen

Application Launcher written in Zig

Files | Log | Commits | Refs | README

README.md

Size: 1179 bytes

# zmen

A minimal application launcher written in Zig.

## Description

zmen is a simple, lightweight application launcher for X11 inspired by dmenu. 
It uses XCB and Cairo for rendering with fewer than 700 lines of code.
Something as simple as an Application Launcher shouldn't pull in half the internt as dependencies.

## Installation

Requirements:
- Zig compiler (tested with 0.12.0)
- libxcb1-dev
- libcairo2-dev
- libxcb-keysyms1-dev
- libx11-dev

```
git clone this repository
cd zmen
zig build
```

Or build directly:

```
zig build-exe main.zig -lc -lxcb -lcairo -lxcb-keysyms -lX11
```

## Usage

Run zmen:

```
./zmen
```
Recommended: bind to a key combination in your window manager config.

### Keybindings

- Type to search for commands
- Tab - Complete the suggested command
- Right arrow - Accept one character of suggestion
- Return - Execute the command
- Escape - Clear input or exit

## Configuration

Edit the source code directly. Simple configuration options:

```zig
const font_size = 25.0;
const bh = 30;                  // Bar height
const font = "Liberation Mono"; // Font name
const prompt = "run:";          // Prompt character
```

## LICENSE
MIT