# adb_terminal_tools

**Repository Path**: felix641/adb_terminal_tools

## Basic Information

- **Project Name**: adb_terminal_tools
- **Description**: AR设备终端工具，基于Android调试工具adb命令和scrcpy实现
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-06
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# adb_terminal_tools

#### 介绍
AR设备终端工具\
可以用于AR眼镜+终端设备的验证\
未做主题皮肤更新 screen.py\
已做主题皮肤更新 screen_theme.py\
mac环境的源码 screen_mac.py\
Windows环境源码 screen_windows.py\
浏览器web版本 screen_web.py


#### 软件架构
基于adb命令和scrcpy工具实现 \
GUI界面使用python内库tkinter实现 \
Windows源码：adb_terminal_tools/bin/screen_windows.py \
Mac源码：adb_terminal_tools/bin/screen_mac.py \
windows和mac源码基本一致，只是gui适配和布局有点区别，mac使用默认背景\
screen_theme.py 主题皮肤版本\
screen_web.py web版本

#### 安装教程

1.  可以下载安装包或源码运行（源码目录 adb_terminal_tools/bin/screen_windows.py）
2.  Mac或Linux系统需要自己安装[adb工具](https://developer.android.com/studio/releases/platform-tools?hl=zh-cn)和[scrcpy工具](https://github.com/Genymobile/scrcpy/releases/tag/v2.3.1)
3.  Windows电脑不需要安装，直接双击run.exe运行

#### 打包说明
1. 可以根据个人喜好选择不同的打包工具，例如：Nuitka，PyInstaller，Pynsist等。
2. 把打包好的文件，如screen.exe放在bin文件夹下，双击screen.exe运行程序；
3. 本工具提供了打包好的文件，下载并解压，双击run.exe运行即可，如有功能修改，只需替换bin目录下的screen.exe文件即可；

#### 使用说明

1.  目前工具菜单功能分别为，基本功能，其他功能，系统功能，默认显示基本功能
![4.jpg](./img/4.jpg)
2.  分别对应功能页面如下
![1.jpg](./img/1.jpg)
![2.jpg](./img/2.jpg)
![3.jpg](./img/3.jpg)
3. 基本功能页面，导出日志可以自定义日志名称，未填写使用默认时间戳命名；
4. 查询版本号，需要输入应用程序包名实现查询，和导出日志命名输入框是同一个入口
5. 连接设备可以实现全局多设备的切换，默认连接第一个设备
6. 修改bin/port.ini可以实现web版本，不同端口请求

#### 参考贡献

1.  https://developer.android.com/tools/adb?hl=zh-cn
2.  https://github.com/Genymobile/scrcpy