Quick Start#

Install#

curl -fsSL https://raw.githubusercontent.com/shinagawa-web/tinytap/main/scripts/install.sh | sh

Run#

Grant it the capabilities it needs, then run it (no full root required):

sudo setcap cap_dac_read_search,cap_perfmon,cap_bpf,cap_sys_admin,cap_syslog=eip $(command -v tinytap)
tinytap

That’s the full set: plaintext HTTP and HTTPS (via the libssl uprobes, cap_sys_admin) both work out of the box. See Running Without Full Root if you want the smaller plaintext-only set instead, or a breakdown of what each capability actually covers.

With no config file, that opens the TUI (j/k to scroll, Enter for the detail panel, q or Ctrl-C to quit) as long as your terminal is at least 120x24. In a smaller or non-interactive terminal it prints guidance and exits instead of silently streaming; see Configuration to switch to the line-oriented stdout mode.

Next steps#

Linux amd64/arm64 only. On macOS/Windows, see Where tinytap Runs. Want a specific version, or to build from source instead? See Installing & Verifying Releases or the repo’s CONTRIBUTING.md for building from source.

Didn’t work? See Troubleshooting.