Pywayne Adb Logcat Reader

Android device logcat reader for real-time log monitoring. Use when working with pywayne.adb.logcat_reader module to read Android device logs via adb logcat command, supporting both C++ backend (faster) and Python backend (subprocess) with generator-style output for streaming logs.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install adb-logcat-reader

Pywayne ADB Logcat Reader

This module provides real-time Android device log reading capabilities via the adb logcat command.

Quick Start

from pywayne.adb.logcat_reader import AdbLogcatReader

# Create reader (default C++ backend)
reader = AdbLogcatReader()

# Start log capture and read
reader.start()
for line in reader.read():
    print(line)

Use Python backend (alternative)

reader = AdbLogcatReader(backend='python') reader.start() for line in reader.read(): print(line)


# Stop and cleanup
reader.stop()

Initialization

# C++ backend (default, faster)
reader = AdbLogcatReader()

# Python backend (alternative, may be more compatible)
reader = AdbLogcatReader(backend='python')

Reading Logs

The read() method yields log lines incrementally as a generator, suitable for processing large logs or real-time monitoring.

# Process logs as they arrive
for line in reader.read():
    # Filter, parse, store...

Properties

Property	Description
`backend`	'cpp' or 'python'
`running`	Whether logcat process is running

Methods

Method	Description
`start()`	Start adb logcat process
`read()`	Generator yielding log lines
`stop()`	Stop logcat process
`get_backend()`	Get active backend type

Backends

C++ Backend (Default)

Uses native C++ implementation
Faster performance for real-time streaming
Better compatibility with adb logcat

Python Backend (Alternative)

Uses Python subprocess to call adb
More compatible across different environments
Easier debugging and integration

Notes

C++ backend is faster and recommended for production
Python backend may be useful during development
stop() terminates adb logcat; use Ctrl+C to send interrupt signal
Logs are cleared automatically when process stops