Instalação

Existem duas partes. O app do Mac executa o espelhamento; o pacote do iPhone permite que o telefone seja controlado. Instale ambos.

No Mac, com o Homebrew:

No iPhone com jailbreak, adicione este repositório no Sileo ou Zebra e instale o ioscpy a partir dele e faça respring:

O repositório contém versões rootless e rootful, e o gerenciador de pacotes escolhe a que corresponde ao jailbreak.

Linux

Ainda não há uma versão pré-compilada para Linux. Compile o host a partir do código-fonte. O pacote do dispositivo é o mesmo do macOS, instalado a partir do repositório Sileo/Zebra acima.

Clone este repositório e execute o instalador:

--yes pula as solicitações de confirmação. --prefix DIR instala em DIR em vez de /usr/local e dispensa o sudo quando o diretório está sob $HOME. --uninstall remove o binário instalado.

Instalação manual

Pré-requisitos no Debian/Ubuntu:

Garanta que o usbmuxd esteja em execução para que o dispositivo apareça:

Compile o host como seu usuário e depois instale:

Para Arch Linux

O ./install.sh também funciona no Arch Linux.

Ative o serviço

Verifique se o dispositivo está conectado

Em seguida, execute o binário

A etapa de compilação é executada como seu usuário, para que um cargo instalado via rustup seja encontrado. install-host é um alvo separado que apenas copia o binário compilado, então ele roda normalmente com sudo sem precisar de cargo no PATH do root. Para uma instalação sem sudo no seu diretório pessoal, use make install-host PREFIX=$HOME/.local e certifique-se de que $HOME/.local/bin esteja no seu PATH.

A decodificação H.264 funciona no Linux por meio do decodificador de software openh264. Passe --mjpeg se preferir o caminho MJPEG.

Em compositores Wayland que recusam decorações do lado do servidor (GNOME/mutter), o ioscpy volta automaticamente para X11/XWayland para que a janela tenha uma barra de título normal. Passe --wayland para permanecer no Wayland nativo.

Windows

Ainda não há uma versão pré-compilada para Windows. Compile o host a partir do código-fonte. O pacote do dispositivo é o mesmo do macOS e do Linux, instalado a partir do repositório Sileo/Zebra.

O ioscpy no Windows reutiliza as ferramentas USB que uma configuração de iOS já possui e não substitui nenhum driver, portanto Frida, objection, grapefruit, ideviceinfo, iTunes e qualquer outra ferramenta usbmux continuam funcionando enquanto ele está em execução.

1. Pilha USB

• Apple Mobile Device Support: instalado com o iTunes do site da Apple (use a versão do site da Apple, não a da Microsoft Store) ou com o pacote AMDS autônomo. Isso fornece o driver USB e o usbmuxd. O iTunes deve ver o telefone.

• libimobiledevice-win32: fornece iproxy.exe, idevice_id.exe, ideviceinfo.exe. Instale com o Scoop:

  root@kitploit:~

  scoop install libimobiledevice
  

  ou com o MSYS2:

  root@kitploit:~

  pacman -S mingw-w64-x86_64-libimobiledevice
  

  Garanta que os três arquivos .exe estejam no seu PATH (ou coloque-os ao lado do ioscpy.exe). Verifique com idevice_id -l, que deve mostrar o UDID do seu dispositivo.

2. Toolchain de compilação

• Rust com a toolchain MSVC: instale pelo rustup.rs.
• Visual Studio Build Tools com a carga de trabalho de C++ (o decodificador openh264 compila uma pequena biblioteca C por meio do cc).
• nasm no PATH: o montador do openh264 (scoop install nasm).

3. Compilar e executar

Passe --mjpeg se preferir o caminho MJPEG em vez de H.264. Se o openh264 falhar ao compilar, confirme se o nasm está no PATH.

Primeiro toque

Após um respring ou uma nova conexão, dê um toque físico na tela do telefone antes de controlá-lo pelo host. O iOS só confia em eventos de toque que vêm do digitalizador real, então esse primeiro toque real é o que permite que os toques injetados passem. Você faz isso uma vez e o host assume o controle.

Controles

• Mouse: clique para tocar; clique e arraste para deslizar.
• Digitação: as teclas vão para o campo em foco, em qualquer layout de teclado do Mac. Acentos e emojis passam pela área de transferência.
• Esc: voltar.
• Cmd+J, Cmd+L, Cmd+T, Cmd+R: Início, Bloqueio, Alternador de Apps, Girar.
• Cmd+A, Cmd+C, Cmd+V, Cmd+X, Cmd+Z: Selecionar Tudo, Copiar, Colar, Recortar, Desfazer. A área de transferência sincroniza nos dois sentidos, então Cmd+C no telefone chega ao Mac.
• Enter, Backspace, Tab, setas: as teclas de edição correspondentes.

No Linux e no Windows, use Ctrl no lugar de Cmd para esses atalhos (Ctrl+C, Ctrl+V e assim por diante); a área de transferência continua sincronizando nos dois sentidos.

Ao girar o telefone, o espelhamento gira e é redimensionado.

Testado em

Hosts:

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

Dispositivos:

O ioscpy é desenvolvido e testado nos dispositivos acima. Não tenho um dispositivo rootful nem todas as versões de iOS em mãos, então a cobertura por layout está incompleta:

Se você executar o ioscpy em um iPhone, versão do iOS ou jailbreak diferentes, ajude a preencher estas informações. Rootful e outras versões de iOS precisam especialmente de testes.

• Se funcionar, adicione uma linha com seu dispositivo, versão do iOS, layout e framework de injeção e abra um pull request.
• Se falhar, abra uma issue com detalhes suficientes para corrigir:
  • modelo do iPhone e versão do iOS
  • jailbreak e layout (Dopamine, palera1n rootless ou rootful, roothide)
  • framework de injeção (ElleKit, Substitute, Substrate)
  • a saída de ioscpy --debug
  • o que quebrou (tela, toque, teclado, área de transferência, instalação e assim por diante)

Estrutura

Compilação

Requer Rust, Theos ($THEOS), libimobiledevice (idevice_id, iproxy), ldid e dpkg-deb.

Escopo

O ioscpy destina-se a controlar o seu próprio iPhone com jailbreak a partir do seu Mac e de dispositivos Linux (Debian, Ubuntu e Arch Linux), pelo cabo USB, na mesma mesa.

Para hosts Linux, o mesmo requisito externo do macOS: ferramentas libimobiledevice (iproxy, idevice_id, ideviceinfo) e usbmuxd.

Agora ele também roda no Windows, reutilizando as ferramentas USB padrão do iOS sem substituir nenhum driver. Ele ainda é APENAS para iPhones com jailbreak.