Pywayne 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' | Active backend for adb logcat | | 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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wangyendt
• Source: wangyendt/wayne-skills
• License: MIT

Install and usage instructions live in the source repository linked above.