Librepods: Appleエコシステムから解放されたAirPods
Librepods: AirPods liberated from Apple's ecosystem (github.com)
要約
LibrePodsは、AirPodsの独自のプロトコルを実装することで、ノイズコントロールモードの変更、耳検出、正確なバッテリー状態、ヘッドジェスチャーなどのAppleデバイス限定機能を非Appleプラットフォームで利用可能にするプロジェクトです。LinuxおよびAndroidで多くの機能が利用でき、一部の高度な機能にはroot化が必要となる場合があります。このプロジェクトは、AIを活用した開発やコミュニティからの支援を受けています。
全文翻訳
警告
librepods.org は LibrePods プロジェクトの公式ウェブサイトではありません。著作権を主張し、フッターで LibrePods のロゴを使用することで、プロジェクトの公式ウェブサイトであるかのように不正確に主張しています。同時に、プロジェクトは LibrePods プロジェクトまたはその開発者とは提携していないと述べています。
他の同様のウェブサイトがあれば、me@kavish.xyz までご報告ください。
[画像: LibrePods]
LibrePods とは?
LibrePods は、AirPods の機能を Apple デバイス専用から解放します。AirPods と Apple デバイス間でデータを交換するために使用されるプロプライエタリなプロトコルを実装し、非 Apple プラットフォームでノイズコントロールモードの変更、高速な耳の検出、正確なバッテリーステータス、ヘッドジェスチャー、会話認識などの機能を利用できるようにします。
機能の利用可否
| 機能 | Linux | Android |
|---|---|---|
| リスニングモードの変更 | ✅ | ✅ |
| 耳の検出 | ✅ | ✅ |
| バッテリーステータス | ✅ | ✅ |
| AirPods の名前変更 | ✅ | ✅ |
| 大きな音の低減 | 🔴 | ⚪ |
| ヘッドジェスチャー | ⛔ | ✅ |
| 会話認識 | ✅ | ✅ |
| AirPods への自動接続 | ✅ | ✅ |
| 補聴器 | 🔴 | ⚪ |
| 透明モードのカスタマイズ | 🔴 | ⚪ |
| マルチデバイス接続(Bluetooth Multipoint; 2デバイスのみ) | ⚪ | ⚪ |
| その他のアクセシビリティ設定(クリックで展開) | 🔴 | ✅ |
| その他の一般設定 | 🔴 | ✅ |
| ヘッドトラッキング空間オーディオ | ❓ | ❓ |
| 心拍数モニタリング | 🔴 | 🟡 |
| 紛失防止タグ | ❓ | ❓ |
| 高品質な双方向オーディオ | 🟡 | 🟡 |
注記: Android での名前変更後、AirPods を再ペアリングする必要があります。これは、Android が最新の名前を使用しない場合があるためです。
記号の意味:
- ✅: 実装済みで正常に動作
- ⚪: VendorID スプーフィングが必要。自己責任で使用してください。
- 🟡: 実験的/開発中
- 🔴: 未実装、計画中
- ⛔: 実装されない予定
- ❓: 不明
紛失防止タグ
紛失防止タグに関連する以下の機能が計画されていますが、さらなるリバースエンジニアリングが必要であり、Android では root 権限が必要になる場合があります。
- AirPods を紛失防止タグネットワークに追加する
- 充電ケースから音を鳴らして探す
- 置き忘れ通知
- 充電ケースのサウンド通知の切り替え
空間オーディオ
現在、このアプリは Android にヘッドトラッキング情報を提供しておらず、OS が HRTF を実行できません。これはまだ完全に調査されておらず、root 権限が必要になる可能性があります。
ステレオサウンドの空間化は、このプロジェクトの範囲を超えており、決して利用可能になりません。多くの OEM は独自のインプリメンテーションを持っています。
心拍数モニタリング
Android
android/rewrite ブランチで利用可能です。ビルド
Linux
まだ利用できません(コンピューターで役立つものとは思えません。提案があれば、ディスカッションを作成してください)。
高品質な双方向オーディオ
iOS/iPadOS では、AirPods が AACP 経由でマイクからのハイレゾ(AAC-ELD モノラル 64kHz?)オーディオストリームを送信している間、A2DP を引き続き使用できます。
Android
再生品質を低下させるヘッドセット/ハンズフリープロファイルに切り替えることなく、アプリ内で AirPods のマイクを使用してオーディオを録音できます。ただし、これを他のアプリ/電話で利用可能にするには、可能であれば root 権限が必要になる場合があります。
レコーダーは開発中であり、android/rewrite ブランチで利用可能です。ビルド
Linux
PR #655 を参照してください。
インストール
VendorID スプーフィング
DID プロファイルで VendorID を Apple のものに変更すると、いくつかの特別な機能にアクセスできることがわかりました!
Linux では、/etc/bluetooth/main.conf の DeviceID を編集することで実行できます。設定ファイルに DeviceID = bluetooth:004C:0000:0000 という行を追加します。Android では、アプリの設定で Apple デバイスとして動作する 設定を有効にできます(Xposed が利用可能で LibrePods モジュールが有効な場合にのみ表示されます)。
マルチデバイス接続
最大 2 台のデバイスを AirPods に同時に接続でき、オーディオとコントロールの両方が可能です。シームレスな接続切り替え。Android が AirPods を引き継ぐ際に、Apple デバイスの場合と同様に「iPhone に移動」という通知が Apple デバイスに表示されます。Android も、別のデバイスが引き継いだときにポップアップを表示します。
アクセシビリティ設定と補聴器
透明モード(増幅、バランス、トーン、会話ブースト、環境ノイズリダクション)のカスタマイズや、大きな音の低減などのアクセシビリティ設定を構成できます。
すべての補聴器のカスタマイズは Android から(Linux は近日中)行うことができ、聴力検査の結果を設定することもできます。このアプリは、より高い精度が必要なため、聴力検査を行う方法を提供していません。既に利用可能な聴力検査の結果を使用する方がはるかに良いです。
プロトコルとリバースエンジニアリング
使用されているプロトコルに関する詳細については、Nojus(@pabloaul)による Wireshark ディセクタープラグインを参照してください:pabloaul/apple-wireshark
このディセクターは、実装の大部分で LibrePods では使用されていませんでした。このディセクターが作成される前に、私は自分でプロトコルをリバースエンジニアリングしました。しかし、彼らの RE の努力なしには、多くの(将来の)機能、特に高品質な双方向オーディオや空間オーディオは不可能だったでしょう!
AI の使用
Android アプリ
このアプリの以下の部分は完全に AI によって生成されました。
- ヘッドジェスチャー - ロジックと UI を含むすべて
- r2+xposed モジュール(両バージョン)によるオフセット設定
- トラブルシューターと LogCollector
それ以外のすべて、バックグラウンドサービス、Bluetooth マネージャークラス(AACP および ATT)、UI 全体、最小限のコンポーネントでさえ、手動で記述されました。
UI コンポーネントの一部は Kyant0's demo app から借用されており、Apache License 2.0 の下でライセンスされています。
Linux (リライト)
aacp.rs および att.rs ファイルは Kotlin から Rust へ AI によって翻訳されました。media_controller.rs ファイルの一部、主に Pulse の統合も AI によって生成されました。
サポーター
プロジェクトをサポートしてくださった皆様に心より感謝いたします!
特別な感謝
- @tyalie:プロトコルに関する最初のドキュメントを作成してくれたこと! (tyalie/AAP-Protocol-Definition)
- @rithvikvibhu と lagrangepoint の皆様:補聴器機能のサポートについて! (gist)
- @devnoname120:最初の root パッチのサポートについて
- @timgromeyer:Linux アプリの最初のバージョンを作成してくれたこと
- @hackclub:High Seas および Low Skies をホストしてくれたこと!
- もちろん、テスト、フィードバックの共有、関心を示すなど、あらゆる方法でプロジェクトに貢献してくださったすべての方々!
他のプラットフォームの代替手段:
- CAPod - Android 用 AirPods コンパニオンアプリ。(Play ストア | ソースコード)。Android バージョン 16 QPR3 以下を使用しており、root 化していない場合に使用してください。
- MagicPods for Steam Deck (ウェブサイト)
- MagicPods - 「Windows 用 LibrePods」を探している場合。(Microsoft Store インストーラー | ウェブサイト)
Star History
ライセンス
LibrePods - Apple のエコシステムから解放された AirPods Copyright (C) 2025 LibrePods contributors
このプログラムはフリーソフトウェアです。GNU 一般公衆利用許諾契約書(Free Software Foundation が発行したバージョン 3、またはそれ以降のバージョン)の条件に従って、再配布および/または改変することができます。
このプログラムは、有用であることを期待して配布されていますが、いかなる保証もありません。商品性または特定目的への適合性の黙示的な保証も含まれません。詳細については、GNU 一般公衆利用許諾契約書を参照してください。
このプログラムとともに GNU 一般公衆利用許諾契約書のコピーを受け取っているはずです。受け取っていない場合は、https://www.gnu.org/licenses/ を参照してください。
商標に関する通知
GPL は、LibrePods の名前、ロゴ、またはブランディングを使用する権利を付与しません。LibrePods の名前およびロゴは、事前の許可なく、公式 LibrePods プロジェクトとの提携、承認、または関連を示唆する方法で、ソフトウェア、ウェブサイト、ドメイン、製品、サービス、またはその他のプロジェクトに使用することはできません。
LibrePods の名前またはロゴの不正使用を見かけた場合は、me@kavish.xyz までご報告ください。
Android アプリで使用されている SF Pro フォントは Apple Inc. の所有物です。これは将来のバージョンのアプリで削除され、まもなくオープンソースの代替に置き換えられます。
AirPods、AirPods Pro、AirPods Max、および AirPods ロゴは Apple Inc. の商標です。LibrePods プロジェクトは、Apple Inc. といかなる方法でも提携または承認されていません。