https://github.com/leaf76/lazy_blacktea

PyQt desktop GUI for Android ADB power-users — batch install, logs, screenshots, and multi-device automation.
https://github.com/leaf76/lazy_blacktea

adb android appimage automation debug developer-tools gui linux macos pyqt

Last synced: 3 months ago
JSON representation

PyQt desktop GUI for Android ADB power-users — batch install, logs, screenshots, and multi-device automation.

• Host: GitHub
• URL: https://github.com/leaf76/lazy_blacktea
• Owner: leaf76
• License: mit
• Created: 2025-09-23T16:12:37.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2026-03-05T19:11:13.000Z (3 months ago)
• Last Synced: 2026-03-05T22:28:43.801Z (3 months ago)
• Topics: adb, android, appimage, automation, debug, developer-tools, gui, linux, macos, pyqt
• Language: Python
• Homepage:
• Size: 3.22 MB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# Lazy Blacktea

![Lazy Blacktea logo](assets/icons/icon_128x128.png)

[![Build Status](https://github.com/cy76/lazy_blacktea/workflows/build/badge.svg)](https://github.com/cy76/lazy_blacktea/actions)

[![Test Status](https://github.com/cy76/lazy_blacktea/workflows/test/badge.svg)](https://github.com/cy76/lazy_blacktea/actions)

[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

> Current release: v0.0.51 (2026-03-06)

> Release notes: [CHANGELOG.md](CHANGELOG.md)

**Languages:** English | [繁體中文](README_zh-TW.md)

## Project Status

This Python/PyQt6 version may no longer receive active maintenance or new releases.

For a Rust-based version, please use: 

## Why Lazy Blacktea?

- Monitor multiple Android devices and schedule operations from a single window.

- Ship ready-to-run automation tasks (install, record, capture, shell commands, logcat streaming).

- Offer a clear device table, progress indicators, and dual light/dark themes.

- Accelerate heavy I/O and file workloads with a Rust native companion module.

- Rely on built-in tests and CI pipelines to lower regression risks.

## Quick Start

See the full setup guide in [docs/quickstart.md](docs/quickstart.md).

```bash

uv run python lazy_blacktea_pyqt.py

```

For headless environments (CI, remote), add `QT_QPA_PLATFORM=offscreen`.

## Core Features

| Area | Highlights | Key Modules |

| --- | --- | --- |

| Device management | Live discovery, grouping, and dynamic refresh | `ui.async_device_manager`, `ui.device_manager` |

| Automation tasks | Batch installs (with transfer progress + cancel), bug reports, shell, recording, screenshots | `ui.device_operations_manager`, `utils.adb_tools` |

| File workflows | Browse device files, preview, and coordinate export paths | `ui.device_file_browser_manager`, `utils.file_generation_utils` |

| Diagnostics | Logcat streaming, buffer controls, error classification, completion dialogs | `ui.logcat_viewer`, `ui.console_manager`, `ui.error_handler` |

| Performance | Debounced refresh, batched UI updates, native helpers | `utils.debounced_refresh`, `utils.task_dispatcher`, `native_lbb` |

## UI Preview

![Lazy Blacktea overview in dark mode](assets/screenshots/Screenshot_0036.png)

## Architecture

See [docs/architecture.md](docs/architecture.md) for the project tour, module responsibilities, and troubleshooting notes.

## Deployment & Release

See [docs/deployment.md](docs/deployment.md) for packaging steps, version management, and release checklist details.

## Community & Support

- Issue tracker: 

- Discussions: 

- Contribution guide: [`CONTRIBUTING.md`](CONTRIBUTING.md)

- Security reports: submit privately via GitHub Security Advisories.

## How to Contribute

1. Fork the repository and create a feature branch.

2. Practice TDD: add tests, implement the change, refactor when green. Use Conventional Commits.

3. Run `python3 tests/run_tests.py` and update docs or performance notes as needed.

4. Open a pull request with test results, screenshots for UI changes, and relevant context.

## License

Lazy Blacktea ships under the [MIT License](LICENSE); PyQt6 and third-party dependencies keep their respective licenses.

## Roadmap

- Provide richer automation templates and script samples.

- Sync preferences, tagging, and usage metrics via optional cloud services.

- Expand Windows support (experimental).

- Add guided onboarding and interactive tutorials.

Like the project? Drop a ⭐, share it with your team, and tell us how it helped!