sermonizer 0.1.0

A simple, clean serial monitor with a clean terminal UI for embedded development
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

# 🔌 Sermonizer

[![CI](https://github.com/systemscape/sermonizer/actions/workflows/ci.yml/badge.svg)](https://github.com/systemscape/sermonizer/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Rust](https://img.shields.io/badge/rust-1.70%2B-brightgreen.svg)](https://www.rust-lang.org)

A simple, clean serial monitor with a clean terminal UI for embedded development.

Most terminal-based serial monitors are annoying to use - they have clunky interfaces and no sane defaults. We wanted something that could be quickly spun up to interact with embedded devices during firmware development without any hassle.

## Features

- **Smart auto-scroll**: Follows new data, easy to switch to manual scrolling
- **Clean TUI**: Split view with input at bottom, output on top
- **Auto-detect ports**: Just run `sermonizer` and it finds your device
- **Sane defaults**: 115200 baud, 8 data bits, no parity, 1 stop bit
- **Hex mode**: View binary data as hex bytes
- **Logging**: Save RX/TX data with timestamps
- **Fast**: Built in Rust, handles high baud rates smoothly

## Quick Start

```bash
# Install from source (until published to crates.io)
git clone https://github.com/systemscape/sermonizer.git
cd sermonizer
cargo run --release

# Or install locally
cargo install --path .

# Connect to first available port
sermonizer

# Or specify port and baud
sermonizer --port /dev/ttyUSB0 --baud 115200
# Or with cargo run
cargo run --release -- --port /dev/ttyUSB0 --baud 115200

# List available ports
sermonizer --list
# Or with cargo run
cargo run --release -- --list
```

## Usage

```bash
sermonizer [OPTIONS]

Options:
  -p, --port <PORT>       Serial port path
  -b, --baud <BAUD>       Baud rate (default: 115200)
      --line-ending <E>   Line ending: none|nl|cr|crlf (default: nl)
      --hex               Display data as hex
      --log <FILE>        Log received data
      --tx-log <FILE>     Log transmitted data
      --log-ts            Add timestamps to logs
      --list              List available ports
```

## Controls

- **Type and press Enter**: Send data to device
- **↑↓ / Page Up/Down**: Scroll through output
- **Ctrl+A**: Re-enable auto-scroll
- **Ctrl+C / Esc**: Exit

## Why?

Perfect for:
- Arduino/ESP32 debugging
- Firmware development workflows
- Quick embedded device interaction
- Protocol testing and development

## License

MIT - see [LICENSE](LICENSE) file.