Skip to content
 
 

Repository files navigation

🎧 AirPods 小助手 AirPodsBuddy

AirPodsBuddy
Platform MIT License Version Single exe 3.4MB

给 Windows 的一口甜:点一下,AirPods 就连上。
🏠 产品介绍页 · 📦 下载
奶油黄白 Apple 风 · 常驻托盘 · 优先级连接 · 纯本地零上传
Mac 版开发中(核心:防自动跳走看门狗)→ mac/README.md


🤔 为什么需要它?(和系统设置比一比)

在 iPhone 上连 AirPods:开盖,弹窗,点一下。 在 Windows 上连 AirPods:没有弹窗——Windows 不支持 Apple 的私有协议, 每次都要:

Windows 原生 AirPods 小助手
连接步骤 设置 → 蓝牙和其他设备 → 找到设备 → 点连接(4~5 步) 单击托盘图标 / 点一下大圆钮(1 步)
耳机好几个 每次都要自己找哪个是哪个 按你的优先级自动挑(支持 ▲▼ 排序)
断开 再进设置点断开 右键托盘 → 一键断开全部
音质 容易连成低音质通话模式(HFP) 默认 A2DP+HFP 完整模式
常驻 托盘常驻 + 开机自启,不占任务栏

类似需求的知名开源项目还有 AirPodsDesktopPodBridgeMagicPods—— 它们证明了一件事:Windows 用户苦"连 AirPods 繁琐"久矣。 我们的差异点:3.4MB 单文件、零依赖零后台服务、纯本地零遥测、优先级连接、界面是和星星布丁一起调出来的米白可爱风 💕

✨ 功能

  • 🚀 一键连接/断开:大圆钮一点即连;左键单击托盘图标直接切换(右键才弹菜单)
  • 🧚 星星布丁小宠物:点托盘后她从右下角弹出来陪你等连接——等待张望→ 连上开心跳跃撒💕→断开挥手拜拜,全帧动画+桌面级透明(素材取自 Codex 版星星布丁宠物精灵图)
  • 🥇 设备优先级:列表 ▲▼ 调整顺序,"一键连接"永远先连你最想要的那个; 苹果设备(AirPods / Beats)默认排前面,其他耳机标"其他"不捣乱
  • 🔵 三态托盘图标:未连接=可爱脸 / 已连接=心动脸+绿环 / 连接中=加油脸+旋转弧
  • 🎨 Apple 风界面:奶油黄白底+蜂蜜金主按钮,macOS 级克制质感,长名字优雅截断
  • 🖱️ 无边框窗口可拖动:按住顶栏/标题区即可移动
  • ℹ️ 降噪/通透:Windows 用户态无法访问 Apple 控制通道(需内核驱动,见 MagicPods 路线),菜单内已 诚实说明并指路;Mac 版不存在此限制
  • 🖥️ 托盘常驻:关窗=缩托盘,开机自启,随时唤出
  • 🔒 纯本地:不联网上传任何数据(唯一网络行为=检查 GitHub 新版本)
  • 🔄 自动更新:有新版弹窗一键升级
  • 📋 日志排查:出错不弹窗吓人,全记在本地日志里

📥 下载使用(三步)

  1. Releases 下载 AirPodsBuddy-Windows.zip
  2. 解压,双击 AirPodsBuddy.exe(无需安装;建议放到固定位置)
  3. 耳机先在 Windows 蓝牙设置里配对过一次,之后就只用点它了

⚠️ 个别安全软件可能误报/拦截 AHK 编译的程序(毕竟它会操作蓝牙), 请加入信任列表。程序纯本地运行,可自行审计源码。

💡 极少数精简版系统缺少微软 WebView2 组件(首次运行会自动引导安装, 约 2MB 官方包;断网时也会自动借用本机 Edge 内核,无需手动处理)。 注意:单独安装 Edge 浏览器解决不了这个问题——程序用的是独立的 WebView2 Runtime。

🛠 开发者

  • 技术栈:AutoHotkey v2 + WebView2(系统自带 Edge 内核),编译为单文件 exe
  • 完整文档在 doc/(渐进式披露:初心 / 原理 / 技术方案 / 进度 / 踩坑记录)
  • 构建:改 webui/index.htmlwebui/build_ui.ps1 → Ahk2Exe 编译(详见 doc/02)

🙏 致谢

  • 蓝牙核心逻辑复用自 ChromuSx/BluetoothDeviceConnector(MIT)
  • WebView2 承载使用 thqby 的 WebView2-AHK 库
  • 降噪/通透切换基于 librepods 项目逆向发现的 Apple AAP 协议规范(L2CAP 服务 74ec2172-... + 0x0D 监听模式指令)独立实现, 感谢他们的开创性逆向工作 🙏(协议规范以事实引用,实现为本项目独立编写)
  • 用爱发电 · 捞鱼 & 星星布丁 💕

📄 License

MIT

About

One-click connect / disconnect your AirPods and Bluetooth headphones on Windows. Tray app + Stream Deck plugin (AutoHotkey v2, no install, 2.6 MB).

Topics

Resources

Stars

9 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages