AppleJuice 项目使用教程
1. 项目目录结构及介绍
AppleJuice 项目的目录结构如下:
AppleJuice/
├── ESP32-Arduino/
│ └── applejuiceESP32-Arduino/
├── Pico_Pi_W_MicroPython/
├── applejuice-stick-c-plus/
├── utils/
│ ├── editorconfig
│ └── gitignore
├── LICENSE
├── README.md
├── app.py
└── requirements.txt
目录结构介绍
- ESP32-Arduino/: 包含适用于 ESP32 设备的 Arduino 代码。
- Pico_Pi_W_MicroPython/: 包含适用于 Raspberry Pi Pico W 设备的 MicroPython 代码。
- applejuice-stick-c-plus/: 包含适用于特定设备的代码。
- utils/: 包含项目使用的实用工具文件,如
.editorconfig
和.gitignore
。 - LICENSE: 项目的开源许可证文件。
- README.md: 项目的介绍和使用说明。
- app.py: 项目的启动文件,用于执行 Apple BLE 接近配对消息欺骗。
- requirements.txt: 项目所需的 Python 依赖包列表。
2. 项目的启动文件介绍
app.py
app.py
是 AppleJuice 项目的主要启动文件。它负责执行 Apple BLE 接近配对消息欺骗。以下是该文件的主要功能和使用方法:
主要功能
- BLE 消息欺骗: 通过蓝牙低功耗(BLE)发送接近配对消息到 Apple 设备。
- 消息选项: 支持多种 Apple 设备的消息选项,如 AirPods、Beats 耳机、Apple TV 等。
使用方法
-
运行脚本:
python3 app.py
-
选择消息选项:
python3 app.py -d <选项编号>
例如,发送 Beats Solo Pro 的消息:
python3 app.py -d 9
-
随机模式: 可以使用
--random
或-r
选项启用随机模式,并设置时间间隔:python3 app.py --random -i 20
3. 项目的配置文件介绍
requirements.txt
requirements.txt
文件列出了项目运行所需的 Python 依赖包。以下是该文件的内容示例:
pybluez
pycryptodome
安装依赖
要安装这些依赖包,请在项目根目录下运行以下命令:
pip install -r requirements.txt
其他配置文件
.editorconfig
: 用于统一项目代码风格的配置文件。.gitignore
: 用于指定 Git 版本控制系统忽略的文件和目录。
通过以上步骤,您可以顺利地启动和配置 AppleJuice 项目,并开始使用其功能。