KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

iDescriptor

★ 4,169 Open GitHub ↗

A free, open-source, and cross-platform iDevice management tool

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Cross-platform, open-source and free idevice management tool written in Rust <img src="https://rustacean.net/assets/rustacean-orig-noshadow.svg" width="25"> and Qt
 
 
 <a href="https://github.com/iDescriptor/iDescriptor/blob/main/LICENSE">
 <img alt="GitHub" src="https://img.shields.io/github/license/iDescriptor/iDescriptor"/>
 </a>
 <a href="https://github.com/iDescriptor/iDescriptor/issues">
 <img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="CodeFactor" />
 </a>
 <a href="https://github.com/iDescriptor/iDescriptor/actions/workflows/build.yml" rel="nofollow">
 <img src="https://img.shields.io/github/actions/workflow/status/iDescriptor/iDescriptor/build-linux.yml?branch=main&logo=Github" alt="Build" />
 </a>
 <a href="https://github.com/iDescriptor/iDescriptor/tags" rel="nofollow">
 <img alt="GitHub tag (latest SemVer pre-release)" src="https://img.shields.io/github/v/tag/iDescriptor/iDescriptor?include_prereleases&label=version"/>
 </a>
 <img alt="Platform" src="https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-blue.svg"/>
 <img src="https://shields.io/badge/-Rust-3776AB?style=flat&logo=rust" >
 <img alt="Language" src="https://img.shields.io/badge/C++-20-hotpink.svg"/>
 <img alt="Qt" src="https://img.shields.io/badge/Qt-6-brightgreen.svg"/>
 <a href="https://github.com/iDescriptor/iDescriptor/releases">
 <img src="https://img.shields.io/badge/AppImage-available-brightgreen" alt="AppImage"/>
 </a>
 <a href="https://aur.archlinux.org/packages/idescriptor-git">
 <img src="https://img.shields.io/badge/Arch_AUR-available-brightgreen" alt="AppImage"/>
 </a>
 
 
 <a href="https://opencollective.com/idescriptor">
 <img src="https://img.shields.io/badge/OpenCollective-1F87FF?style=for-the-badge&logo=OpenCollective&logoColor=white" alt="AppImage"/>
 </a>

<div align="center">Sponsored by
 
 <a href="https://www.cape.co/"><img width="250" src="./resources/repo/cape.svg"></a>
 
 first-of-its kind private and secure consumer cellular service in the US
</div>

## 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

<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" width="130"/>
 </a>&nbsp;&nbsp;
 <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" width="130"/>
 </a>&nbsp;&nbsp;
 <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" width="130"/>
 </a>&nbsp;&nbsp;

### 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** :

```bash
 choco install idescriptor --version=0.1.0
```

#### macOS

- **Apple Silicon**: Download the `.dmg` file for M1/M2/M3/MX Macs.
 
 Open the `.dmg` and drag iDescriptor to Applications.

After moving the app to Applications, run the code below

```shell
xattr -c ~/Applications/iDescriptor.app
```

[Click here to learn more about why this is needed](#damaged-error-on-macos).

- **Intel**: Download the `.dmg` file for Intel-based Macs.
 
 Open the `.dmg` and drag iDescriptor to Applications.

You shouldn't run into any issues on Intel Macs but if you do, [check this out](#damaged-error-on-macos).

#### Linux

- **AppImage**: Download, and then run 
```bash
  chmod +x iDescriptor*.AppImage
```

- **Arch Linux**: Install from AUR:

```bash
  yay -S idescriptor-git
```

<hr/>

# Windows 11 (Acrylic) - v0.6.0

# Windows 11 - v0.6.0

# macOS - v0.6.0

# Linux (Gnome, Custom Window Enabled) - v0.6.0

# Linux (Gnome) - v0.6.0

# Linux (Ubuntu) - v0.6.0

## Features

### Connection

| Feature             | Status         | Notes                                         |
| ------------------- | -------------- | --------------------------------------------- |
| USB Connection      | ✅ Implemented | Fully supported on Windows, macOS, and Linux. |
| Wireless Connection | ✅ Implemented | Starting from v0.4.0                          |

### Tools

| Feature                                                | Status         | Notes                                                                 |
| ------------------------------------------------------ | -------------- | --------------------------------------------------------------------- |
| [AirPlay](#airplay)                                    | ✅ Implemented | Cast your device screen to your computer.                             |
| [Download & Install Apps From Apple Store](#app-store) | ✅ Implemented | Download and install apps directly from the Apple Store.              |
| [Battery Information](#battery-information) | ✅ Implemented | Read detailed battery info from device.              |
| [Virtual Location](#virtual-location)                  | ✅ Implemented | Simulate GPS location.                                                |
| [Device Backups](#device-backups)                  | ✅ Implemented (Experimental) | Backup your data from device (iOS 13-26)                                                |
| [iFuse Filesystem Mount](#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](#cable-info)                              | ✅ Implemented | Check authenticity of connected USB cables and more.                  |
| [Network Device Discovery](#network-device-discovery)  | ✅ Implemented | Discover and monitor devices on your local network.                   |
| [SSH Terminal](#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](#live-screen)                            | ✅ Implemented | View your device's screen in real-time.                               |
| Developer Disk Images                                  | ✅ Implemented | Manage and mount developer disk images. **( iOS 6- 16)**              |

## Fully Theme Aware

## AirPlay

### Cast your device screen to your computer!

## App Store

### Download and Install Apps directly from the Apple Store!

You need to sign in with your Apple ID to use this feature.

## Battery Information

Read detailed battery info from device

## Virtual Location

### Simulate GPS location on your iDevice!

## Device Backups

**EXPERIMENTAL**

Backup your device (gallery, settings etc..) (iOS 13-26)

## 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

#### Ubuntu / Linux

### Gallery

See your Albums/Photos just like the Photos app

### File Explorer

## Cable Info

## Network Device Discovery

## SSH Terminal

### Open up a terminal on your Jailbroken iDevice!

## Live Screen

Useful if your device does not support AirPlay

## More

## **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.

## Sponsors

## Cape (Platinum)

<a href="https://www.cape.co/"><img width="405" src="./resources/repo/cape.svg"></a>
 
 Cape is the first-of-its kind private and secure consumer cellular service in the US,

<a href="https://www.cape.co/get-cape/enroll">Try Cape risk-free for just $30 for your first month.</a> Use code `trycape30` at checkout to apply.

## Become a Sponsor

<div style="flex-direction: row; align-items: center; display: flex; gap: 10px;">
You can become a sponsor from GitHub Sponsors or <a href="https://opencollective.com/idescriptor">
<img src="https://img.shields.io/badge/OpenCollective-1F87FF?style=for-the-badge&logo=OpenCollective&logoColor=white" alt="AppImage"/>
</a>
</div>

## Thanks

- [libimobiledevice](https://libimobiledevice.org/)
- [ipatool](https://github.com/majd/ipatool) - We use a modified version [here](https://github.com/uncor3/libipatool-go)
- [QSimpleUpdater](https://github.com/alex-spataru/QSimpleUpdater) - We use a modified version [here](https://github.com/uncor3/ZUpdater)
- [UxPlay (for AirPlay)](https://github.com/FDH2/UxPlay) - We use a modified version [here](https://github.com/iDescriptor/uxplay)

## Linux Udev Rules

iDescriptor will check for udev rules but in case it fails, you can manually add the udev rules by doing similar to the following:

```bash
@uncore  sudo cat /etc/udev/rules.d/99-idevice.rules
SUBSYSTEM=="usb", ATTR{idVendor}=="05ac", MODE="0666"

✘  Sun 6 Jul - 14:29  ~ 
@uncore  sudo groupadd idevice

Sun 6 Jul - 14:30  ~ 
@uncore  sudo usermod -aG idevice $USER

Sun 6 Jul - 14:30  ~ 
@uncore  sudo udevadm control --reload-rules
sudo udevadm trigger
```

For more info [UDEV.md](./UDEV.md)

# Contributing

Contributions are welcome!

Please check the [Roadmap](#roadmap) first to make sure what you’re contributing to is not already under development and does not conflict with our CI/CD or overall project direction.

We actively develop on dev branch, so please base your pull requests off of that branch.

You can also send a pr to main branch but it should be something related to building, translations, publish to some package manager or documentation.

## Roadmap

**Planned Features**

This codebase is currently undergoing a major refactor and rewrite in `qml` and `qmeta-qml` branches

- Migrate to idevice-rs `DONE` ✅
- Wireless Connection Support `DONE` ✅
- Install IPA files directly from the app
- Virtual Location Support for iOS 17 and above `DONE` ✅
- Migrate to UCRT for better performance and stability `Windows`
- New UI/UX improvements `Windows` ✅
- Read gallery from Photos.sqlite (under development)
- Translations (currently scaffolding the base, contributions will be welcome once it’s ready) 
- Device Backup
- Download any version of any app from app store (under development)
- Implement sideloading
- Import music
- Companion app on device
- Interact from the CLI

**You can always become a sponsor/donate to request/prioritize a feature or speed up the development process!**

## Damaged Error on macOS

If you encounter a similar "damaged" error when trying to open the app on macOS, you can resolve this by running the following command in the terminal:

```shell
xattr -c ~/Applications/iDescriptor.app
```

You need to run this because macOS blocks apps that are not signed by an Apple Developer ID. By clearing the extended attributes, you can bypass this security feature.

This not something specific to iDescriptor, for example [check this out](https://github.com/deskflow/deskflow/issues/7606).

You can be more explicit and only remove the quarantine attribute like so:

```shell
xattr -dr com.apple.quarantine /Applications/iDescriptor.app
```

## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=iDescriptor/iDescriptor&type=date&legend=top-left)](https://www.star-history.com/#iDescriptor/iDescriptor&type=date&legend=top-left)

iDescriptor

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README