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؛ جهازان فقط) | ⚪ | ⚪ | | <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 مخطط لها، لكنها تتطلب المزيد من الهندسة العكسية وقد تحتاج إلى صلاحيات الجذر (root) على Android: - إضافة AirPods الخاصة بك إلى شبكة Find My - تشغيل الصوت عبر علبة الشحن للعثور عليها - الإشعار عند تركها خلفك - تبديل أصوات شحن العلبة ## الصوت المكاني لا يوفر التطبيق حاليًا معلومات تتبع الرأس لنظام Android لكي يقوم نظام التشغيل بتنفيذ HRTF. لم يتم استكشاف هذا بالكامل، وقد يحتاج إلى صلاحيات الجذر (root). إضفاء الطابع المكاني على الصوت الاستريو خارج نطاق هذا المشروع ولن يكون متاحًا أبدًا. لدى العديد من الشركات المصنعة للمعدات الأصلية (OEMs) تطبيق خاص بها لهذا الغرض. ## مراقبة معدل ضربات القلب ### 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 أحادي 64kHz؟) من ميكروفونها عبر AACP. ### Android سجّل الصوت داخل التطبيق باستخدام ميكروفون AirPods دون التبديل إلى ملف تعريف Headset/Handsfree الذي يقلل من جودة التشغيل. لكن إتاحة ذلك لتطبيقات أخرى/الاتصالات الهاتفية قد يتطلب صلاحيات root، إن كان ذلك ممكنًا أصلًا. المسجّل قيد التطوير؛ متاح في فرع `android/rewrite`. [builds](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 إلى معرف 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 هذه الأجزاء من التطبيق وُلّدت بالكامل بواسطة الذكاء الاصطناعي: - إيماءات الرأس - كلها، بما في ذلك المنطق وواجهة المستخدم - إعداد الإزاحة مع r2+وحدة xposed (كلا الإصدارين) - أداة استكشاف الأخطاء وإصلاحها و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 patch) - @timgromeyer لإعداد أول إصدار من تطبيق لينكس - @hackclub لاستضافة [High Seas](https://highseas.hackclub.com) و[Low Skies](https://low-skies.hackclub.com)! - وبالطبع، كل من ساهم في المشروع بأي شكل، بما في ذلك عبر الاختبار أو مشاركة الملاحظات أو مجرد إبداء الاهتمام! # بدائل لمنصات أخرى: - CAPod - تطبيق مرافق لسماعات AirPods على أندرويد. ([متجر Play](https://play.google.com/store/apps/details?id=eu.darken.capod) | [الشيفرة المصدرية](https://github.com/d4rken-org/capod)). استخدم هذا إذا كنت تستخدم إصدار أندرويد 16 QPR3 أو أقل ولم تقم بعمل root. - MagicPods لـ Steam Deck ([الموقع الإلكتروني](https://magicpods.app/steamdeck/)) - MagicPods - إذا كنت تبحث عن "LibrePods for Windows" ([متجر Microsoft](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 حقوق النشر (C) 2025 مساهمو LibrePods هذا البرنامج برمجية حرة: يمكنك إعادة توزيعه و/أو تعديله بموجب شروط رخصة GNU العامة كما نشرتها مؤسسة البرمجيات الحرة، سواء الإصدار 3 من الرخصة أو أي إصدار لاحق. يُوزَّع هذا البرنامج على أمل أن يكون مفيدًا، لكن دون أي ضمان؛ حتى دون الضمان الضمني لقابلية التسويق أو الملاءمة لغرض معين. راجع رخصة GNU العامة لمزيد من التفاصيل. ينبغي أن تكون قد تلقيت نسخة من رخصة GNU العامة مع هذا البرنامج. إذا لم يكن الأمر كذلك، راجع <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. ولا يحظى بتأييدها بأي شكل من الأشكال.
