Skip to content

ShawnRn/ipaDown-for-Mac

Repository files navigation

ipaDown (Mac & iOS)

This is a vibe-coded project. Developed with ❤️ using Antigravity.

A lightweight Apple App Store download tool developed in Swift, supporting native macOS execution and iOS IPA export.

简体中文 | English


Platform Language License


📸 Interface Preview


📖 Introduction

ipaDown is a cross-platform download tool designed to fetch .ipa files directly from the App Store and generate iOS packages compatible with TrollStore/Sideloading on macOS.

💡 Inspiration This project is inspired by the ipaDown Windows version released on the 52pojie forum. Our mission is to migrate and enhance its core functionalities natively for the macOS ecosystem, providing a seamless experience for Apple users.

Powered by standard system APIs and aria2, it offers a clean, native UI while ensuring high-performance downloads.

✨ Features

  • Native Experience: Built with SwiftUI for a smooth, responsive macOS interface.
  • Account Management: Support for multiple Apple IDs and quick switching between Storefront regions.
  • Advanced Search: Search for apps and retrieve historical version IDs effortlessly.
  • High-Speed Download: Integrated aria2 backend for multi-threaded, resume-supported downloads.
  • Auto-Refresh: Automatic token refreshing to keep your sessions active.
  • Cross-Platform Support: Export .ipa files specifically for iOS/iPadOS, fully compatible with TrollStore, Sideloadly, and other sideloading methods.
  • Automated Build: Integrated cross-platform build script to generate both macOS .dmg and iOS .ipa in one click.
  • Automatic Updates: Integrated Sparkle framework (macOS only) to keep you on the latest version.

📦 Installation

Download Binary

Download the latest .dmg installer from the Releases page.

Build from Source

  1. Clone the repository

    git clone https://github.com/ShawnRn/ipaDown-for-Mac.git
    cd ipaDown-for-Mac
  2. Open the project Open ipaDown-for-Apple.xcodeproj in Xcode.

  3. One-Click Automated Build (Recommended) Run the built-in script to generate both macOS and iOS binaries in the build_output directory:

    chmod +x ./scripts/build_all.sh
    ./scripts/build_all.sh
  4. Manual Build

    • Open ipaDown-for-Apple.xcodeproj in Xcode.
    • Select the ipaDown scheme and hit Cmd + R to run.
    • To export an iOS package, switch the target device to Any iOS Device in Xcode and perform an Archive.

🛠 Tech Stack

  • UI: SwiftUI (macOS 13.0+)
  • Core: Swift 5.9+
  • Network: aria2c (embedded)
  • Update: Sparkle
  • Reference: Uses strictly typed, safe Swift concurrency models.

📝 License

This project is licensed under the MIT License.


Made with ❤️ by Shawn Rain

About

一款使用 Swift 开发的、轻量级 macOS App Store 应用下载工具。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors