Splash adds beautiful, adaptive colors to make logs easier to read.

Features

• Auto-detection of 16 popular log formats including programming language stack traces
• Mixed formats - handles multiple log formats in a single stream
• Search highlighting with string or regex patterns
• Adaptive colors that work with both light and dark terminals
• Streaming performance - processes logs in real-time
• Zero configuration - No config. Just pipe.

Screenshots

Splash supports many standard log formats and output from popular languages like go (test logs), java (exceptions), and python (tracebacks)

Installation

Install from Homebrew (Recommended)

brew tap joshi4/splash
brew install splash

For Linux users

curl -fsSL https://install.getsplash.sh | sh

For Go users

go install github.com/joshi4/splash@latest

Get Started

The easiest way to use Splash is to pipe any log output through it:

Basic Usage

echo '{"timestamp":"2025-01-19T10:30:00Z","level":"ERROR","message":"Connection failed","service":"api"}' | splash

Highlight errors

{ echo '{"level":"INFO","msg":"Starting up"}'; echo '{"level":"ERROR","msg":"Connection failed"}'; echo '{"level":"WARN","msg":"Slow query"}'; } | splash -s "ERROR"

Create HTTP logs and highlight error status codes

{ echo '192.168.1.1 - - [19/Jan/2025:10:30:00 +0000] "GET /api HTTP/1.1" 200 1234'; echo '192.168.1.2 - - [19/Jan/2025:10:30:01 +0000] "POST /api HTTP/1.1" 404 567'; } | splash -r "[45]\d\d"

Generate and monitor continuous output

while true; do echo "$(date -Iseconds) INFO Server is healthy"; sleep 2; done | splash

Create a mix of log formats to test detection

{
  echo 'Jan 19 10:30:00 localhost myapp[1234]: INFO Application started'
  echo '{"timestamp":"2025-01-19T10:30:01Z","level":"WARN","message":"High memory usage"}'
  echo '127.0.0.1 - - [19/Jan/2025:10:30:02 +0000] "GET /health HTTP/1.1" 200 15'
} | splash

Use with curl to monitor API responses (requires jq)

curl -s httpbin.org/json | jq -c . | splash

🔧 Command Line Options

splash [flags]

Flags:
  -s, --search string    Highlight lines containing this text
  -r, --regexp string    Highlight lines matching this regex pattern
  -h, --help            Show help information

Note: You cannot use both -s and -r flags simultaneously.

Programming Language Features

Splash provides specialized support for debugging and development outputs from popular programming languages:

Standard Log Formats

Splash automatically detects and colorizes these conventional log formats:

Build from Source

git clone https://github.com/joshi4/splash.git
cd splash
go build

FAQ

I'm using a supported log format but it's not being detected. What should I do?

Sometimes logs are written to stderr instead of stdout. Try redirecting stderr to stdout:

your_command 2>&1 | splash

Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature-name
3. Make your changes and add tests
4. Run tests: go test ./...
5. Submit a pull request