ioscpy

कार्य सूची

• https://github.com/lautarovculic/ioscpy/issues/7
• साइडपैनल में स्क्रीन रिकॉर्डिंग (स्थिति दिखाने वाला) बटन।
• शोध: Windows के लिए GUI सहित समर्थन प्रदान करना, इंस्टॉलर (आरक्षित, लेखक इसे पूरी तरह लागू करेगा)
• प्रमाणीकरण (Authentication) और प्राधिकरण (Authorization) जोड़ें, साथ ही डिवाइस में एक सूचना कि ioscpy चल रहा है (आरक्षित, लेखक इसे पूरी तरह लागू करेगा)
• ioscpy को वायरलेस (BLE, Wi-Fi) बनाएं (आरक्षित, लेखक इसे पूरी तरह लागू करेगा)
• कस्टम बटन क्रियाएँ (मैक्रोज़) (चरणों में, अवधारणा जल्द आ रही है)

एक macOS, Linux और Windows CLI जो USB के ज़रिए जेलब्रोकन iPhone को मिरर और नियंत्रित करती है।

एक डिवाइस कनेक्ट होने पर, बस इतना ही काफी है। यह अपने आप कनेक्ट हो जाता है।

इंस्टॉल

यहाँ दो पक्ष हैं। Mac ऐप मिरर चलाता है, iPhone पैकेज फ़ोन को नियंत्रित करने देता है। दोनों इंस्टॉल करें।

Mac पर, Homebrew के साथ:

brew tap lautarovculic/ioscpy   # the Mac app
brew trust lautarovculic/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

Linux

Linux के लिए अभी कोई प्रीबिल्ट नहीं है। होस्ट को सोर्स से बनाएँ। डिवाइस पैकेज वही है जो macOS पर है, जिसे ऊपर दिए Sileo/Zebra रिपो से इंस्टॉल किया जाता है।

इस रिपो को क्लोन करें, फिर इंस्टॉलर चलाएँ:

./install.sh

--yes पुष्टिकरण संकेतों को छोड़ देता है। --prefix DIR /usr/local के बजाय DIR में इंस्टॉल करता है और जब निर्देशिका $HOME के अंतर्गत हो तो sudo को छोड़ देता है। --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

बिल्ड चरण आपके यूज़र के रूप में ही रहता है ताकि rustup से इंस्टॉल किया गया cargo मिल जाए। install-host एक अलग टारगेट है जो केवल बनी हुई बाइनरी की नकल करता है, इसलिए यह root के PATH पर cargo की आवश्यकता के बिना sudo के अंतर्गत ठीक चलता है। बिना 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 पास करें।

Windows

Windows के लिए अभी कोई प्रीबिल्ट नहीं है। होस्ट को सोर्स से बनाएँ। डिवाइस पैकेज वही है जो macOS और Linux पर है, जिसे Sileo/Zebra रिपो से इंस्टॉल किया जाता है।

Windows पर ioscpy उन USB टूलिंग का पुनः उपयोग करता है जो iOS सेटअप में पहले से मौजूद होती है, और किसी भी ड्राइवर को नहीं बदलता, इसलिए Frida, objection, grapefruit, ideviceinfo, iTunes और कोई भी अन्य usbmux टूल इसके चलने के दौरान काम करते रहते हैं।

1. USB स्टैक

• Apple Mobile Device Support: apple.com से iTunes के साथ इंस्टॉल होता है (Apple वेबसाइट वाला बिल्ड लें, Microsoft Store वाला नहीं), या स्टैंडअलोन 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 Build Tools C++ वर्कलोड के साथ (openh264 डिकोडर cc के माध्यम से एक छोटी C लाइब्रेरी संकलित करता है)।
• 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

यदि आप H.264 के बजाय MJPEG मार्ग पसंद करते हैं तो --mjpeg पास करें। यदि openh264 बिल्ड में विफल रहता है, तो पुष्टि करें कि nasm PATH पर है।

पहला स्पर्श

रिस्प्रिंग या नए कनेक्शन के बाद, होस्ट से चलाने से पहले फ़ोन की स्क्रीन पर एक भौतिक टैप दें। iOS केवल उन्हीं टच इवेंट पर भरोसा करता है जो असली डिजिटाइज़र से आते हैं, इसलिए वह पहला असली टैप ही इंजेक्ट किए गए टैप को पारित करने देता है। आप इसे एक बार करते हैं, फिर होस्ट संभाल लेता है।

नियंत्रण

• माउस: टैप करने के लिए क्लिक करें, स्वाइप करने के लिए क्लिक करके खींचें।
• टाइपिंग: कीस्ट्रोक्स किसी भी Mac कीबोर्ड लेआउट में फ़ोकस्ड फ़ील्ड पर जाते हैं। उच्चारण (accents) और इमोजी क्लिपबोर्ड के माध्यम से जाते हैं।
• Esc: पीछे जाएँ।
• Cmd+J, Cmd+L, Cmd+T, Cmd+R: होम, लॉक, ऐप स्विचर, घुमाएँ।
• Cmd+A, Cmd+C, Cmd+V, Cmd+X, Cmd+Z: सभी चुनें, कॉपी, पेस्ट, कट, पूर्ववत करें। क्लिपबोर्ड दोनों दिशाओं में सिंक होता है, इसलिए फ़ोन पर Cmd+C Mac तक पहुँचता है।
• Enter, Backspace, Tab, तीर कुंजियाँ: संबंधित संपादन कुंजियाँ।

Linux और Windows पर, इन शॉर्टकट्स के लिए Cmd के स्थान पर Ctrl उपयोग करें (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 खोलें।
• यदि यह विफल होता है, तो इसे ठीक करने के लिए पर्याप्त विवरण के साथ issue खोलें:
  • 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 पर भी चलता है, बिना किसी ड्राइवर को बदले मानक iOS USB टूल्स का पुनः उपयोग करता है। यह अब भी केवल जेलब्रोकन iPhone के लिए है।