# kbt

> Terminal-based keyboard testing tool for checking key functionality across multiple layouts

Stars: 391 · Language: Rust · License: MIT · Categories: System

- Repository: https://github.com/bloznelis/kbt
- Page: https://www.trmn.sh/tools/kbt

## Install

- Homebrew: `brew install kbt`
- Cargo: `cargo install kbt`
- Pacman: `pacman -S kbt`
- Nix: `nix-shell -p kbt`

## Overview

kbt (keyboard board tester) is a terminal-based keyboard testing utility that allows users to test keyboard functionality directly from the command line. Unlike web-based keyboard testers, kbt runs natively in the terminal environment, providing a reliable platform for verifying key presses and keyboard layouts.

The tool supports multiple keyboard layouts and provides an interactive menu interface for navigation. Users can test individual keys and verify their proper registration without relying on browser-based solutions. Built with ratatui, kbt offers cross-platform compatibility across Linux, macOS, and Windows systems.

kbt is particularly useful for system administrators, hardware technicians, and users who need to verify keyboard functionality in environments where GUI applications may not be available or preferred. The tool requires Accessibility permissions on macOS during first run, and currently does not support Wayland display servers on Linux systems.

### Installation

```bash
# via Homebrew
brew install kbt
```

```bash
# via Cargo
cargo install kbt
```

```bash
# via Pacman
pacman -S kbt
```

```bash
# via Nix
nix-shell -p kbt
```

![kbt keyboard testing interface](https://media.trmn.sh/cached/9d3fe733079d81d75c85eaa740fb106f83108e9c5606b15c7e5d474fd33a1179.gif)

## Alternatives

- [pdu](https://www.trmn.sh/tools/pdu.md): Parallelized disk usage analyzer that renders graphical charts for directory tree analysis (Rust, 741 stars)
- [g1c](https://www.trmn.sh/tools/g1c.md): Terminal UI for monitoring and managing Google Cloud VM instances with real-time updates and instance operations (Rust, 41 stars)
- [ecscope](https://www.trmn.sh/tools/ecscope.md): TUI for monitoring AWS ECS services, tasks, and containers across multiple clusters and regions in a unified view. (Rust, 14 stars)
- [wiremix](https://www.trmn.sh/tools/wiremix.md): TUI audio mixer for PipeWire that controls volumes, routes audio between devices and applications, and configures audio settings. (Rust, 1.1k stars)
- [oxker](https://www.trmn.sh/tools/oxker.md): Rust TUI for viewing and controlling Docker containers, with log viewing, search, filtering, sorting, inspect and exec, configurable via TOML/JSON. (Rust, 2.0k stars)

---

Canonical: https://www.trmn.sh/tools/kbt