lview/README.md

1.5 KiB

lview

A TUI for viewing logs on remote Linux machines over SSH. It automatically detects system logs, Docker containers, /opt applications, and the systemd journal.

Installation

macOS (Homebrew)

brew tap janvete/tools
brew install lview

Debian / Ubuntu (.deb)

Download the latest .deb from GitHub Releases and install it:

sudo apt install ./lview_*.deb
# or
sudo dpkg -i ./lview_*.deb

From source

cargo install --git https://github.com/janvete/lview

Usage

lview ssh -p22 root@192.168.53.3

All arguments after ssh are passed directly to the system ssh command, so your ~/.ssh/config, SSH agent, and keys are used automatically.

Controls

Log picker

Key Action
j / k or ↓ / ↑ move through the list
Enter open the selected log
/ fuzzy filter the log list
r reload the log list
q quit

Log viewer

Key Action
j / k or ↓ / ↑ scroll
Ctrl+d / Ctrl+u scroll by 10 lines
g / G jump to top / bottom
l or space toggle live preview
/ search in the log (regex, case-insensitive)
n / N next / previous match
s save the current buffer to /tmp
q or Esc back to the picker

Configuration

Create ~/.config/lview/config.toml:

ssh_command = "ssh"
max_log_lines = 10000
discovery_timeout = 10
extra_paths = ["/custom/logs"]

License

MIT