fix urls & update readme

2026-06-21 19:35:49 +08:00 · 2025-11-16 04:35:07 +00:00
parent 5a18865b1d
commit bdd92fff5c
2 changed files with 55 additions and 41 deletions
@@ -6,17 +6,17 @@
    Cross platform, open-source and free idevice management tool written in C++
  <br/>
  <br/>
-  <a href="https://github.com/wailsapp/wails/blob/master/LICENSE">
-    <img alt="GitHub" src="https://img.shields.io/github/license/wailsapp/wails"/>
+  <a href="https://github.com/iDescriptor/iDescriptor/blob/master/LICENSE">
+    <img alt="GitHub" src="https://img.shields.io/github/license/iDescriptor/iDescriptor"/>
  </a>
-  <a href="https://github.com/wailsapp/wails/issues">
+  <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/wailsapp/wails/actions/workflows/build-and-test.yml" rel="nofollow">
-    <img src="https://img.shields.io/github/actions/workflow/status/wailsapp/wails/build-and-test.yml?branch=master&logo=Github" alt="Build" />
+  <a href="https://github.com/iDescriptor/iDescriptor/actions/workflows/build-and-test.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/uncor3/libtest/tags" rel="nofollow">
-    <img alt="GitHub tag (latest SemVer pre-release)" src="https://img.shields.io/github/v/tag/uncor3/libtest?include_prereleases&label=version"/>
+  <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 alt="Language" src="https://img.shields.io/badge/C++-20-hotpink.svg"/>
@@ -24,15 +24,14 @@
  <a href="https://github.com/YourUsername/iDescriptor/releases">
    <img src="https://img.shields.io/badge/AppImage-available-brightgreen" alt="AppImage"/>
  </a>
-  <a href="https://aur.archlinux.org/packages/<aur-package-name>">
+  <a href="https://github.com/iDescriptor/iDescriptor/releases">
    <img src="https://img.shields.io/badge/Arch_Aur-available-brightgreen" alt="AppImage"/>
  </a>
  <br/>
  <br/>
-   <a href="https://aur.archlinux.org/packages/<aur-package-name>">
+   <a href="https://aur.archlinux.org/packages/idescriptor-git/">
    <img src="https://img.shields.io/badge/OpenCollective-1F87FF?style=for-the-badge&logo=OpenCollective&logoColor=white" alt="AppImage"/>
  </a>
-  <!--  -->
 </p>

 <p align="center">
@@ -42,36 +41,40 @@
 ## Features

 ### Connection
-| Feature                     | Status               | Notes                                                                                       |
-| --------------------------- | -------------------- | ------------------------------------------------------------------------------------------- |
-| USB Connection              | ✅ Implemented       | Fully supported on Windows, macOS, and Linux.                                               |
-| Wireless Connection (Wi‑Fi) | ⚠️ To be implemented | - |
+
+| Feature                     | Status               | Notes                                         |
+| --------------------------- | -------------------- | --------------------------------------------- |
+| USB Connection              | ✅ Implemented       | Fully supported on Windows, macOS, and Linux. |
+| Wireless Connection (Wi‑Fi) | ⚠️ To be implemented | -                                             |

 ### 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.                                    |
-| [Virtual Location](#virtual-location)                             | ✅ Implemented       | Simulate GPS location. Requires a mounted Developer Disk Image. **( iOS 6 - iOS 16)**       |
-| [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 **(wired)**.                                         |
-| Developer Disk Images                                             | ✅ Implemented       | Manage and mount developer disk images. **( iOS 6 - iOS 16)**                               |
+
+| 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.                              |
+| [Virtual Location](#virtual-location)                  | ✅ Implemented | Simulate GPS location. Requires a mounted Developer Disk Image. **( iOS 6 - iOS 16)** |
+| [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 **(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       |     -                                                                                        |
+
+| 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>
@@ -80,6 +83,7 @@
 </p>

 ## AirPlay
+
 ### Cast your device screen to your computer!

 <p align="center">
@@ -87,6 +91,7 @@
 </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.
@@ -96,7 +101,9 @@ You need to sign in with your Apple ID to use this feature.
 </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>
@@ -113,19 +120,20 @@ Literally mount your iDevice filesystem and use it as a regular drive , read and
    <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>
@@ -137,6 +145,7 @@ Literally mount your iDevice filesystem and use it as a regular drive , read and
 </p>

 ## Network Device Discovery
+
 <p align="center">
    <img src="./resources/repo/network-devices.png"><br/>
 </p>
@@ -159,7 +168,8 @@ Useful if your device does not support AirPlay

 ## **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 disabled 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.
+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 disabled 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>
@@ -173,7 +183,11 @@ If you like this project and want to support its development, consider becoming
 - [libimobiledevice](https://libimobiledevice.org/) - Cross-platform software library that talks the protocols to support iPhone, iPad, iPod Touch devices.
 - [ipatool](https://github.com/majd/ipatool) - A command-line tool for managing iOS apps and devices.

+## Linux Udev Rules

+iDescriptor will check for udev rules but in case it fails to detect your device 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"

@@ -186,3 +200,4 @@ Sun 6 Jul - 14:30  ~ 
 Sun 6 Jul - 14:30  ~ 
@uncore  sudo udevadm control --reload-rules
 sudo udevadm trigger
+```
@@ -61,7 +61,7 @@ void DevDiskManager::populateImageList()
        localFile.close();
        qDebug() << "Loaded DeveloperDiskImages.json from local cache.";
    } else {
-        QFile qrcFile(":/resources/DeveloperDiskImages.json");
+        QFile qrcFile(":/DeveloperDiskImages.json");
        if (qrcFile.open(QIODevice::ReadOnly)) {
            m_imageListJsonData = qrcFile.readAll();
            qrcFile.close();
@@ -72,9 +72,8 @@ void DevDiskManager::populateImageList()
                   "Image list will be empty until network fetch succeeds.";
        }
    }
-    // TODO:change url
-    QUrl url("https://raw.githubusercontent.com/uncor3/resources/refs/heads/"
-             "main/DeveloperDiskImages.json");
+    QUrl url("https://raw.githubusercontent.com/iDescriptor/iDescriptor/refs/"
+             "heads/main/DeveloperDiskImages.json");
    QNetworkRequest request(url);
    auto *reply = m_networkManager->get(request);