README.md

📲 iOS 앱 구버전 다운로드 가이드 (with ipatool)

ipatool은 iOS 앱스토어에서 IPA 파일을 직접 다운로드할 수 있는 오픈소스 툴입니다.
최신 버전뿐 아니라 구버전 앱 다운로드도 가능합니다.
macOS / Windows / Linux 모두 지원합니다.

---

🪟 Windows 사용자용 가이드

1. 명령 프롬프트(CMD) 또는 PowerShell을 실행합니다.
2. 압축 해제한 ipatool.exe 파일을 창에 드래그 앤 드롭합니다.
3. 아래 명령어를 입력해 Apple ID로 로그인합니다:

/path/to/ipatool.exe auth login --email abc@abc.com --password abc123

💡 TIP: 로그인 시 비밀번호는 화면에 표시되지 않으며, 2단계 인증(2FA)을 사용하는 경우 인증 코드 입력이 필요합니다. 아이디 로그인은 필수입니다 — Apple은 앱 다운로드 시 계정별로 암호화 처리를 합니다.

🍎 macOS 사용자용 가이드

Terminal(터미널) 앱을 실행합니다. 아래 명령을 입력해 로그인합니다:

ipatool auth login --email YourAppleID@icloud.com --password abc123

💡 TIP: macOS에서는 ipatool이 Keychain 접근 권한을 요청할 수 있습니다. "항상 허용(Always Allow)"을 선택하면 이후 인증 과정이 간편해집니다.

👉 Step 2: 앱 다운로드

다운로드하려는 앱의 번들 ID (Bundle ID) 와 빌드 번호 (Build Number) 를 준비합니다.

예시: 카카오톡의 번들 ID → com.iwilab.KakaoTalk

빌드번호는 AppStore.bilin.eu.org 등에서 확인할 수 있습니다.

참고사항:

--external-version-id 옵션을 생략하면 최신 버전이 다운로드됩니다.

카카오톡의 대개편 전 마지막 버전은 25.7.5 (빌드번호 877792620) 입니다.

아래 명령으로 구버전 카카오톡 다운로드:

ipatool download -b com.iwilab.KakaoTalk --external-version-id 877792620

💡 TIP: 다운로드된 IPA 파일은 기본적으로 사용자 홈 폴더(~/)에 저장됩니다. 이후 AltStore 또는 Sideloadly 로 설치할 수 있습니다. 무료 Apple ID로 서명 시 7일간 유효하며, 개발자 계정은 1년간 유효합니다.

📦 추가 팁

앱 검색: 원하는 앱의 번들 ID를 모른다면 아래 명령으로 검색할 수 있습니다:

ipatool search KakaoTalk

보안 관련: ipatool은 오픈소스이며, 비밀번호는 로컬에서만 사용됩니다. 단, 공용 PC나 VPN 환경에서는 로그인 시 주의하세요.

항목	값
앱 이름	카카오톡
번들 ID	com.iwilab.KakaoTalk
버전	25.7.5
빌드 번호	877792620
명령어	ipatool download -b com.iwilab.KakaoTalk --external-version-id 877792620

📘 출처 및 참고:

ipatool 공식 GitHub

Appstore.bilin.eu.org