librepods-org/librepodsAirPods, освобождённые из экосистемы Apple.
> [!WARNING] > librepods.org не является официальным сайтом проекта LibrePods. Он некорректно заявляет о себе как об официальном сайте проекта, указывая копирайты и используя логотип LibrePods в подвале. При этом они утверждают, что проект не связан с LibrePods или его разработчиками. > > Пожалуйста, сообщайте о других подобных сайтах на [[email protected]](mailto:[email protected]) <picture> <source media="(prefers-color-scheme: dark)" srcset="./imgs/banner-dark.png" /> <source media="(prefers-color-scheme: light)" srcset="./imgs/banner.png" /> <img alt="LibrePods" src="https://assets.kitploit.com/production/public/readmes/7308/dd79739201ddda9382b9f24871abdd8b39e75645fe7c341831c76ed98b61f805.png" /> </picture> <div align="center" style="margin: 20px 0px;"> <a href="https://github.com/kavishdevar/librepods/releases/latest"> <img src="https://img.shields.io/github/downloads/kavishdevar/librepods/total?label=GitHub%20Downloads" /> </a> <a href="https://github.com/kavishdevar/librepods/actions/workflows/ci-android.yml"> <img src="https://github.com/kavishdevar/librepods/actions/workflows/ci-android.yml/badge.svg" /> </a> <a href="https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml"> <img src="https://github.com/kavishdevar/librepods/actions/workflows/ci-linux-rust.yml/badge.svg" /> </a> <a href="https://github.com/kavishdevar/librepods/issues"> <img src="https://img.shields.io/github/issues/kavishdevar/librepods" /> </a> <a href="https://discord.gg/HhG4ycVum4"> <img src="https://img.shields.io/discord/1441416992027574375?logoColor=white&color=5865F2&label=Discord" /> </a> </div> # Что такое LibrePods? LibrePods позволяет использовать функции AirPods, которые доступны исключительно на устройствах Apple. Он реализует проприетарный протокол, используемый для обмена данными между AirPods и устройствами Apple, обеспечивая такие функции, как переключение режимов шумоподавления, быстрое обнаружение надетых наушников, точный статус заряда, управление жестами головы, распознавание разговора и многое другое на не-Apple платформах. # Доступность функций | Функция | Linux | Android | | ----------------------------------------------------------- | ----- | ------- | | Изменение режима прослушивания | ✅ | ✅ | | Обнаружение в ухе | ✅ | ✅ | | Состояние батареи | ✅ | ✅ | | Переименование AirPods <details><summary>Примечание для Android</summary>На Android после переименования AirPods необходимо заново выполнить сопряжение, поскольку Android может не использовать новое имя.</details> | ✅ | ✅ | | Снижение громких звуков | 🔴 | ⚪ | | Жесты головой | ⛔ | ✅ | | Осведомлённость о разговоре | ✅ | ✅ | | Автоматическое подключение к AirPods | ✅ | ✅ | | Слуховой аппарат | 🔴 | ⚪ | | Настройка режима прозрачности | 🔴 | ⚪ | | Подключение к нескольким устройствам (Bluetooth Multipoint; только 2 устройства) | ⚪ | ⚪ | | <details><summary>Другие настройки доступности (нажмите, чтобы развернуть)</summary><ul><li>Скорость нажатия</li><li>Длительность нажатия и удержания</li><li>Шумоподавление с одним AirPod</li><li>Регулировка громкости свайпом</li><li>Скорость свайпа громкости</li></ul></details> | 🔴 | ✅ | | <details><summary>Другие общие настройки</summary><ul><li>Нажатие и удержание для переключения между режимами прослушивания/вызова цифрового ассистента (для вызова цифрового ассистента требуется свежая прошивка)</li><li>Настройка управления вызовами</li><li>Персонализированная громкость</li><li>Снижение громких звуков (требуется <a href="#vendorid-spoofing">подмена VendorID</a>)</li><li>Сторона микрофона</li><li>Приостановка воспроизведения при засыпании (требуется свежая прошивка)</li><li>Включите <code>режим прослушивания Off</code> для переключения в <code>Off</code></li></ul></details> | 🔴 | ✅ | | [Пространственное аудио с отслеживанием головы](#spatial-audio) | ❓ | ❓ | | [Мониторинг пульса](#heart-rate-monitoring) | 🔴 | 🟡 | | [Find My](#find-my) | ❓ | ❓ | | [Высококачественное двустороннее аудио](#high-quality-two-way-audio) | 🟡 | 🟡 | | Символ | Значение | | ------ | ------------------------------------------------------------------- | | ✅ | Реализовано и работает хорошо | | ⚪ | Требуется [подмена VendorID](#vendorid-spoofing); используйте на свой страх и риск | | 🟡 | Экспериментально/в разработке | | 🔴 | Ещё не реализовано; запланировано | | ⛔ | Не будет реализовано | | ❓ | Неизвестно | ## Find My Следующие функции, связанные с Find My, запланированы, но требуют дополнительного RE и могут потребовать root на Android: - Добавление ваших AirPods в сеть Find My - Воспроизведение звука через зарядный кейс для его поиска - Уведомление при оставлении без присмотра - Переключение звуков зарядки кейса ## Пространственное аудио В настоящее время приложение не передаёт информацию об отслеживании головы в Android, чтобы ОС могла выполнять HRTF. Это ещё не изучено полностью и может потребовать root. Пространственное воспроизведение стереозвука выходит за рамки этого проекта и никогда не будет доступно. У многих OEM-производителей есть собственная реализация этого. ## Мониторинг пульса ### Android Доступно в ветке `android/rewrite`. [сборки](https://github.com/librepods-org/librepods/actions/workflows/ci-android.yml?query=branch%3Aandroid%2Frewrite) ### Linux Пока недоступно (впрочем, вряд ли это было бы полезно на компьютере. Если у вас есть предложения, создайте обсуждение.) ## Высококачественное двустороннее аудио На iOS/iPadOS можно продолжать использовать A2DP, пока AirPods передают аудиопоток высокого разрешения (AAC-ELD mono 64kHz?) со своего микрофона через AACP. ### Android Записывайте аудио в приложении с помощью микрофона AirPods, не переключаясь на профиль Headset/Handsfree, который ухудшает качество воспроизведения. Но для того, чтобы сделать это доступным для других приложений/телефонии, может потребоваться root, если это вообще возможно. Recorder находится в разработке; доступен в ветке `android/rewrite`. [сборки](https://github.com/librepods-org/librepods/actions/workflows/ci-android.yml?query=branch%3Aandroid%2Frewrite) ### Linux Ознакомьтесь с [PR #655](https://github.com/librepods-org/librepods/pull/655). # Установка - [**Android**](https://github.com/librepods-org/librepods/blob/main/android/README.md) - [**Linux**](https://github.com/librepods-org/librepods/blob/main/linux/README.md) # Подмена VendorID Оказывается, если изменить VendorID в DID Profile на идентификатор Apple, вы получите доступ к нескольким особым функциям! На Linux это можно сделать, отредактировав DeviceID в `/etc/bluetooth/main.conf`. Добавьте эту строку в файл конфигурации `DeviceID = bluetooth:004C:0000:0000`. На Android можно включить настройку `act as Apple device` в настройках приложения (отображается только когда доступен Xposed и включён модуль LibrePods). ## Подключение к нескольким устройствам К AirPods можно одновременно подключить до двух устройств — как для аудио, так и для управления. Бесшовное переключение соединения. То же уведомление появляется на устройстве Apple, когда Android перехватывает AirPods, как если бы это было устройство Apple («Move to iPhone»). Android также показывает всплывающее окно, когда другое устройство перехватывает управление. ## Настройки доступности и слуховой аппарат Можно настроить параметры доступности, такие как настройка режима прозрачности (усиление, баланс, тембр, усиление речи и снижение окружающего шума), а также снижение громких звуков. Все настройки слухового аппарата можно выполнить с Android (скоро на Linux), включая установку результата аудиограммы. Приложение не предоставляет способа провести тест слуха, поскольку для этого требуется гораздо большая точность. Гораздо лучше использовать уже имеющийся результат аудиограммы. # Протокол и обратная разработка Пожалуйста, обратитесь к плагину-диссектору Wireshark от Nojus ([@pabloaul](https://github.com/pabloaul)) для получения дополнительной информации об используемых протоколах: [pabloaul/apple-wireshark](https://github.com/pabloaul/apple-wireshark) Диссектор не использовался в LibrePods на протяжении большей части реализации; я сам провёл обратную разработку протокола до того, как этот диссектор был создан. Но многие (будущие) функции, включая двустороннее аудио высокого качества и пространственное аудио, были бы невозможны без их усилий по обратной разработке! # Использование ИИ ## Приложение для Android Эти части приложения были полностью сгенерированы ИИ: - Head Gestures — полностью, включая логику и интерфейс - Настройка смещения с r2+модулем xposed (обе версии) - Troubleshooter и LogCollector Всё остальное — фоновая служба, классы менеджера Bluetooth (AACP и ATT), весь интерфейс, даже мельчайшие компоненты — было написано вручную. Некоторые части компонентов интерфейса были заимствованы из [демонстрационного приложения Kyant0](https://github.com/Kyant0/AndroidLiquidGlass/tree/master/catalog), которое распространяется под лицензией [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Linux (переписывание) Файлы `aacp.rs` и `att.rs` были переведены с Kotlin на Rust с помощью ИИ. Некоторые части файла `media_controller.rs`, в основном интеграция с pulse, также были сгенерированы ИИ. # Сторонники Огромное спасибо всем, кто поддерживает проект! <table> <tr> <td align="center"> <a href="https://github.com/davdroman"> <img src="https://assets.kitploit.com/production/public/readmes/7308/776c36c82a7801798fc6ff1a91611d8272c3f21c41f10a808ae6ab459872104a.jpg" width="48" height="48"alt="davdroman"/><br /> @davdroman </a> </td> <td align="center"> <a href="https://github.com/tedsalmon"> <img src="https://assets.kitploit.com/production/public/readmes/7308/29cbb61b4c1f9a9992f644c2592fb4c3a626d580397fb5ff01133039fa9a7441.jpg" width="48" height="48"alt="tedsalmon"/><br /> @tedsalmon </a> </td> <td align="center"> <a href="https://github.com/wiless"> <img src="https://assets.kitploit.com/production/public/readmes/7308/f10d3773c4c1f7ac24dafc11366fd93ae98e40bf3f2252ed17023f6909c280de.jpg" width="48" height="48"alt="wiless"/><br /> @wiless </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/SmartMsg"> <img src="https://assets.kitploit.com/production/public/readmes/7308/8d8b4afb772a2d505ffbd6d895c279126a6140bd8c3c0431e0fecb1d8cc78d4a.jpg" width="48" height="48"alt="SmartMsg"/><br /> @SmartMsg </a> </td> <td align="center"> <a href="https://github.com/lunaroyster"> <img src="https://assets.kitploit.com/production/public/readmes/7308/8ab33c6770165d3fbd14e19766731ada3f0d9cb29f2c7782d142b848e92c1cbd.jpg" width="48" height="48"alt="lunaroyster"/><br /> @lunaroyster </a> </td> <td align="center"> <a href="https://github.com/ressiwage"> <img src="https://assets.kitploit.com/production/public/readmes/7308/06edb9c51fd205aea82e9415bada62fb35394b66a7b65709ea99dc771a308a69.jpg" width="48" height="48"alt="ressiwage"/><br /> @ressiwage </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/kkjdroid"> <img src="https://assets.kitploit.com/production/public/readmes/7308/3156f982f536e6bd7c59d465c9b31d02ab86684b688024396caaba99b184f1ba.jpg" width="48" height="48"alt="kkjdroid"/><br /> @kkjdroid </a> </td> <td align="center"> <a href="https://github.com/CitrusJoules"> <img src="https://assets.kitploit.com/production/public/readmes/7308/251a526465bd512cb24e299e6d5f901dc509bf01a3ceb4308b13cdfcf936d1ae.png" width="48" height="48"alt="CitrusJoules"/><br /> @CitrusJoules </a> </td> <td align="center"> <a href="https://github.com/DanielReyesDev"> <img src="https://assets.kitploit.com/production/public/readmes/7308/d184d9fac60f0c7c719d061c7f13da5ae765fcb06a516db3b6368f5a143b1aa3.jpg" width="48" height="48"alt="DanielReyesDev"/><br /> @DanielReyesDev </a> </td> </tr> <tr> <td align="center"> <a href="https://github.com/sumitduster"> <img src="https://assets.kitploit.com/production/public/readmes/7308/dc57745f78d8548393402e301691893b01dc0067a134f7ecf20629d14a81c22b.jpg" width="48" height="48"alt="sumitduster"/><br /> @sumitduster </a> </td> <td align="center"> <a href="https://github.com/GrifTheDev"> <img src="https://assets.kitploit.com/production/public/readmes/7308/3d4decbb6b54d36f8354af483fb767741550b61e163054cddff36d196ea77518.png" width="48" height="48"alt="GrifTheDev"/><br /> @GrifTheDev </a> </td> </tr> </table> # Особая благодарность - @tyalie за создание первой документации по протоколу! ([tyalie/AAP-Protocol-Definition](https://github.com/tyalie/AAP-Protocol-Defintion)) - @rithvikvibhu и ребятам из lagrangepoint за помощь с функцией слухового аппарата ([gist](https://gist.github.com/rithvikvibhu/45e24bbe5ade30125f152383daf07016)) - @devnoname120 за помощь с первым root-патчем - @timgromeyer за создание первой версии приложения для Linux - @hackclub за проведение [High Seas](https://highseas.hackclub.com) и [Low Skies](https://low-skies.hackclub.com)! - И, конечно, всем, кто внёс вклад в проект любым способом, включая тестирование, обратную связь или просто проявленный интерес! # Альтернативы для других платформ: - CAPod — приложение-компаньон для AirPods на Android. ([play store](https://play.google.com/store/apps/details?id=eu.darken.capod) | [исходный код](https://github.com/d4rken-org/capod)). Используйте его, если вы используете Android версии 16 QPR3 или ниже и у вас нет root-доступа. - MagicPods для Steam Deck ([сайт](https://magicpods.app/steamdeck/)) - MagicPods — если вы ищете «LibrePods для Windows» ([ms store](https://apps.microsoft.com/store/detail/9P6SKKFKSHKM) [установщик](https://magicpods.app/installer/MagicPods.appinstaller) | [сайт](https://magicpods.app/)) # История звёзд <a href="https://www.star-history.com/?repos=librepods-org%2Flibrepods&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=librepods-org/librepods&type=date&theme=dark&legend=top-left&sealed_token=CS9QF2Wcx-_EN6M7lBhwvTa2WBd5eB8FbQa5FWt3SV14v1OcQdy2aCGsXxHoytVaoylP_pTxj1h2U-odoXDV_EwTqMxM-MQwG_WpvV_1g_yH-Jh3ux2BuWCmS98LxLqfox2ibLOlFDHu_-geTLFsTmqTc1SjX6-NYxVHXF5DaqnxFOAyjLPL5_WtXVew" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=librepods-org/librepods&type=date&legend=top-left&sealed_token=CS9QF2Wcx-_EN6M7lBhwvTa2WBd5eB8FbQa5FWt3SV14v1OcQdy2aCGsXxHoytVaoylP_pTxj1h2U-odoXDV_EwTqMxM-MQwG_WpvV_1g_yH-Jh3ux2BuWCmS98LxLqfox2ibLOlFDHu_-geTLFsTmqTc1SjX6-NYxVHXF5DaqnxFOAyjLPL5_WtXVew" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=librepods-org/librepods&type=date&legend=top-left&sealed_token=CS9QF2Wcx-_EN6M7lBhwvTa2WBd5eB8FbQa5FWt3SV14v1OcQdy2aCGsXxHoytVaoylP_pTxj1h2U-odoXDV_EwTqMxM-MQwG_WpvV_1g_yH-Jh3ux2BuWCmS98LxLqfox2ibLOlFDHu_-geTLFsTmqTc1SjX6-NYxVHXF5DaqnxFOAyjLPL5_WtXVew" /> </picture> </a> # Лицензия LibrePods — AirPods, освобождённые из экосистемы Apple Copyright (C) 2025 LibrePods contributors This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. # Уведомление о товарных знаках GPL не предоставляет никаких прав на использование названия, логотипа или брендинга LibrePods. Название и логотип LibrePods не могут использоваться для программного обеспечения, веб-сайтов, доменов, продуктов, услуг или других проектов таким образом, который предполагает принадлежность к официальному проекту LibrePods, одобрение им или связь с ним, без предварительного разрешения. Если вы заметили какое-либо неправомерное использование названия или логотипа LibrePods, пожалуйста, сообщите об этом на [[email protected]](mailto:[email protected]). Шрифт SF Pro, используемый в приложении для Android, является собственностью Apple Inc. В будущих версиях приложения он будет удалён и вскоре заменён открытой альтернативой. AirPods, AirPods Pro, AirPods Max и логотип AirPods являются товарными знаками Apple Inc. Проект LibrePods никаким образом не связан с Apple Inc. и не одобрен ею.
