KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

mibu

★ 151 Open GitHub ↗

Zero-allocation Zig library for ANSI terminal control: colors, styling, cursor, screen, and input events.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mibu

**mibu** is a pure Zig library for low-level terminal manipulation.

**Status:** This library is in beta. Breaking changes may occur.

> Tested with zig version `0.16.0` on Linux and Windows

## Features

- Zero heap allocations.
- UTF-8 character support.
- Terminal raw mode support.
- Text styling: bold, italic, underline.
- Color output: supports 8, 16, and true color (24-bit).
- Cursor movement and positioning functions.
- Screen clearing and erasing utilities.
- Key event handling: codepoints, modifiers, and special keys.
- Mouse event handling: click, scroll, and release actions.

## How to use

Add the library as a dependency in your `build.zig.zon` file:

```bash
zig fetch --save git+https://github.com/xyaman/mibu
```

Import the dependency in your `build.zig` file:

```zig
const mibu_dep = b.dependency("mibu", .{});
exe.root_module.addImport("mibu", mibu_dep.module("mibu"));
```

Use the library in your Zig code:

```zig
const std = @import("std");
const mibu = @import("mibu");
const color = mibu.color;

pub fn main() void {
    std.debug.print("{s}Hello World in purple!{s}\n", .{ color.fgRGB(.{ .r = 97, .g = 37, .b = 160 }), color.reset });
}
```

## Getting Started

See the [examples directory](examples/).

You can run the examples with the following command:

```bash
# Prints text with different colors
zig build color

# Prints what key you pressed, until you press `q` or `ctrl+c`
zig build event

# Switch to alternate screen
zig build alternate_screen

# Detect terminal background color
zig build termbg
```

## TODO

- [ ] Mouse: Click and move (drag)

## Projects that use `mibu`

- [gurgeous/tennis](https://github.com/gurgeous/tennis) — A small CLI for printing stylized CSV tables
- [tornikegomareli/lumen](https://github.com/tornikegomareli/lumen) — Real-time hardware monitoring TUI for macOS
- [lance0/ahab](https://github.com/lance0/ahab) — A Docker cleanup TUI
- [zigtris](https://github.com/ringtailsoftware/zigtris) — A minimal terminal Tetris written in Zig
- [2048 in zig](https://codeberg.org/Vulwsztyn/2048_zig) — 2048 implementation in Zig

mibu

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README