ioscpy

المهام

• https://github.com/lautarovculic/ioscpy/issues/7
• زر تسجيل الشاشة (عرض الحالة) في اللوحة الجانبية.
• بحث: توفير دعم لويندوز مع واجهة رسومية كذلك، مثبت (محجوز، سيقوم المؤلف بتنفيذه بالكامل)
• إضافة المصادقة والتفويض، بالإضافة إلى إشعار في الجهاز بأن ioscpy قيد التشغيل (محجوز، سيقوم المؤلف بتنفيذه بالكامل)
• جعل ioscpy لاسلكيًا (BLE، Wi-Fi) (محجوز، سيقوم المؤلف بتنفيذه بالكامل)
• إجراءات الأزرار المخصصة (ماكرو) (على مراحل، المفهوم قادم قريبًا)

واجهة سطر أوامر لنظم macOS و Linux و Windows تعكس وتتحكم في iPhone مكسور الحماية عبر USB.

مع توصيل جهاز واحد، كل ما تحتاجه. يتصل تلقائيًا.

تثبيت

هناك جانبان. تطبيق Mac يدير المرآة، وحزمة iPhone تسمح بالتحكم في الهاتف. قم بتثبيت كليهما.

على Mac، باستخدام Homebrew:

brew tap laut arovculic/ioscpy   # the Mac app
brew trust laut arovculic/ioscpy
brew install ioscpy
ioscpy --version

على iPhone المكسور الحماية، أضف هذا المستودع في Sileo أو Zebra، ثم قم بتثبيت ioscpy منه وأعد التشغيل (respring):

https://lautarovculic.github.io/ioscpy-repo/

يحمل المستودع كلاً من بنيات rootless و rootful، ومدير الحزم يختار البنية التي تتوافق مع كسر الحماية.

ioscpy --device <UDID>   # pick a device when several are attached
ioscpy --list            # list attached devices
ioscpy --no-keyboard     # hide the on-screen keyboard, type from the Mac
ioscpy --mjpeg           # force MJPEG video instead of the default H.264
ioscpy --debug           # full diagnostics
ioscpy --version

لينكس

لا يوجد بناء مسبق للينكس بعد. قم ببناء المضيف من المصدر. حزمة الجهاز هي نفسها كما في macOS، مثبتة من مستودع Sileo/Zebra أعلاه.

Clone هذا المستودع، ثم قم بتشغيل المثبت:

./install.sh

--yes يتجاوز مطالبات التأكيد. --prefix DIR يقوم بالتثبيت في DIR بدلاً من /usr/local ويتجاوز sudo عندما يكون الدليل تحت $HOME. --uninstall يزيل الثنائي المثبت.

تثبيت يدوي

المتطلبات الأساسية على Debian/Ubuntu:

sudo apt install build-essential pkg-config nasm \
                 libimobiledevice-utils usbmuxd \
                 libxkbcommon-dev libwayland-dev \
                 libxcb1-dev libxkbcommon-x11-dev
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

تأكد من أن usbmuxd قيد التشغيل حتى يظهر الجهاز:

sudo systemctl enable --now usbmuxd
idevice_id -l   # should print the UDID with the phone attached

قم ببناء المضيف كمستخدمك، ثم ثبته:

make host-release
sudo make install-host    # installs to /usr/local/bin/ioscpy
ioscpy --version

لأنظمة Arch Linux

./install.sh يعمل أيضًا على Arch Linux.

sudo pacman -S --needed \
  base-devel pkgconf nasm \
  libimobiledevice usbmuxd \
  libxkbcommon wayland libxcb libxkbcommon-x11 \
  rustup curl git

rustup default stable

تفعيل الخدمة

sudo systemctl enable --now usbmuxd.service

تحقق مما إذا كان الجهاز متصلاً

idevice_id -l

ثم قم بتشغيل الثنائي

cd host/target/release && chmod +x ioscpy

./ioscpy

تبقى خطوة البناء كمستخدمك بحيث يتم العثور على cargo المثبت عبر rustup. install-host هو هدف منفصل يقوم فقط بنسخ الثنائي المبني، لذا فهو يعمل بشكل جيد تحت sudo دون الحاجة إلى cargo في مسار PATH الخاص بـ root. للتثبيت بدون sudo في المنزل، استخدم make install-host PREFIX=$HOME/.local وتأكد من أن $HOME/.local/bin موجود في PATH الخاص بك.

يعمل فك تشفير H.264 على Linux من خلال مفكك الشفرة البرمجي openh264. مرر --mjpeg إذا كنت تفضل مسار MJPEG.

في مديري النوافذ Wayland الذين يرفضون الزخارف من جانب الخادم (GNOME/mutter)، يتحول ioscpy تلقائيًا إلى X11/XWayland حتى يحصل الإطار على شريط عنوان عادي. مرر --wayland للبقاء على Wayland الأصلي بدلاً من ذلك.

ويندوز

لا يوجد بناء مسبق لويندوز بعد. قم ببناء المضيف من المصدر. حزمة الجهاز هي نفسها كما في macOS و Linux، مثبتة من مستودع Sileo/Zebra.

يعيد ioscpy على ويندوز استخدام أدوات USB التي يمتلكها إعداد iOS بالفعل، ولا يستبدل أي برنامج تشغيل، لذا تستمر Frida و objection و grapefruit و ideviceinfo و iTunes وأي أداة usbmux أخرى في العمل أثناء تشغيله.

1. كومة USB

• دعم أجهزة Apple المحمولة (Apple Mobile Device Support): مثبت مع iTunes من apple.com (احصل على البناء من موقع Apple، وليس من متجر Microsoft)، أو حزمة AMDS المستقلة. يوفر برنامج تشغيل USB و usbmuxd. يجب أن يرى iTunes الهاتف.

• libimobiledevice-win32: يوفر iproxy.exe, idevice_id.exe, ideviceinfo.exe. قم بتثبيته باستخدام Scoop:

  root@kitploit:~

  scoop install libimobiledevice
  

  أو باستخدام MSYS2:

  root@kitploit:~

  pacman -S mingw-w64-x86_64-libimobiledevice
  

  تأكد من وجود ملفات .exe الثلاثة في PATH الخاص بك (أو ضعها بجانب ioscpy.exe). تحقق باستخدام idevice_id -l، والذي يجب أن يطبع UDID لجهازك.

2. سلسلة أدوات البناء

• Rust مع سلسلة أدوات MSVC: ثبته من rustup.rs.
• أدوات بناء Visual Studio مع عبء عمل C++ (يقوم مفكك openh264 بتجميع مكتبة C صغيرة عبر cc).
• nasm على PATH: مجمع openh264 (scoop install nasm).

3. بناء وتشغيل

git clone https://github.com/lautarovculic/ioscpy
cd ioscpy
cargo build --release --manifest-path host/Cargo.toml
.\host\target\release\ioscpy.exe --list      # confirms the device is seen
.\host\target\release\ioscpy.exe             # opens the mirror window

مرر --mjpeg إذا كنت تفضل مسار MJPEG على H.264. إذا فشل بناء openh264، تأكد من وجود nasm في PATH.

اللمسة الأولى

بعد إعادة التشغيل (respring) أو اتصال جديد، قم بإعطاء الهاتف نقرة واحدة فعلية على شاشته قبل التحكم به من المضيف. iOS يثق فقط في أحداث اللمس القادمة من الرقمنة الحقيقية، لذا فإن تلك النقرة الحقيقية الأولى هي ما يسمح بمرور النقرات المحقونة. تفعلها مرة واحدة، ثم يتولى المضيف المسؤولية.

عناصر التحكم

• الماوس: انقر للنقر، اسحب للتمرير.
• الكتابة: تذهب ضغطات المفاتيح إلى الحقل المركّز، في أي تخطيط لوحة مفاتيح Mac. تنتقل العلامات والإيموجي عبر الحافظة.
• Esc: العودة إلى الخلف.
• Cmd+J, Cmd+L, Cmd+T, Cmd+R: الشاشة الرئيسية (Home)، القفل (Lock)، مبدل التطبيقات (App Switcher)، التدوير (Rotate).
• Cmd+A, Cmd+C, Cmd+V, Cmd+X, Cmd+Z: تحديد الكل (Select All)، نسخ (Copy)، لصق (Paste)، قص (Cut)، تراجع (Undo). تتم مزامنة الحافظة في كلا الاتجاهين، لذا يصل Cmd+C على الهاتف إلى Mac.
• Enter, Backspace, Tab, الأسهم: مفاتيح التحرير المطابقة.

على Linux و Windows، استخدم Ctrl بدلاً من Cmd لهذه الاختصارات (Ctrl+C, Ctrl+V، وهكذا)؛ لا تزال الحافظة تتم مزامنتها في كلا الاتجاهين.

تدوير الهاتف يؤدي إلى تدوير وتغيير حجم المرآة.

تم اختباره على

المضيفون:

• Debian, KDE/Wayland
• Ubuntu 26.04, GNOME/Wayland
• Arch Linux, BSPWM
• Windows 11 x64

الأجهزة:

تم تطوير ioscpy واختباره على الأجهزة أعلاه. لا أملك جهاز rootful أو كل إصدارات iOS في متناول اليد، لذا فإن التغطية حسب التخطيط غير مكتملة:

إذا قمت بتشغيل ioscpy على iPhone مختلف أو إصدار iOS أو كسر حماية مختلف، فيرجى المساعدة في ملء هذا الجدول. إصدارات Rootful وإصدارات iOS الأخرى تحتاج بشكل خاص إلى اختبار.

• إذا كان يعمل، أضف صفًا يحتوي على جهازك وإصدار iOS والتخطيط وإطار الحقن، وافتح طلب سحب (pull request).
• إذا فشل، افتح مشكلة مع تفاصيل كافية لإصلاحها:
  • طراز iPhone وإصدار iOS
  • كسر الحماية والتخطيط (Dopamine، palera1n rootless أو rootful، roothide)
  • إطار الحقن (ElleKit، Substitute، Substrate)
  • مخرجات ioscpy --debug
  • ما تعطل (الشاشة، اللمس، لوحة المفاتيح، الحافظة، التثبيت، وما إلى ذلك)

التخطيط

host/       Rust host CLI (macOS, Linux, and Windows)
device/     iOS package (Theos): daemon, ctl, tweak, jbcompat, packaging
protocol/   wire format docs, kept in lockstep with the code
scripts/    device deploy, respring, log, and diagnostics helpers
docs/       architecture, jailbreak compatibility, troubleshooting, release

البناء

make host-release        # macOS host binary
make device-rootless     # rootless .deb (Dopamine, palera1n-rootless, /var/jb)
make device-rootful      # rootful .deb (palera1n-rootful, /)
make release             # host plus both device variants

يتطلب Rust, Theos ($THEOS), libimobiledevice (idevice_id, iproxy), ldid, و dpkg-deb.

النطاق

ioscpy مخصص للتحكم في جهاز iPhone المكسور الحماية الخاص بك من جهاز Mac و Linux (Debian و Ubuntu و Arch Linux) الخاص بك، عبر كابل USB، على نفس المكتب.

بالنسبة للمضيفين على Linux، نفس المتطلبات الخارجية كما في macOS: أدوات libimobiledevice (iproxy, idevice_id, ideviceinfo) و usbmuxd.

يعمل الآن على Windows أيضًا، مع إعادة استخدام أدوات USB القياسية لنظام iOS دون استبدال أي برنامج تشغيل. لا يزال فقط لأجهزة iPhone المكسورة الحماية.