# get-logcat

**Repository Path**: Minger1/get-logcat

## Basic Information

- **Project Name**: get-logcat
- **Description**: 项目简介  
一款基于 ADB 的 Logcat 可视化工具，无需手动输入命令行，一步直达，让 Android 测试与开发更高效、更直观。

主要功能 
1. 可视化日志监控  
2. 设备与应用管理  
3.内置脚本自动下载、解压并配置 ADB
4.直接使用本地 APK 一键安装至设备
5. 跨平台文件传输，安卓与pc互传文件
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-04
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: ADB, Python, 可视化, 测试

## README



# Get Logcat

Get Logcat 是一款基于 Python 和 tkinter 构建的 Android 设备日志查看与管理工具。通过 ADB (Android Debug Bridge) 实现与 Android 设备的通信，提供实时日志查看、文件传输、应用管理、屏幕截图、Shell 命令执行等功能，是 Android 开发者和测试人员的得力助手。

## ✨ 功能特性

### 📱 设备管理
- **自动设备检测**：实时监控设备连接状态，自动刷新设备列表
- **多设备支持**：同时连接多台设备时，可自由切换目标设备
- **会话记忆**：自动记住上次使用的设备和应用，快速恢复工作状态

### 📋 日志查看
- **实时日志流**：实时接收并显示 Android 设备 logcat 输出
- **日志级别过滤**：支持按 Verbose、Debug、Info、Warning、Error、Fatal、Silent 级别过滤
- **应用日志筛选**：选择特定应用只看其日志输出，或查看所有进程日志
- **日志搜索**：高亮显示搜索结果，支持上一个/下一个匹配项跳转
- **自动底部跳转**：新日志到达时自动滚动到底部，也可手动切换
- **日志内容清除**：一键清空当前显示的日志内容

### 📂 文件管理
- **双向传输**：支持 Windows 电脑与 Android 设备之间的文件/文件夹互传
- **文件夹压缩传输**：文件夹可自动压缩为 ZIP 包传输，到达后自动解压
- **隐藏文件显示**：可切换显示/隐藏系统文件
- **常用路径快速访问**：支持快速跳转到常用目录

### 📦 应用管理
- **应用列表查看**：显示设备上已安装的所有应用（含第三方应用筛选）
- **应用卸载**：快速卸载选中的应用
- **清除应用数据**：清除指定应用的缓存和数据
- **复制包名**：一键复制应用包名

### 🖼️ 屏幕功能
- **屏幕截图**：一键截取设备屏幕，保存到指定目录
- **屏幕录制**：录制设备屏幕视频，支持设置保存路径
- **文件夹直达**：截图/录像完成后可直接打开保存目录

### 💻 Shell 命令执行
- **交互式终端**：内置 Shell 命令执行窗口
- **预设命令**：可保存常用命令为预设，一键快速执行
- **命令历史**：自动保存执行过的命令，支持上下键翻阅历史
- **结果导出**：支持复制命令、复制输出、导出输出到文件
- **自动保存**：执行命令后自动保存输出结果

### ⚙️ 系统设置
- **界面主题**：支持浅色/深色模式一键切换
- **颜色自定义**：可自定义日志各级别的文字颜色
- **快捷设置**：软件启动时自动加载上次设置

### 🔄 自动更新
- **版本检测**：启动时自动检查最新版本
- **一键更新**：发现新版本时可直接下载更新
- **更新脚本**：自动创建更新脚本，确保更新过程安全可靠

### 🔧 实用工具
- **ADB 安装助手**：检测 ADB 是否已安装，未安装时可自动下载安装
- **输入粘贴**：将剪贴板内容直接输入到 Android 设备
- **Gitee 发布工具**：可直接从本地创建 Gitee Release 并上传文件

## 📋 环境要求

- **操作系统**：Windows 10/11 (主要支持)，Linux/macOS 可通过源码运行
- **Python 版本**：Python 3.8+
- **依赖库**：tkinter (GUI), requests (网络), cryptography (加密)
- **ADB 环境**：Android Debug Bridge (可使用内置安装工具安装)

## 🚀 快速开始

### 方式一：运行源码

```bash
# 克隆仓库
git clone https://gitee.com/Minger1/get-logcat.git
cd get-logcat

# 安装依赖
pip install -r requirements.txt

# 运行程序
python app.py
```

### 方式二：使用可执行文件

下载 `dist/ADB Tool.exe` 直接运行，无需安装 Python 环境。

## 📖 使用说明

### 1. 连接设备
确保 Android 设备已开启「开发者选项」-「USB 调试」，使用 USB 数据线连接电脑后，软件将自动检测并显示设备列表。

### 2. 选择应用
在应用列表中选择需要查看日志的目标应用，或选择「所有进程」查看系统全部日志。

### 3. 查看日志
日志将实时显示在主窗口中，可通过顶部的日志级别按钮筛选日志内容，使用搜索框进行关键词搜索。

### 4. 传输文件
点击菜单栏「文件传输」，在弹出的窗口中可进行双向文件拖拽传输。

### 5. 执行命令
点击菜单栏「Shell 执行器」，可执行自定义 ADB Shell 命令。

## 📁 项目结构

```
get-logcat/
├── app.py                    # 主程序入口及核心类
├── create_release_thread.py  # Gitee Release 创建工具
├── windebug.py              # Windows 调试工具
├── coolo/                   # 测试相关模块
│   ├── coolo_test.py       # 音频上传压力测试
│   ├── coolo_test2.py      # 音频上传压力测试 v2
│   └── file_name.py        # 文件选择 GUI
├── image/                   # 程序图标资源
├── build/                   # 打包构建文件
├── dist/                    # 可执行文件输出目录
├── requirements.txt         # Python 依赖列表
└── README.md               # 项目说明文档
```

## 📝 依赖列表

```
requests>=2.25.0
cryptography>=3.4.0
```

> tkinter 为 Python 标准库组件，通常已默认安装。

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request 共同完善本项目。

## 📄 开源许可

本项目基于 MIT License 开源。

## 📧 联系方式

- 项目地址：https://gitee.com/Minger1/get-logcat
- 问题反馈：https://gitee.com/Minger1/get-logcat/issues

---

**Happy Debugging!** 🔍