logpulse 0.1.0

High-performance TUI log analyzer with smart format detection
logpulse-0.1.0 is not a library.

Install

One-liner (Linux / macOS):

curl -fsSL https://raw.githubusercontent.com/vltamanec/logpulse/main/install.sh | sh

Cargo (from source):

cargo install logpulse

Manual download: grab a binary from Releases.

Platform Binary
Linux x86_64 logpulse-vX.X.X-x86_64-unknown-linux-gnu.tar.gz
Linux ARM64 logpulse-vX.X.X-aarch64-unknown-linux-gnu.tar.gz
macOS x86_64 logpulse-vX.X.X-x86_64-apple-darwin.tar.gz
macOS ARM64 (Apple Silicon) logpulse-vX.X.X-aarch64-apple-darwin.tar.gz
Windows x86_64 logpulse-vX.X.X-x86_64-pc-windows-msvc.zip

Shell completions:

# Bash
logpulse --completions bash > ~/.local/share/bash-completion/completions/logpulse

# Zsh
logpulse --completions zsh > ~/.zfunc/_logpulse

# Fish
logpulse --completions fish > ~/.config/fish/completions/logpulse.fish

Quick Start

# Local log file
logpulse /var/log/syslog

# Multiple files at once
logpulse app.log nginx.log error.log

# Force a specific parser
logpulse --format laravel storage/logs/laravel.log

# Pipe from Docker (auto-detects stdin)
docker logs -f my-app 2>&1 | logpulse

# Docker container — log file inside
logpulse docker my-app /var/log/app.log

# Docker container — stdout
logpulse docker my-app

Hotkeys

Key Action
q Quit
Space Pause / Resume (freeze mode)
/ Filter — regex search, Enter to apply, Esc to cancel
e Toggle error-only mode
Enter Detail view (JSON pretty-print / stacktrace)
c Clear screen buffer
j / k or Up / Down Navigate log lines
Esc Close detail view / cancel filter
Ctrl+C Force quit

Supported Formats

LogPulse auto-detects the log format from the first lines. No configuration needed. Use --format to override: logpulse --format nginx access.log

Format Flag Example
JSON --format json {"level":"error","msg":"failed","service":"api"}
Laravel --format laravel [2024-01-15 10:30:01] production.ERROR: Connection refused
Django --format django [15/Jan/2024 10:30:11] ERROR [django.request] Internal Server Error
Go (slog) --format go time=2024-01-15T10:30:09Z level=ERROR msg="panic recovered"
Nginx/Apache --format nginx 192.168.1.1 - - [15/Jan/2024:10:30:07] "GET /api" 500 89
Plain text --format plain Anything else — level detected by keywords

How It Works

┌─ LogPulse ──────────────────────────┬─ Activity ─────────────────┐
│ app.log | EPS: 42 | Errors: 3      │ ▁▂▃▅▇▅▃▂▁▂▃▅▇█▇▅▃▂▁      │
├─ Log Feed ──────────────────────────┴────────────────────────────┤
│ [ERROR] Connection refused to database                           │
│ [INFO]  Request processed successfully                           │
│ [WARN]  Slow query detected (2.5s)                              │
│ [DEBUG] Cache hit for key=user:123                               │
│ [ERROR] Undefined variable: $user                                │
├─ Help ──────────────────────────────────────────────────────────┤
│ q:quit Space:pause /:filter e:errors Enter:detail c:clear ↑↓:nav│
└─────────────────────────────────────────────────────────────────┘

Requirements

  • Local mode: just the binary
  • Docker mode: docker CLI available and running
  • Stdin mode: pipe anything in

Binary is ~2.7 MB, statically optimized. No runtime dependencies.

Building from Source

git clone https://github.com/vltamanec/logpulse.git
cd logpulse
cargo build --release
cargo test
# Binary at ./target/release/logpulse

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT