librepods-org/librepodsAirPods libérés de l'écosystème Apple.
> [!WARNING] > librepods.org n'est pas un site officiel du projet LibrePods. Il prétend de manière inexacte être le site officiel du projet en revendiquant des droits d'auteur et en utilisant le logo LibrePods dans le pied de page. Et en même temps, ils affirment que le projet n'est pas affilié au projet LibrePods ni à ses développeurs. > > Veuillez signaler tout autre site de ce type à [[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> # Qu'est-ce que LibrePods ? LibrePods vous permet d'utiliser les fonctionnalités des AirPods qui sont exclusives aux appareils Apple. Il implémente le protocole propriétaire utilisé pour échanger des données entre les AirPods et les appareils Apple, permettant des fonctionnalités telles que le changement des modes de contrôle du bruit, la détection rapide de l'oreille, un état de batterie précis, les gestes de la tête, la conscience conversationnelle, et plus encore sur des plateformes non-Apple. # Disponibilité des fonctionnalités | Fonctionnalité | Linux | Android | | ----------------------------------------------------------- | ----- | ------- | | Modification du mode d'écoute | ✅ | ✅ | | Détection de port | ✅ | ✅ | | État de la batterie | ✅ | ✅ | | Renommage des AirPods <details><summary>Note pour Android</summary>Sur Android, vous devez réappairer vos AirPods après les avoir renommés, car Android risque de ne pas utiliser le nom le plus récent.</details> | ✅ | ✅ | | Réduction des sons forts | 🔴 | ⚪ | | Gestes de la tête | ⛔ | ✅ | | Conscience conversationnelle | ✅ | ✅ | | Connexion automatique aux AirPods | ✅ | ✅ | | Aide auditive | 🔴 | ⚪ | | Personnalisation du mode Transparence | 🔴 | ⚪ | | Connectivité multi-appareils (Bluetooth Multipoint ; 2 appareils uniquement) | ⚪ | ⚪ | | <details><summary>Autres configurations d'accessibilité (cliquez pour développer)</summary><ul><li>Vitesse d'appui</li><li>Durée d'appui maintenu</li><li>Réduction de bruit avec un seul AirPod</li><li>Contrôle du volume par balayage</li><li>Vitesse de balayage du volume</li></ul></details> | 🔴 | ✅ | | <details><summary>Autres configurations générales</summary><ul><li>Appui maintenu pour alterner entre les modes d'écoute/invoquer l'assistant numérique (l'invocation de l'assistant numérique nécessite un firmware récent)</li><li>Configurer les commandes d'appel</li><li>Volume personnalisé</li><li>Réduction des sons forts (nécessite l'<a href="#vendorid-spoofing">usurpation du VendorID</a>)</li><li>Côté du microphone</li><li>Mettre les médias en pause à l'endormissement (nécessite un firmware récent)</li><li>Activer le <code>mode d'écoute Off</code> pour basculer sur <code>Off</code></li></ul></details> | 🔴 | ✅ | | [Audio spatial avec suivi de la tête](#spatial-audio) | ❓ | ❓ | | [Surveillance de la fréquence cardiaque](#heart-rate-monitoring) | 🔴 | 🟡 | | [Localiser](#find-my) | ❓ | ❓ | | [Audio bidirectionnel de haute qualité](#high-quality-two-way-audio) | 🟡 | 🟡 | | Symbole | Signification | | ------- | ------------------------------------------------------------------- | | ✅ | Implémenté et fonctionne bien | | ⚪ | Nécessite l'[usurpation du VendorID](#vendorid-spoofing) ; à utiliser à vos risques et périls | | 🟡 | Expérimental/En cours de développement | | 🔴 | Pas encore implémenté ; prévu | | ⛔ | Ne sera pas implémenté | | ❓ | Inconnu | ## Localiser Les fonctionnalités suivantes liées à Localiser sont prévues, mais nécessitent davantage de RE et pourraient nécessiter root sur Android : - Ajouter vos AirPods au réseau Localiser - Émettre un son via le boîtier de charge pour le retrouver - Notifier en cas d'oubli - Activer/désactiver les sons de charge du boîtier ## Audio spatial L'application ne fournit actuellement pas d'informations de suivi de la tête à Android pour que le système effectue le HRTF. Cela n'a pas été complètement exploré et pourrait nécessiter root. La spatialisation du son stéréo dépasse le cadre de ce projet et ne sera jamais disponible. De nombreux OEM disposent de leur propre implémentation pour cela. ## Surveillance de la fréquence cardiaque ### Android Disponible dans la branche `android/rewrite`. [builds](https://github.com/librepods-org/librepods/actions/workflows/ci-android.yml?query=branch%3Aandroid%2Frewrite) ### Linux Pas encore disponible (cela ne semble pas être quelque chose d'utile sur un ordinateur de toute façon. Si vous avez des suggestions, créez une discussion.) ## Audio bidirectionnel de haute qualité Sur iOS/iPadOS, vous pouvez continuer à utiliser A2DP pendant que les AirPods envoient le flux audio haute résolution (AAC-ELD mono 64kHz ?) depuis leur microphone via AACP. ### Android Enregistrez l'audio dans l'application à l'aide du microphone des AirPods sans basculer vers le profil Headset/Handsfree qui dégrade la qualité de lecture. Cependant, rendre cela disponible pour d'autres applications/la téléphonie pourrait nécessiter root, si tant est que ce soit possible. L'enregistreur est en cours de développement ; disponible dans la branche `android/rewrite`. [builds](https://github.com/librepods-org/librepods/actions/workflows/ci-android.yml?query=branch%3Aandroid%2Frewrite) ### Linux Consultez la [PR #655](https://github.com/librepods-org/librepods/pull/655). # Installation - [**Android**](https://github.com/librepods-org/librepods/blob/main/android/README.md) - [**Linux**](https://github.com/librepods-org/librepods/blob/main/linux/README.md) # Usurpation du VendorID Il s'avère que si vous remplacez le VendorID dans le profil DID par celui d'Apple, vous accédez à plusieurs fonctionnalités spéciales ! Vous pouvez le faire sous Linux en modifiant le DeviceID dans `/etc/bluetooth/main.conf`. Ajoutez cette ligne au fichier de configuration `DeviceID = bluetooth:004C:0000:0000`. Pour Android, vous pouvez activer le paramètre `act as Apple device` dans les paramètres de l'application (affiché uniquement lorsque Xposed est disponible et que le module LibrePods est activé). ## Connectivité multi-appareils Jusqu'à deux appareils peuvent être connectés simultanément aux AirPods, à la fois pour l'audio et le contrôle. Basculement de connexion transparent. La même notification apparaît sur l'appareil Apple lorsque Android prend le contrôle des AirPods comme s'il s'agissait d'un appareil Apple (« Move to iPhone »). Android affiche également une fenêtre contextuelle lorsque l'autre appareil prend le contrôle. ## Paramètres d'accessibilité et aide auditive Les paramètres d'accessibilité tels que la personnalisation du mode transparence (amplification, équilibre, tonalité, amplification de la conversation et réduction du bruit ambiant), ainsi que la réduction des sons forts peuvent être configurés. Toutes les personnalisations d'aide auditive peuvent être effectuées depuis Android (Linux bientôt), y compris la définition du résultat de l'audiogramme. L'application ne propose pas de moyen de réaliser un test auditif car cela nécessite beaucoup plus de précision. Il est bien préférable d'utiliser un résultat d'audiogramme déjà disponible. # Protocole et rétro-ingénierie Veuillez vous référer au plugin dissecteur Wireshark de Nojus ([@pabloaul](https://github.com/pabloaul)) pour plus d'informations sur les protocoles utilisés : [pabloaul/apple-wireshark](https://github.com/pabloaul/apple-wireshark) Le dissecteur n'a pas été utilisé dans LibrePods pour la majeure partie de l'implémentation ; j'avais moi-même fait de la rétro-ingénierie du protocole avant que ce dissecteur ne soit créé. Mais de nombreuses fonctionnalités (futures), notamment l'audio bidirectionnel de haute qualité et l'audio spatial, n'auraient pas été possibles sans leurs efforts de RE ! # Utilisation de l'IA ## Application Android Ces parties de l'application ont été entièrement générées par IA : - Head Gestures - dans son intégralité, y compris la logique et l'interface utilisateur - La configuration du décalage avec r2+le module xposed (les deux versions) - Troubleshooter et LogCollector Tout le reste - le service en arrière-plan, les classes de gestion Bluetooth (AACP et ATT), l'intégralité de l'interface utilisateur, même les plus petits composants - a été écrit manuellement. Certains composants de l'interface utilisateur ont été empruntés à [l'application de démonstration de Kyant0](https://github.com/Kyant0/AndroidLiquidGlass/tree/master/catalog), qui est sous licence [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). ## Linux (réécriture) Les fichiers `aacp.rs` et `att.rs` ont été traduits de Kotlin vers Rust avec l'IA. Certaines parties du fichier `media_controller.rs`, principalement l'intégration pulse, ont également été générées par IA. # Soutiens Un immense merci à toutes les personnes qui soutiennent le projet ! <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> # Remerciements particuliers - @tyalie pour avoir rédigé la première documentation du protocole ! ([tyalie/AAP-Protocol-Definition](https://github.com/tyalie/AAP-Protocol-Defintion)) - @rithvikvibhu et les personnes de lagrangepoint pour leur aide sur la fonctionnalité d'aide auditive ([gist](https://gist.github.com/rithvikvibhu/45e24bbe5ade30125f152383daf07016)) - @devnoname120 pour son aide sur le premier patch root - @timgromeyer pour avoir créé la première version de l'application Linux - @hackclub pour l'organisation de [High Seas](https://highseas.hackclub.com) et [Low Skies](https://low-skies.hackclub.com) ! - Bien sûr, toutes les personnes qui ont contribué au projet d'une manière ou d'une autre, notamment en testant, en partageant des retours ou simplement en montrant de l'intérêt ! # Alternatives pour d'autres plateformes : - CAPod - Une application compagnon pour les AirPods sur Android. ([play store](https://play.google.com/store/apps/details?id=eu.darken.capod) | [code source](https://github.com/d4rken-org/capod)). Utilisez-la si vous utilisez Android version 16 QPR3 ou inférieure et que vous n'êtes pas rooté. - MagicPods pour Steam Deck ([site web](https://magicpods.app/steamdeck/)) - MagicPods - si vous cherchez « LibrePods pour Windows » ([ms store](https://apps.microsoft.com/store/detail/9P6SKKFKSHKM) [installateur](https://magicpods.app/installer/MagicPods.appinstaller) | [site web](https://magicpods.app/)) # Historique des étoiles <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> # Licence LibrePods - AirPods libérés de l'écosystème d'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/>. # Avis relatif aux marques La GPL n'accorde aucun droit d'utiliser le nom, le logo ou l'image de marque LibrePods. Le nom et le logo LibrePods ne peuvent être utilisés pour des logiciels, sites web, domaines, produits, services ou autres projets d'une manière suggérant une affiliation avec le projet officiel LibrePods, une approbation par celui-ci ou une association avec celui-ci sans autorisation préalable. Si vous constatez un usage abusif du nom ou du logo LibrePods, veuillez le signaler à [[email protected]](mailto:[email protected]). La police SF Pro utilisée dans l'application Android est la propriété d'Apple Inc.. Elle sera retirée dans les futures versions de l'application et remplacée prochainement par une alternative open source. AirPods, AirPods Pro, AirPods Max et le logo AirPods sont des marques d'Apple Inc. Le projet LibrePods n'est en aucune façon affilié à Apple Inc. ni approuvé par celle-ci.
