IDescriptor
A free, open-source, and cross-platform iDevice management tool
Install / Use
/learn @iDescriptor/IDescriptorREADME
Download
DO NOT DOWNLOAD FROM ANY WEBSITE CLAIMING TO BE US WE ONLY HAVE https://idescriptor.github.io AND RELEASES WILL BE MADE FROM THIS REPO ONLY
<p align="center"> <a href="https://github.com/iDescriptor/iDescriptor/releases/latest"> <img src="https://img.shields.io/badge/Windows-0078D6?style=for-the-badge&logo=windows&logoColor=white" alt="Download for Windows"/> </a> <a href="https://github.com/iDescriptor/iDescriptor/releases/latest"> <img src="https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Download for macOS"/> </a> <a href="https://github.com/iDescriptor/iDescriptor/releases/latest"> <img src="https://img.shields.io/badge/Linux-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Download for Linux"/> </a> <a href="https://aur.archlinux.org/packages/idescriptor-git"> <img src="https://img.shields.io/badge/Arch_AUR-1793D1?style=for-the-badge&logo=arch-linux&logoColor=white" alt="Install from AUR"/> </a> </p>Installation Instructions
Windows
- Installer (.msi): Download and run the installer. Recommended for most users.
- Portable (.zip): Extract and run
iDescriptor.exe. No installation required. - Choco :
choco install idescriptor --version=0.1.0
macOS
- Apple Silicon: Download the
.dmgfile for M1/M2/M3/MX Macs. <br/> Open the.dmgand drag iDescriptor to Applications. <br/>
After moving the app to Applications, run the code below <br/>
xattr -c ~/Applications/iDescriptor.app
Click here to learn more about why this is needed.
-
Intel: Download the
.dmgfile for Intel-based Macs. <br/> Open the.dmgand drag iDescriptor to Applications. <br/>You shouldn't run into any issues on Intel Macs but if you do, check this out.
Linux
- AppImage: Download, unzip, and run.
- Arch Linux: Install from AUR:
sudo pacman -Syu
yay -S idescriptor-git
make sure to do "sudo pacman -Syu" otherwise it's not going to find libimobiledevice>=1.4.0
<hr/> <br/> <p align="center"> <img src="./resources/repo/crossplatform.png"><br/> </p> </br> </br> </br>Good News!
iDescriptor v0.4.0 will feature WIRELESS CONNECTION support!
Learn more about our roadmap here.
</br> </br> </br>Features
Connection
| Feature | Status | Notes | | ------------------- | -------------------- | --------------------------------------------------------------- | | USB Connection | ✅ Implemented | Fully supported on Windows, macOS, and Linux. | | Wireless Connection | ⚠️ Under Development | Currently under development, planned to be released in v0.4.0 |
Tools
| Feature | Status | Notes | | ------------------------------------------------------ | -------------- | ------------------------------------------------------------------------------------- | | AirPlay | ✅ Implemented | Cast your device screen to your computer. | | Download & Install Apps From Apple Store | ✅ Implemented | Download and install apps directly from the Apple Store. | | Virtual Location | ✅ Implemented | Simulate GPS location. Requires a mounted Developer Disk Image. ( iOS 6 - iOS 16) | | iFuse Filesystem Mount | ✅ Implemented | Mount the device's filesystem. (Windows & Linux only) | | Gallery | ✅ Implemented | - | | File Explorer | ✅ Implemented | Explore the device's filesystem. | | Wireless Gallery Import | ✅ Implemented | Import photos wirelessly (requires the Shortcuts app on the iDevice). | | Cable Info | ✅ Implemented | Check authenticity of connected USB cables and more. | | Network Device Discovery | ✅ Implemented | Discover and monitor devices on your local network. | | SSH Terminal (Jailbroken) | ✅ Implemented | Open up a terminal on your iDevice. | | Query MobileGestalt | ✅ Implemented | Read detailed hardware and software information from the device. | | Live Screen | ✅ Implemented | View your device's screen in real-time (wired). | | Developer Disk Images | ✅ Implemented | Manage and mount developer disk images. ( iOS 6 - iOS 16) |
Device Actions
| Feature | Status | Notes | | ------------------- | -------------- | ----- | | Restart Device | ✅ Implemented | - | | Shutdown Device | ✅ Implemented | - | | Enter Recovery Mode | ✅ Implemented | - |
Fully Theme Aware
<p align="center"> <img src="./resources/repo/macos-theme.gif"><br/> </p> <p align="center"> <img src="./resources/repo/ubuntu-theme.gif"><br/> </p>AirPlay
Cast your device screen to your computer!
<p align="center"> <img src="./resources/repo/airplay.gif"><br/> </p>App Store
Download and Install Apps directly from the Apple Store!
You need to sign in with your Apple ID to use this feature.
<p align="center"> <img src="./resources/repo/ipatool.png"><br/> </p>Virtual Location
Simulate GPS location on your iDevice! (iOS 6 - iOS 16)
<p align="center"> <img src="./resources/repo/virtual-location.png"><br/> </p>iFuse Filesystem Mount
Use your iDevice as a regular DRIVE!
Literally mount your iDevice filesystem and use it as a regular drive , read and write are both allowed. Don't try to import photos or videos because it won't work that way, use the Gallery Import feature for that.
Windows
<p align="center"> <img src="./resources/repo/win-ifuse.gif"><br/> </p>Ubuntu / Linux
<p align="center"> <img src="./resources/repo/ifuse.gif"><br/> </p>Gallery
<p align="center"> <img src="./resources/repo/gallery.png"><br/> </p>File Explorer
<p align="center"> <img src="./resources/repo/file-explorer.png"><br/> </p>Cable Info
<p align="center"> <img src="./resources/repo/cable-info-genuine.png"><br/> </p>Network Device Discovery
<p align="center"> <img src="./resources/repo/network-devices.png"><br/> </p>SSH Terminal
Open up a terminal on your Jailbroken iDevice!
<p align="center"> <img src="./resources/repo/ssh-terminal.gif"><br/> </p>Live Screen
Useful if your device does not support AirPlay
<p align="center"> <img src="./resources/repo/live-screen.png"><br/> </p>Authentication Required ?
You might get this pop-up on any platform this is because this app uses secure backends to retrieve and store your Apple credentials. You can disable this in settings but it is not recommended and not safe for your Apple account. Also if you leave this enabled and sign in you can use the same credentials in ipatool without signing in again.
<p align="center"> <img src="./resources/repo/authentication-required.png"><br/> </p>Become a Sponsor
<div style="flex-direction: row; align-items: center; display: flex; gap: 10px;"> <span>You can become a sponsor from GitHub Sponsors or</span> <a hrRelated Skills
node-connect
338.7kDiagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps
frontend-design
83.6kCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
openai-whisper-api
338.7kTranscribe audio via OpenAI Audio Transcriptions API (Whisper).
commit-push-pr
83.6kCommit, push, and open a PR
