A TUI for viewing Android logcat logs.

Reading Android logcat logs shouldn't require heavy tooling:

• adb CLI is cumbersome: Raw adb logcat is difficult to use
• IDEs are resource-heavy: Android Studio consumes significant memory just to view logs
• Alternative editors lack logcat support: Developers using Zed, VS Code, Neovim, or other editors have no integrated option

lazylogcat provides a lightweight, focused TUI for viewing and filtering logcat logs without the overhead.

• adb (Android Debug Bridge) installed and in PATH (see ADB Installation Guide)

brew tap parfenovvs/lazylogcat && brew install lazylogcat

Requires Go 1.24 or higher.

go install github.com/parfenovvs/lazylogcat@latest

Important: This installs the binary to your $GOBIN directory (or $GOPATH/bin if GOBIN is not set). Ensure this directory is in your PATH:

# Check where the binary is installed
go env GOBIN    # If empty, defaults to $(go env GOPATH)/bin

# Verify installation
which lazylogcat

If lazylogcat is not found, add the Go bin directory to your PATH environment variable.

Requires Go 1.24 or higher.

# Clone the repository
git clone https://github.com/parfenovvs/lazylogcat.git
cd lazylogcat

# Build the binary
go build -o lazylogcat .

# Run directly
./lazylogcat

Optional: Move the binary to a directory in your PATH

# Launch the TUI
lazylogcat

# Enable debug logging (to .lazylogcat.log file in working directory)
lazylogcat --debug

• Select with mouse requires holding Shift key in some terminal emulators

Configuration is automatically discovered and merged in layers:

<config-dir>/lazylogcat/config.json → .lazylogcat/config.json → .lazylogcat/config.local.json

Where <config-dir> is the OS-specific user config directory:

• Linux: ~/.config
• macOS: ~/Library/Application Support
• Windows: %AppData%

Each layer overrides the previous. All fields are optional. See the JSON Schema for editor autocompletion.

{
  "$schema": "https://github.com/parfenovvs/lazylogcat/raw/trunk/config.schema.json",
  "display": {
    "color": true,
    "wrap": true,
    "columns": {
      "date": false,
      "time": true,
      "pid": false,
      "tid": false,
      "level": true,
      "tag": true,
      "message": true
    }
  },
  "filter": {
    "package_name": "com.example.app",
    "log_tag": "MainActivity",
    "log_text": "error"
  }
}

This project wouldn't exist without these incredible open source projects:

• Bubble Tea by Charm
• Bubbles by Charm
• Lip Gloss by Charm
• Cobra by spf13
• clipboard by atotto

This project is licensed under the MIT License - see the LICENSE file for details.