yapper 0.3.0

A modern, ergonomic UART serial TUI terminal for embedded workflows
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

# yapper 🔌

A snappy, ergonomic serial terminal for embedded workflows. Built with Rust + [ratatui](https://ratatui.rs).

## Features

- **Port auto-detection** — Scans system ports, select with `p`
- **Interactive UART settings** — Press `s` to configure baud, data bits, parity, stop bits, flow control on-the-fly
- **Mouse support** — Scroll wheel, click-to-focus, drag-to-select + copy to clipboard
- **Search** — Vim-style `/` search with match highlighting and `n`/`N` navigation
- **Hex view** — Toggle raw hex dump with `h`
- **Command history** — Persistent across sessions, navigate with `↑`/`↓`
- **Session logging** — Auto-timestamped log files, toggle with `l`
- **Macro system** — Define command sequences in `macros.toml`
- **Regex filters** — Include/exclude lines by pattern
- **Auto-reconnect** — Reconnects automatically on port disconnect
- **Timestamps & line endings** — Per-line timestamps (`t`), line ending indicators (`e`)
- **Dracula theme** — Easy on the eyes during long debug sessions

## Install

```bash
cargo install --path .
```

## Usage

```bash
# Auto-detect port
yapper

# Specify port and baud rate
yapper /dev/ttyUSB0 115200

# Full configuration
yapper /dev/ttyACM0 9600 --data-bits 8 --parity none --stop-bits 1
```

### WSL

Works with `cargo.exe run` from WSL — connects to Windows COM ports directly.

## Keybindings

| Key | Action |
|-----|--------|
| `i` | Enter input mode |
| `Esc` | Back to normal mode |
| `p` | Port selector |
| `s` | UART settings |
| `c` | Connect/disconnect |
| `j`/`k` | Scroll up/down |
| `G`/`g` | Scroll to bottom/top |
| `/` | Search |
| `n`/`N` | Next/prev match |
| `h` | Hex view |
| `t` | Timestamps |
| `e` | Line endings |
| `l` | Toggle logging |
| `?` | Help |
| `q` | Quit |

### Mouse

| Action | Effect |
|--------|--------|
| Scroll wheel | Scroll output / navigate popups |
| Click input bar | Focus input |
| Click status bar | Connect (left) / Settings (right) |
| Click-drag | Select text → copies to clipboard |

## Configuration

### Macros

Create `~/.config/yapper/macros.toml`:

```toml
[[macros]]
name = "reset"
commands = ["AT+RST"]

[[macros]]
name = "init_wifi"
commands = ["AT+CWMODE=1", "AT+CWJAP=\"SSID\",\"PASS\""]
delay_ms = 500
```

## License

MIT