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 https://git.janvete.com/seth/homebrew-tools.git
brew install lview

Debian / Ubuntu (APT)

echo "deb [trusted=yes] https://git.janvete.com/seth/apt/raw/branch/main ./" | sudo tee /etc/apt/sources.list.d/janvete.list
sudo apt update
sudo apt install lview

From source

cargo install --git ssh://git@git-ssh.janvete.com:554/seth/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

1.6 KiB Raw Permalink Blame History