Push2Boox 📱📚

在局域网内扫描 Boox（文石）阅读器设备，并通过 BooxDrop HTTP API 推送小说/电子书。

特性

• 🔍 自动扫描 — 扫描局域网内 8085 端口的 Boox 设备
• 📤 一键推送 — 支持单文件和整个目录
• 📚 书库导入 — 可选导入到 Boox 书库
• 🗑️ 远程删除 — 删除设备上的文件
• 📋 文件列表 — 查看设备存储内容
• 🔄 覆盖模式 — 同名文件自动覆盖
• 🪶 轻量依赖 — 仅需 requests（或零依赖用 urllib）
• 🖥️ 跨平台 — macOS / Windows / Linux

安装

# 克隆仓库
git clone https://github.com/YOUR_USERNAME/push2boox.git
cd push2boox

# 安装依赖（可选）
pip install requests

# 或使用安装脚本
bash install.sh

使用方法

# 推送单个文件
python push2boox.py novel.epub

# 推送整个目录
python push2boox.py /path/to/novels/

# 指定设备 IP
python push2boox.py book.pdf --ip 192.168.1.100

# 导入书库模式
python push2boox.py novel.epub --to-library

# 扫描设备
python push2boox.py --scan-only

# 列出设备文件
python push2boox.py --list

# 删除设备文件
python push2boox.py --delete /storage/emulated/0/Books/xxx.epub

原理

Boox 阅读器内置 BooxDrop 应用，在局域网内开放 8085 端口，提供 REST API：

API	方法	功能
/api/ping	GET	心跳检测
/api/device	GET	设备信息
/api/storage/upload	POST	上传文件（覆盖模式）
/api/library/upload	POST	上传并导入书库
/api/storage/batDelete	POST	批量删除文件

无需浏览器、无需 WebDriver、无需 Playwright。

前提条件

1. 电脑和 Boox 设备连接同一 WiFi
2. Boox 设备上打开**「传书」/「BooxDrop」**应用

支持的文件格式

.epub .pdf .mobi .azw .azw3 .txt .doc .docx .rtf .fb2 .cbr .cbz .djvu .chm .html .mp3 .mp4 等 40+ 种格式

License

MIT