https://github.com/parfenovvs/lazylogcat
LazyLogcat - TUI to view Android logs from adb logcat
https://github.com/parfenovvs/lazylogcat
adb android android-development android-studio android-studio-plugin brew bubbletea cli go golang homebrew kmp logcat tui
Last synced: about 1 month ago
JSON representation
LazyLogcat - TUI to view Android logs from adb logcat
- Host: GitHub
- URL: https://github.com/parfenovvs/lazylogcat
- Owner: parfenovvs
- License: mit
- Created: 2026-01-03T13:05:59.000Z (5 months ago)
- Default Branch: trunk
- Last Pushed: 2026-03-14T16:56:25.000Z (2 months ago)
- Last Synced: 2026-03-15T00:30:16.533Z (2 months ago)
- Topics: adb, android, android-development, android-studio, android-studio-plugin, brew, bubbletea, cli, go, golang, homebrew, kmp, logcat, tui
- Language: Go
- Homepage:
- Size: 1.35 MB
- Stars: 31
- Watchers: 0
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# lazylogcat
[](https://github.com/parfenovvs/lazylogcat/actions/workflows/auto.yml)
[](https://go.dev/)
[](https://github.com/parfenovvs/lazylogcat/releases/latest)
[](https://goreportcard.com/report/github.com/parfenovvs/lazylogcat)
A TUI for viewing Android logcat logs.
## 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.
## Prerequisites
- `adb` (Android Debug Bridge) installed and in PATH (see [ADB Installation Guide](https://developer.android.com/tools/adb))
## Installation
```bash
brew tap parfenovvs/lazylogcat && brew install lazylogcat
```
## Usage
```bash
# Launch the TUI
lazylogcat
# Enable debug logging (to .lazylogcat.log file in working directory)
lazylogcat --debug
```
### Tips
- Select with mouse requires holding `Shift` key in some terminal emulators
## Configuration
Configuration is automatically discovered and merged in layers:
`/lazylogcat/config.json` → `.lazylogcat/config.json` → `.lazylogcat/config.local.json`
Where `` 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.