Skip to content

Repository files navigation

GitHub release License Downloads Downloads
CloudTips

IPA_Downloader

English README
Скрипт для покупки/загрузки любых доступных в App Store приложений, а также восстановления удалённых - при условии, что они были приобретены ранее с вашим аккаунтом Apple (работает на базе ipatool-cpp).

Информация о скрипте:

Важно:

ipatool является неофициальным инструментом; следовательно, использование скрипта – только на свой страх и риск.

Возможности скрипта:

IPA_Downloader (загрузка и установка приложений):

  • Поиск приложений по названию или ID и покупка (без загрузки)
  • Поиск приложений по названию или ID и загрузка последней версии
  • Поиск приложений по названию или ID и загрузка (с выбором версии)
  • Выбор списка приложений и покупка (без загрузки)
  • Выбор списка приложений и загрузка последней версии
  • Выбор списка приложений и загрузка (с выбором версии)
  • Проверка минимальной версии iOS для приложений в папке Apps
  • Установка приложений из папки Apps

IPA_Installer (установка приложений):

  • Проверка минимальной версии iOS для приложений в папке Apps
  • Установка приложений из папки Apps.

Скрипт НЕ умеет:

  • Загружать ранее НЕ приобретённые в App Store приложения;
  • Делать копию приложений прямо с устройства.

Примечание:

  • Для загрузки приложений они должны быть приобретены в App Store ранее;
  • Загрузка приложений осуществляется из App Store;
  • Рекомендуется отключить использование аппаратных ключей безопасности и перейти на метод двухфакторной аутентификации;
  • Скрипт поддерживает массовую покупку/загрузку приложений, достаточно ввести порядковые номера (№) приложений/версий из таблиц через запятую или дефис, например, введя 1, 2, 3-5 произойдет покупка/загрузка приложений с порядковыми номерами (№) 1, 2, 3, 4 и 5;
  • Доступно создание пользовательского списка приложений, достаточно добавить данные в формате Название приложения: его ID, например: Google: 284815942 в файл Files/AppsListCustom.txt.

Общие требования для использования:

  • Windows 7 - 11 (x64);
  • macOS начиная с 10.15 Catalina (поддерживается работа на процессорах Apple Silicon и Intel);
  • Linux (x64 и ARM64: Arch Linux, Ubuntu, Debian, Fedora и другие);
  • Стабильное интернет-соединение;
  • Аккаунт Apple с ранее загруженными приложениями.

Использование на Windows:

Требования для Windows:

  • Для установки загруженных приложений через скрипт требуется драйвер AppleMobileDeviceSupport64 (входит в состав iTunes): Ссылка для загрузки iTunes с сайта Apple
  • Вместо полной установки iTunes можно выполнить выборочную установку AppleMobileDeviceSupport64.msi, распаковав установщик iTunes любым архиватором (7-Zip, WinRAR).
  • Скрипт работает без данного драйвера, однако он требуется для установки загруженных приложений на устройство.

Требования для Windows 7 и 8.1:

Все действия выполняются строго в нижеуказанной последовательности:

Загружаем полный набор программ/обновлений для Windows 7/8.1 по ссылке:
Ссылка для загрузки полного набора программ/обновлений

1. Обновляем системные сертификаты через UpdRootsCert:

  • Запускаем файл UpdRootsCert.exe;
  • Отмечаем флажки: Корневые сертификаты системы, Добавить ежемесячную задачу в Планировщик заданий;
  • Нажимаем кнопку Установить.

2. Устанавливаем .NET Framework 4.8:

  • Запускаем файл NDP48-x86-x64-AllOS-ENU.exe;
  • Устанавливаем .NET Framework 4.8 следуя инструкциям мастера установки.

3. Устанавливаем обновление KB3191566 (для добавления поддержки PowerShell 5.1):

  • Запускаем файлы: Win7AndW2K8R2-KB3191566-x64.msu (для Windows 7) или Win8.1AndW2K12R2-KB3191564-x64.msu (для Windows 8.1);
  • Устанавливаем обновление KB3191566 следуя инструкциям мастера установки.

4. Устанавливаем обновление KB2999226:

  • Запускаем файлы: Windows7-KB2999226-x64 (для Windows 7) или Windows8.1-KB2999226-x64 (для Windows 8.1);
  • Устанавливаем обновление KB2999226 следуя инструкциям мастера установки.

Как использовать (Windows):

1. Распаковываем архив IPA_Downloader.zip любым архиватором (7-Zip, WinRAR);

2. Дважды кликаем по файлу Start_IPA_Downloader.bat;

3. При первом запуске потребуется первоначальная настройка:

  • Выбираем язык;
  • Нажимаем Enter;
  • При наличии обновления выбираем, перейти в репозиторий для загрузки новой версии скрипта или продолжить работу с текущей версией;
  • Нажимаем Enter.

4. По умолчанию скрипт запускается в режиме IPA_Downloader (загрузка и установка приложений):

  • Для авторизации вводим команду: 1. Войти в аккаунт Apple;
  • Нажимаем Enter;
  • Вводим аккаунт Apple (Enter email:);
  • Нажимаем Enter;
  • Вводим пароль (Enter password:);
  • Нажимаем Enter;
  • На устройстве нажимаем Разрешить и запоминаем код двухфакторной аутентификации (2FA);
  • Если код двухфакторной аутентификации (2FA) автоматически не пришел, то на устройстве включаем режим полета, переходим в Настройки - Аккаунт Apple - Вход и безопасность - Получить код проверки (это и есть код двухфакторной аутентификации (2FA));
  • Вводим код двухфакторной аутентификации (Enter 2FA code:);
  • Нажимаем Enter;
  • Вводим необходимую команду;
  • Нажимаем Enter.

Использование на macOS:

Требования для macOS:

Все действия выполняются строго в нижеуказанной последовательности:

1. Устанавливаем менеджер пакетов Homebrew:

  • Запускаем Терминал (Command + Пробел, затем ввести Терминал в поле поиска Spotlight);
  • Вводим в Терминал: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • Нажимаем Enter;
  • В процессе установки Homebrew, может потребоваться ввод пароля;
  • После установки Homebrew внизу Терминала появится текст ==> Next steps.

2. При установке на Mac с процессорами Intel:

  • Вводим в Терминал:
echo >> ~/.zprofile
echo 'eval "$(/usr/local/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv zsh)"
  • Нажимаем Enter.

2.1. При установке на Mac с процессорами Apple Silicon:

  • Вводим в Терминал:
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv zsh)"
  • Нажимаем Enter.

3. Устанавливаем пакеты ideviceinstaller, minizip и powershell:

  • Вводим в Терминал: brew install ideviceinstaller minizip powershell
  • Нажимаем Enter.

3.1 Альтернативная установка PowerShell:

  • Повторяем шаги 1-2 из предыдущего пункта;
  • Переходим по ссылке для загрузки PowerShell:
    Ссылка для загрузки PowerShell
  • Находим версию PowerShell;
  • Нажимаем Show all assets;
  • Загружаем файл: powershell-@-osx-x64.pkg (для Mac с процессорами Intel) или powershell-@-osx-arm64.pkg (для Mac с процессорами Apple Silicon);
  • Производим установку powershell-@-osx-x64.pkg (для Mac с процессорами Intel) или powershell-@-osx-arm64.pkg (для Mac с процессорами Apple Silicon);
  • Вводим в Терминал: brew install ideviceinstaller minizip
  • Нажимаем Enter.

Примечание:

  • На macOS Catalina/Big Sur необходимо установить PowerShell 7.3.12:
    Ссылка для загрузки PowerShell 7.3.12
  • Для обновления Homebrew и всех компонентов вводим в Терминал: brew update && brew upgrade && brew cleanup и нажимаем Enter.

Как использовать (macOS):

1. Распаковываем архив IPA_Downloader.zip любым архиватором (7-Zip, WinRAR);

2. Дважды кликаем по файлу Start_IPA_Downloader.command;

  • В первый раз macOS заблокирует запуск Start_IPA_Downloader.command;
  • В появившемся окне "Файл "Start_IPA_Downloader.command" нажимаем "Готово";
  • Нажимаем на логотип Apple () в левом верхнем углу экрана и выбираем "Системные настройки...";
  • В левой боковой панели прокручиваем вниз и выбираем вкладку "Конфиденциальность и безопасность";
  • Прокручиваем правую часть экрана вниз до раздела "Безопасность";
  • В пункте "Файл Start_IPA_Downloader заблокирован для защиты Вашего Mac" нажимаем на кнопку "Все равно открыть";
  • В появившемся окне "Открыть файл "Start_IPA_Downloader" нажимаем "Все равно открыть";
  • Вводим пароль от вашего Mac или прикладываем палец к Touch ID;
  • При необходимости еще раз дважды кликаем по файлу Start_IPA_Downloader.command.

3. При первом запуске потребуется первоначальная настройка:

  • Выбираем язык;
  • Нажимаем Enter;
  • При наличии обновления выбираем, перейти в репозиторий для загрузки новой версии скрипта или продолжить работу с текущей версией;
  • Нажимаем Enter.

4. По умолчанию скрипт запускается в режиме IPA_Downloader (загрузка и установка приложений):

  • Для авторизации вводим команду: 1. Войти в аккаунт Apple;
  • Нажимаем Enter;
  • Вводим аккаунт Apple (Enter email:);
  • Нажимаем Enter;
  • Вводим пароль (Enter password:);
  • Нажимаем Enter;
  • На устройстве нажимаем Разрешить и запоминаем код двухфакторной аутентификации (2FA);
  • Если код двухфакторной аутентификации (2FA) автоматически не пришел, то на устройстве включаем режим полета, переходим в Настройки - Аккаунт Apple - Вход и безопасность - Получить код проверки (это и есть код двухфакторной аутентификации (2FA));
  • Вводим код двухфакторной аутентификации (Enter 2FA code:);
  • Нажимаем Enter;
  • Вводим необходимую команду;
  • Нажимаем Enter.

Примечание:

  • Для установки приложения можно воспользоваться AirDrop: достаточно просто передать файл на iPhone и приложение автоматически установится.

Использование на Linux:

Требования для Linux:

Устанавливаем необходимые пакеты:

Arch Linux / Manjaro:

  • Устанавливаем PowerShell: sudo pacman -S powershell-bin (или через AUR: yay -S powershell-bin)
  • Устанавливаем утилиты для работы с iOS: sudo pacman -S ideviceinstaller usbmuxd
  • Включаем службу usbmuxd: sudo systemctl enable --now usbmuxd

Ubuntu / Debian:

  • Устанавливаем PowerShell: Инструкция Microsoft или sudo apt install powershell
  • Устанавливаем утилиты для работы с iOS: sudo apt install ideviceinstaller usbmuxd
  • Включаем службу usbmuxd: sudo systemctl enable --now usbmuxd

Fedora / RHEL:

  • Устанавливаем PowerShell: sudo dnf install powershell
  • Устанавливаем утилиты для работы с iOS: sudo dnf install ideviceinstaller usbmuxd
  • Включаем службу usbmuxd: sudo systemctl enable --now usbmuxd

Как использовать (Linux):

1. Распаковываем архив IPA_Downloader любым архиватором (7-Zip, WinRAR);

2. Разрешаем выполнение скрипта запуска (при необходимости):

  • Вводим в Терминал: chmod +x Start_IPA_Downloader.sh
  • Нажимаем Enter.

3. Запускаем скрипт:

  • Вводим в Терминал: ./Start_IPA_Downloader.sh (или дважды кликаем по файлу Start_IPA_Downloader.sh в файловом менеджере);
  • Нажимаем Enter.

4. При первом запуске потребуется первоначальная настройка:

  • Выбираем язык;
  • Нажимаем Enter;
  • При наличии обновления выбираем, перейти в репозиторий для загрузки новой версии скрипта или продолжить работу с текущей версией;
  • Нажимаем Enter.

5. По умолчанию скрипт запускается в режиме IPA_Downloader (загрузка и установка приложений):

  • Для авторизации вводим команду: 1. Войти в аккаунт Apple;
  • Нажимаем Enter;
  • Вводим аккаунт Apple (Enter email:);
  • Нажимаем Enter;
  • Вводим пароль (Enter password:);
  • Нажимаем Enter;
  • На устройстве нажимаем Разрешить и запоминаем код двухфакторной аутентификации (2FA);
  • Если код двухфакторной аутентификации (2FA) автоматически не пришел, то на устройстве включаем режим полета, переходим в Настройки - Аккаунт Apple - Вход и безопасность - Получить код проверки (это и есть код двухфакторной аутентификации (2FA));
  • Вводим код двухфакторной аутентификации (Enter 2FA code:);
  • Нажимаем Enter;
  • Вводим необходимую команду;
  • Нажимаем Enter.

Описание команд скрипта:

IPA_Downloader (загрузка и установка приложений):

1. Поиск приложений по названию или ID и покупка (без загрузки):

  • Вводим название приложения или ID приложений для поиска;

  • Нажимаем Enter;

  • В случае ввода названия приложения отобразится список найденных приложений;

  • Вводим порядковые номера (№) приложений для покупки;

  • Нажимаем Enter;

  • Скрипт осуществит покупку выбранных приложений.

  • В случае ввода ID приложений скрипт осуществит покупку указанных приложений.

2. Поиск приложений по названию или ID и загрузка последней версии:

  • Вводим название приложения или ID приложений для поиска;

  • Нажимаем Enter;

  • В случае ввода названия приложения отобразится список найденных приложений;

  • Вводим порядковые номера (№) приложений для покупки;

  • Нажимаем Enter;

  • Скрипт осуществит загрузку выбранных приложений.

  • В случае ввода ID приложений скрипт осуществит загрузку указанных приложений.

3. Поиск приложений по названию или ID и загрузка (с выбором версии):

  • Вводим название приложения или ID приложений для поиска;

  • Нажимаем Enter;

  • Отобразится список найденных приложений;

  • Вводим порядковые номера (№) приложений для отображения ID версий;

  • Нажимаем Enter;

  • Отобразится список ID версий приложения (от первой к последней);

  • Вводим порядковые номера (№) ID версий приложения для отображения версий;

  • Нажимаем Enter;

  • Отобразится список версий приложения;

  • Вводим порядковые номера (№) версий приложения для загрузки;

  • Скрипт осуществит загрузку выбранных версий приложений.

  • В случае ввода ID приложений:

  • Отобразится список ID версий приложения (от первой к последней);

  • Вводим порядковые номера (№) ID версий приложения для отображения версий;

  • Нажимаем Enter;

  • Отобразится список версий приложения;

  • Вводим порядковые номера (№) версий приложения для загрузки;

  • Скрипт осуществит загрузку выбранных версий приложений.

4. Выбор списка приложений и покупка (без загрузки):

  • Выбираем список приложений для отображения:
  1. Основной список приложений (Files/AppsList.txt);
  2. Пользовательский список приложений (Files/AppsListCustom.txt);
  3. Список приложений, приобретенных скриптом (Files/PurchasedAppsList.json);
  4. Список приложений, не приобретенных скриптом).
  • Нажимаем Enter;
  • Отобразится выбранный список;
  • Вводим порядковые номера (№) приложений для покупки;
  • Нажимаем Enter;
  • Скрипт осуществит покупку выбранных приложений.

5. Выбор списка приложений и загрузка последней версии:

  • Выбираем список приложений для отображения:
  1. Основной список приложений (Files/AppsList.txt);
  2. Пользовательский список приложений (Files/AppsListCustom.txt);
  3. Список приложений, загруженных скриптом (Files/DownloadedAppsList.json);
  4. Список приложений, не загруженных скриптом).
  • Нажимаем Enter;
  • Отобразится выбранный список;
  • Вводим порядковые номера (№) приложений для загрузки;
  • Нажимаем Enter;
  • Скрипт осуществит загрузку выбранных приложений.

6. Выбор списка приложений и загрузка (с выбором версии):

  • Выбираем список приложений для отображения:
  1. Основной список приложений (Files/AppsList.txt);
  2. Пользовательский список приложений (Files/AppsListCustom.txt);
  3. Список приложений, загруженных скриптом (Files/DownloadedAppsList.json);
  4. Список приложений, не загруженных скриптом).
  • Нажимаем Enter;
  • Отобразится выбранный список;
  • Вводим порядковые номера (№) приложения для загрузки;
  • Нажимаем Enter;
  • Отобразится список ID версий приложения (от первой к последней);
  • Вводим порядковые номера (№) ID версий приложения для отображения версий;
  • Нажимаем Enter;
  • Отобразится список версий приложения;
  • Вводим порядковые номера (№) версий приложения для загрузки;
  • Скрипт осуществит загрузку выбранных версий приложений.

7. Проверка минимальной версии iOS для приложений в папке Apps:

  • Приложения должны находиться в папке Apps;
  • Скрипт осуществит проверку минимальной версии iOS для установки приложения.

8. Установка приложений из папки Apps:

  • Подключаем устройство с помощью кабеля;
  • Приложения должны находиться в папке Apps;
  • Вводим порядковые номера (№) приложений для установки на устройство;
  • Нажимаем Enter;
  • Скрипт осуществит установку выбранных приложений на устройство.

9. Очистка данных:

  • Вводим список данных для очистки:
  1. Список приложений, приобретенных скриптом (Files/PurchasedAppsList.json);
  2. Список приложений, загруженных скриптом (Files/DownloadedAppsList.json);
  3. Приложения в папке Apps.
  • Нажимаем Enter;
  • При выборе очистки списка приложений, приобретенных скриптом, или списка приложений, загруженных скриптом, выбираем аккаунт для очистки;
  • Нажимаем Enter;
  • Скрипт осуществит очистку выбранного типа данных.

10. Операции с аккаунтом Apple:

  • Вводим необходимое действие:
  1. Добавить аккаунт;
  2. Сменить аккаунт;
  3. Выйти из аккаунта Apple;
  • Нажимаем Enter.

11. Банка для чаевых:

  • Скрипт осуществит переход на страницу CloudTips.

12. Сменить язык (Change Language):

  • Скрипт осуществит смену языка скрипта.

debug

  • Включение/отключение режима отладки.

IPA_Installer (установка приложений):

1. Проверка минимальной версии iOS для приложений в папке Apps:

  • Приложения должны находиться в папке Apps;
  • Скрипт осуществит проверку минимальной версии iOS для установки приложения.

2. Установка приложений из папки Apps:

  • Подключаем устройство с помощью кабеля;
  • Приложения должны находиться в папке Apps;
  • Вводим порядковые номера (№) приложений для установки на устройство;
  • Нажимаем Enter;
  • Скрипт осуществит установку выбранных приложений на устройство.

3. Банка для чаевых:

  • Скрипт осуществит переход на страницу CloudTips.

4. Сменить язык (Change Language):

  • Скрипт осуществит смену языка скрипта.

5. Перейти в IPA_Downloader:

  • Скрипт осуществит смену режима на IPA_Downloader (загрузка и установка приложений).

debug

  • Включение/отключение режима отладки.

Возможные ошибки и их решение:

Расшифровка ошибок:

  • Обработка -File ./IPA_Downloader.ps1 завершилась сбоем: Access to the path is denied (macOS) - Включите Терминалу доступ по пути: Системные настройки - Конфиденциальность и безопасность - Доступ к диску.
  • Download error: HTTP request failed: Timeout was reached - Не удалось подключиться к серверам Apple, проверьте Ваше интернет-соединение.
  • Error: license is required - Приложение не было приобретено на этом аккаунте Apple ранее.
  • Purchase error: app not found - Покупка приложения не удалась, так как приложение удалено из App Store.
  • Purchase error: item is temporarily unavailable - Приложение не было приобретено на этом аккаунте Apple ранее, покупка не удалась, так как приложение удалено из App Store.
  • Login error: GSA SRP exception: GSA complete error -27952: Update iCloud for Windows to the latest version to sign in - Необходимо отключить расширенную защиту данных по пути: Настройки - Аккаунт Apple - iCloud - Расширенная защита данных.
  • Login error: failed to initialize SAP signer: WinHttpSendRequest failed: 12029 - Ошибка подключения, проверьте использование системой прокси-сервера, введя в командную строку Windows (cmd): netsh winhttp show proxy и нажмите Enter. При необходимости удалите неиспользуемый прокси-сервер, введя в командную строку Windows (запущенную от имени администратора): netsh winhttp reset proxy и нажмите Enter.
  • No device found - Устройство не найдено. Убедитесь, что драйвер AppleMobileDeviceSupport64 установлен (актуально для Windows).
  • WARNING: could not locate Payload/App.app/SC_Info/App.sinf in archive! - В устанавливаемом ipa файле не найдена подпись приложения.
  • ERROR: Install failed. Got error "APIInternalError" with code 0x00000000: Error Domain=IXErrorDomain Code=46 - Необходимо удалить приложение с устройства, перезагрузить устройство и попробовать установить еще раз.
  • В случае проблем с авторизацией попробуйте войти со своим аккаунтом Apple на сайт icloud.com
  • Если после установки приложение сразу сворачивается при запуске, войдите в App Store под аккаунтом, с которого оно было загружено, и установите любое бесплатное/платное приложение. После этого запустите проблемное приложение снова.

При возникновении проблем:

Предоставьте, пожалуйста, следующую информацию:

  • Используемая операционная система и версия IPA_Downloader;
  • Введите команду debug в главном меню скрипта, воспроизведите действие, приводящее к ошибке, и отправьте результат;
  • Скриншот ошибки.

Полезная информация:

Поиск ID приложения:

Вариант 1:

Найдите ссылку на приложение в App Store и скопируйте число после id в адресе ссылки.

Скриншот (нажмите для просмотра) AppStore_Link

Вариант 2:

Если приложение установлено на устройстве, то задержите палец на иконке приложения:

  • Появится пункт Поделиться приложением;
  • Скопируйте ссылку и вставьте в браузер;
  • Скопируйте число после id в адресе ссылки.

Вариант 3:

Посмотреть полный список купленных приложений можно через сайт reportaproblem.apple.com

  • Далее введите название приложения в окне поиска на сайте appmagic.rocks и перейдите на страницу приложения;
  • На странице приложения выберите Select App с иконкой App Store и скопируйте число в конце адреса ссылки.

Отслеживание выхода новых приложений:

Тема на 4PDA
Сайт AppBank

Банка для чаевых:

IPA_Downloader полностью бесплатен, однако, если вы хотите безвозмездно поддержать проект, то можно это сделать по ссылке ниже или через QR-код:
Поддержать через CloudTips

qrCode

About

A script for purchasing/downloading any available App Store apps, as well as restoring removed ones - provided they were previously purchased via your Apple Account (powered by ipatool-cpp).

Topics

Resources

Stars

155 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages