streamtabs 0.1.1

Easy to follow noisy logs without rerunning commands
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

# streamtabs

This makes it easy to follow noisy logs without rerunning commands.

You pipe text in, pass filters as arguments, and get:

- tab `0`: `(all)` lines
- tabs `1..N`: one tab per filter

## Install

From crates.io:

```bash
cargo install streamtabs
```

This installs both binaries:

- `streamtabs`
- `st` (short alias)

## Quick Start

Run with at least one filter:

```bash
tail -f app.log | st error warn info
```

## More Examples

```bash
cat ./file.txt | st foo bar
```

```bash
log stream --style compact | st Error Fault WindowServer
```

## Controls

- `Tab`: next tab
- `0` to `9`: jump to tab number
- `Space`: pause/resume
- `q` or `Ctrl+C`: quit
- Mouse click tab: switch tabs
- Shift+mouse click tab: toggle that tab in the current OR view
- Mouse click line: highlight that line across tabs
- `d`: cancel highlighted line

## Notes

- Run in a terminal (`stdout` must be a TTY).
- `st` requires at least one filter argument.
- Each tab stores up to `5000` lines.

## Screenshots

Live stream:

![Live stream screenshot](docs/screenshots/live.webp)

Filtered tab selected (`3` = `INFO`):

![Filtered tab screenshot](docs/screenshots/filtered.png)

Selected line on `ERROR` tab:

![Selected screenshot](docs/screenshots/selected.png)

Selected `ERROR` line after switching to `DEBUG` tab, then pausing:

![Selected paused switched screenshot](docs/screenshots/selected-paused-switched.png)