
iDescriptor v0.6.2
무료, 오픈소스, 크로스 플랫폼 iDevice 관리 도구

Rust 및 Qt로 작성된 크로스 플랫폼, 오픈소스, 무료 idevice 관리 도구
다운로드
우리를 사칭하는 어떤 웹사이트에서도 다운로드하지 마세요. 공식 사이트는 https://idescriptor.github.io 뿐이며, 릴리스는 이 저장소에서만 제공됩니다.
설치 방법
Windows
- 설치 프로그램 (.msi): 설치 프로그램을 다운로드하여 실행하세요. 대부분의 사용자에게 권장됩니다.
- 휴대용 (.zip): 압축을 풀고
iDescriptor.exe를 실행하세요. 설치가 필요 없습니다. - Choco :
choco install idescriptor --version=0.1.0
macOS
- Apple Silicon: M1/M2/M3/MX Mac용
.dmg파일을 다운로드하세요.
.dmg를 열고 iDescriptor를 응용 프로그램 폴더로 드래그하세요.
앱을 응용 프로그램 폴더로 이동한 후 아래 코드를 실행하세요
xattr -c ~/Applications/iDescriptor.app
이 작업이 필요한 이유를 알아보려면 여기를 클릭하세요.
-
Intel: Intel 기반 Mac용
.dmg파일을 다운로드하세요.
.dmg를 열고 iDescriptor를 응용 프로그램 폴더로 드래그하세요.Intel Mac에서는 문제가 발생하지 않을 것입니다. 하지만 문제가 발생한다면 이 문서를 확인하세요.
Linux
- AppImage: 다운로드한 후 다음을 실행하세요
chmod +x iDescriptor*.AppImage
- Arch Linux: AUR에서 설치:
yay -S idescriptor-git
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

기능
연결
| 기능 | 상태 | 비고 |
|---|---|---|
| USB 연결 | ✅ 구현됨 | Windows, macOS, Linux에서 완전히 지원됩니다. |
| 무선 연결 | ✅ 구현됨 | v0.4.0부터 지원 |
도구
| 기능 | 상태 | 비고 |
|---|---|---|
| AirPlay | ✅ 구현됨 | 기기 화면을 컴퓨터로 캐스팅합니다. |
| Apple Store에서 앱 다운로드 및 설치 | ✅ 구현됨 | Apple Store에서 직접 앱을 다운로드하고 설치합니다. |
| 배터리 정보 | ✅ 구현됨 | 기기에서 상세 배터리 정보를 읽어옵니다. |
| 가상 위치 | ✅ 구현됨 | GPS 위치를 시뮬레이션합니다. |
| 기기 백업 | ✅ 구현됨 (실험적) | 기기에서 데이터를 백업합니다 (iOS 13-26) |
| iFuse 파일시스템 마운트 | ✅ 구현됨 | 기기의 파일시스템을 마운트합니다. (Windows 및 Linux만) |
| 갤러리 | ✅ 구현됨 | - |
| 파일 탐색기 | ✅ 구현됨 | 기기의 파일시스템을 탐색합니다. |
| 무선 갤러리 가져오기 | ✅ 구현됨 | 사진을 무선으로 가져옵니다 (iDevice에 단축어 앱 필요). |
| 케이블 정보 | ✅ 구현됨 | 연결된 USB 케이블의 정품 여부 등을 확인합니다. |
| 네트워크 기기 검색 | ✅ 구현됨 | 로컬 네트워크의 기기를 검색하고 모니터링합니다. |
| SSH 터미널 (탈옥 기기) | ✅ 구현됨 | iDevice에서 터미널을 엽니다. |
| MobileGestalt 조회 | ✅ 구현됨 | 기기에서 상세 하드웨어 및 소프트웨어 정보를 읽어옵니다. |
| 라이브 화면 | ✅ 구현됨 | 기기의 화면을 실시간으로 봅니다. |
| 개발자 디스크 이미지 | ✅ 구현됨 | 개발자 디스크 이미지를 관리하고 마운트합니다. ( iOS 6- 16) |
AirPlay
기기 화면을 컴퓨터로 캐스팅하세요!

App Store
Apple Store에서 직접 앱을 다운로드하고 설치하세요!
이 기능을 사용하려면 Apple ID로 로그인해야 합니다.

배터리 정보
기기에서 상세 배터리 정보를 읽어옵니다

위치 시뮬레이션
iDevice에서 GPS 위치를 시뮬레이션하세요!

기기 백업
실험적
기기를 백업합니다 (갤러리, 설정 등) (iOS 13-26)

iFuse 파일시스템 마운트
iDevice를 일반 드라이브처럼 사용하세요!
iDevice 파일시스템을 말 그대로 마운트하여 일반 드라이브처럼 사용하세요. 읽기와 쓰기가 모두 허용됩니다. 그런 방식으로는 사진이나 비디오를 가져올 수 없으므로, 갤러리 가져오기 기능을 사용하세요.
Windows

Ubuntu / Linux

갤러리
사진 앱처럼 앨범/사진을 확인하세요

파일 탐색기

케이블 정보

네트워크 기기 검색

SSH 터미널
탈옥한 iDevice에서 터미널을 여세요!

라이브 화면
기기가 AirPlay를 지원하지 않는 경우 유용합니다

더보기

인증 필요 ?
이 팝업은 어떤 플랫폼에서든 나타날 수 있습니다. 이 앱이 Apple 자격 증명을 검색하고 저장하기 위해 보안 백엔드를 사용하기 때문입니다. 설정에서 이 기능을 비활성화할 수 있지만 권장되지 않으며 Apple 계정에 안전하지 않습니다. 또한 이 기능을 활성화한 상태로 로그인하면 ipatool에서 다시 로그인하지 않고 동일한 자격 증명을 사용할 수 있습니다.

스폰서
Cape (플래티넘)
Cape는 미국 최초의 프라이빗하고 안전한 소비자용 셀룰러 서비스입니다,
첫 달 $30으로 Cape를 부담 없이 체험해 보세요. 결제 시 코드 trycape30을 사용하세요.
스폰서가 되기
감사의 말
- libimobiledevice
- ipatool - 수정된 버전을 여기에서 사용합니다
- QSimpleUpdater - 수정된 버전을 여기에서 사용합니다
- UxPlay (AirPlay용) - 수정된 버전을 여기에서 사용합니다
Linux Udev 규칙
iDescriptor는 udev 규칙을 확인합니다. 하지만 실패할 경우 다음과 유사한 방식으로 udev 규칙을 수동으로 추가할 수 있습니다:
@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
자세한 내용은 UDEV.md를 참조하세요
기여하기
기여를 환영합니다!
먼저 로드맵을 확인하여 기여하려는 내용이 이미 개발 중이거나 저희 CI/CD 또는 전체 프로젝트 방향과 충돌하지 않는지 확인하세요.
저희는 dev 브랜치에서 활발히 개발 중이므로, 풀 리퀘스트는 해당 브랜치를 기준으로 작성해 주세요.
main 브랜치에도 PR을 보낼 수 있지만, 빌드, 번역, 패키지 매니저 배포 또는 문서와 관련된 내용이어야 합니다.
로드맵
계획된 기능
이 코드베이스는 현재 qml 및 qmeta-qml 브랜치에서 대규모 리팩토링과 재작성이 진행 중입니다.
- idevice-rs로 마이그레이션
완료✅ - 무선 연결 지원
완료✅ - 앱에서 IPA 파일 직접 설치
- iOS 17 이상 가상 위치 지원
완료✅ - 성능 및 안정성 향상을 위해 UCRT로 마이그레이션
Windows - 새로운 UI/UX 개선
Windows✅ - Photos.sqlite에서 갤러리 읽기
완료✅ - 번역 -> 번역에 기여하기
- 기기 백업
완료✅ (실험적) - 앱 스토어에서 모든 앱의 모든 버전 다운로드 (개발 중)
- 사이드로딩 구현
- 음악 가져오기
- 기기용 컴패니언 앱
- CLI에서 상호 작용
언제든지 스폰서가 되거나 기부하여 기능을 요청하거나 우선순위를 지정하고 개발 속도를 높일 수 있습니다!
macOS에서 '손상됨' 오류

macOS에서 앱을 열려고 할 때 유사한 '손상됨' 오류가 발생하면 터미널에서 다음 명령을 실행하여 해결할 수 있습니다:
xattr -c ~/Applications/iDescriptor.app
macOS는 Apple Developer ID로 서명되지 않은 앱을 차단하므로 이 명령을 실행해야 합니다. 확장 속성을 지우면 이 보안 기능을 우회할 수 있습니다.
이 문제는 iDescriptor에만 해당하는 것이 아닙니다. 예를 들어 이 내용을 확인하세요.
더 명시적으로 격리 속성만 제거할 수도 있습니다:
xattr -dr com.apple.quarantine /Applications/iDescriptor.app