lazylogcat

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #go #machine-learning #deep-learning #docker #windows #awesome #vue #pytorch #openai #open-source

(★ 64)

LazyLogcat - TUI to view Android logs from adb logcat

lazylogcat Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# lazylogcat

[![Build Status](https://github.com/parfenovvs/lazylogcat/actions/workflows/auto.yml/badge.svg?branch=trunk)](https://github.com/parfenovvs/lazylogcat/actions/workflows/auto.yml)
[![Go Version](https://img.shields.io/badge/go-%3E%3D1.25-00ADD8?logo=go)](https://go.dev/)
[![Release](https://img.shields.io/github/v/release/parfenovvs/lazylogcat)](https://github.com/parfenovvs/lazylogcat/releases/latest)
[![Go Report Card](https://goreportcard.com/badge/github.com/parfenovvs/lazylogcat)](https://goreportcard.com/report/github.com/parfenovvs/lazylogcat)

A TUI for viewing Android logcat logs.

[YouTube Demo](https://youtu.be/ochaEmJQDlM)

## Motivation

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.

![demo](https://raw.githubusercontent.com/parfenovvs/lazylogcat/trunk/demo.png)

## Prerequisites

- `adb` (Android Debug Bridge) installed and in PATH (see [ADB Installation Guide](https://developer.android.com/tools/adb))

## Installation

```bash
brew install parfenovvs/lazylogcat/lazylogcat
```

## Usage

```bash
# Launch the TUI
lazylogcat

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

### Agent skill

The binary embeds a skill for AI coding agents. Use `lazylogcat skill install --help` for supported `--agent` names and details.

```bash
lazylogcat skill install --agent <agent> --user     # under $HOME
lazylogcat skill install --agent <agent> --project  # under cwd
```

Pass **`--agent`** and exactly one of **`--user`** or **`--project`**.

### Tips

- Select with mouse requires holding `Shift` key in some terminal emulators

## Configuration

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](config.schema.json) for editor autocompletion.

```json
{
  "$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"
  }
}
```

## Acknowledgments

This project wouldn't exist without these open source projects. The TUI stack uses **Bubble Tea v2** and related libraries published on `charm.land` (successors to the original [Charm](https://github.com/charmbracelet) GitHub modules):

- **[Bubble Tea](https://pkg.go.dev/charm.land/bubbletea/v2)** (`charm.land/bubbletea/v2`)
- **[Bubbles](https://pkg.go.dev/charm.land/bubbles/v2)** (`charm.land/bubbles/v2`)
- **[Lip Gloss](https://pkg.go.dev/charm.land/lipgloss/v2)** (`charm.land/lipgloss/v2`)
- **[Cobra](https://github.com/spf13/cobra)** by spf13
- **[clipboard](https://github.com/atotto/clipboard)** by atotto

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

lazylogcat

lazylogcat Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

lazylogcat

lazylogcat Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README