Документация — Magic Publisher

Скачивание и установка

Системные требования

ОС: Windows 10/11 (64-bit)
Python: Python 3.11.5 (ОБЯЗАТЕЛЬНО именно эта версия!)
RAM: Минимум 8 GB
Диск: 2 GB свободного места
USB: Порты для подключения iPhone
iTunes: Установлен (для драйверов)
iPhone: iOS 16 и выше

Для установки Magic-Runner нужен Mac! Если у вас есть Mac — вы можете самостоятельно установить Magic-Runner через Xcode (см. раздел Установка Magic-Runner). Если Mac нет — получите сертификат у @mag1k77.

🐍 Установка Python 3.11.5 (ОБЯЗАТЕЛЬНО)

Перед установкой софта необходимо установить Python версии 3.11.5. Другие версии могут работать некорректно!

Важно! Если у вас установлены другие версии Python — сначала удалите их полностью, затем установите Python 3.11.5

Скачать Python 3.11.5:

Скачать Python 3.11.5 для Windows

Установка:

Запустите скачанный python-3.11.5-amd64.exe
ОБЯЗАТЕЛЬНО поставьте галочку Add Python 3.11 to PATH внизу окна установщика
Нажмите "Install Now"
Дождитесь завершения установки
Проверьте установку командой: python --version (должно показать 3.11.5)

Пошаговая установка

1

Получите доступ к софту

После оплаты подписки через @mpisoft_bot, напишите @mag1k77 для получения ссылки на скачивание.

2

Скачайте архив

Загрузите архив MagicPublisher.zip и распакуйте в удобную папку. Рекомендуем C:\MagicPublisher.

3

Установите iTunes

Обязательно установите iTunes с официального сайта Apple для корректной работы драйверов USB.

Важно! Не устанавливайте iTunes из Microsoft Store — только с сайта Apple!

4

⚠️ ОБЯЗАТЕЛЬНО: Снимите блокировку файлов

Перед первым запуском софта нужно снять блокировку безопасности с файлов. Это критически важно!

Откройте PowerShell от имени администратора:
- Нажмите Win + X
- Выберите "Терминал Windows (Администратор)" или "PowerShell (Администратор)"
Перейдите в папку с софтом:
cd C:\MagicPublisher

Замените C:\MagicPublisher на путь к вашей папке
Выполните команду для снятия блокировки:
powershell -command "Get-ChildItem -Recurse | Unblock-File"

Без этой команды софт не будет работать! Windows блокирует файлы, скачанные из интернета. Эта команда снимает блокировку со всех файлов в папке.

5

Запустите софт

Запустите MagicPublisher.exe. При первом запуске потребуется авторизация через QR-код.

Активация лицензии

При первом запуске софта вы увидите QR-код для авторизации:

1

Отсканируйте QR-код

Откройте камеру телефона и отсканируйте QR-код, который появился в софте. Вас перенаправит в Telegram бот.

2

Подтвердите в боте

Нажмите кнопку "Start" в Telegram. Бот автоматически привяжет ваше устройство к аккаунту.

3

Софт активирован

После успешной авторизации софт автоматически обновится и вы сможете начать работу.

Примечание: На месячной подписке лицензия привязывается к одному компьютеру. Lifetime тариф включает безлимит устройств.

Добавление устройства

Поддерживаемые устройства

iPhone 12 / 12 mini / 12 Pro / 12 Pro Max
iPhone 13 / 13 mini / 13 Pro / 13 Pro Max
iPhone 14 / 14 Plus / 14 Pro / 14 Pro Max
iPhone 15 / 15 Plus / 15 Pro / 15 Pro Max
iPhone 16 / 16 Plus / 16 Pro / 16 Pro Max
И все будущие модели

Требования: На iPhone должна быть установлена последняя версия iOS!

Подготовка iPhone перед добавлением

Перед добавлением устройства обязательно выполните:

Выключите пароль на iPhone (Настройки → Face ID и код-пароль → Выключить код-пароль)
Выйдите из iCloud (Настройки → [Ваше имя] → Выйти)

Пошаговая инструкция добавления

1

Запустите Magic Publisher

Откройте софт на компьютере.

2

Подключите iPhone к компьютеру

Используйте оригинальный кабель Lightning/USB-C. Подключите iPhone к USB-порту компьютера.

3

Нажмите "Добавить устройство"

В софте нажмите на кнопку ➕ (плюсик) в разделе iPhone. Софт обнаружит подключенный iPhone.

4

Добавьте устройство

Нажмите кнопку "Добавить устройство", затем "Далее".

5

Дайте доверие на iPhone

На iPhone появится запрос "Доверять этому компьютеру?" — нажмите "Доверять".

6

Дождитесь сброса iPhone

iPhone начнёт полный сброс. Дождитесь, пока iPhone включится.

ВАЖНО! После включения iPhone ничего не делайте на нём! Не нажимайте никаких кнопок на iPhone!

7

Продолжите в софте

После включения iPhone нажмите кнопку "Далее" в софте и дождитесь появления поля для ввода имени устройства.

8

Введите имя устройства

Введите любое удобное имя для устройства (например: "iPhone 15 Pro #1").

Установка Magic-Runner

После добавления устройства обязательно установите Magic-Runner! Без этого приложения софт не сможет управлять iPhone.

Вариант 1: У вас нет MacOS

1

Скопируйте UDID вашего устройства (отображается в софте).

2

Отправьте UDID администратору @mag1k77 — он подпишет ваше приложение.

3

После получения сертификата нажмите кнопку "Редактировать устройство" (иконка карандаша) и кликните "Установить Magic-Runner".

Вариант 2: У вас есть MacOS (рекомендуется)

Если у вас есть MacOS и вы не хотите ждать или покупать сертификаты — вы можете самостоятельно подписывать приложение и устанавливать его через Xcode.

Самостоятельно подписываем Magic-Runner

Если вы устали от слетов и других проблем с сертификатами (особенно это касается тех кто владеет своей фермой) — у нас есть для вас решение.

Что для этого потребуется?

Наличие любой системы на MacOS (самый дешевый вариант — б/у Mac Mini)
Кабель для подключения телефонов
Подписка на наш софт
Устройства (iPhone)

Как это работает и какие преимущества?

Вам не требуется зависеть от поставщиков сертификатов и вы всегда будете лить даже в моменты когда у других слетают сертификаты (такое бывает).

Из минусов: вам нужно будет раз в 7 дней переподписывать ваши телефоны.

Так-же вы можете лить спокойно и на Windows после установки Magic-Runner!

Важное уточнение: MacOS должен быть свеженький, не старый — выше версии 14 (Sonoma).

Пошаговая инструкция

1

Скачайте проект magicload

Скачайте архив с проектом Xcode для установки на iPhone:

Скачать magicload.zip

После скачивания распакуйте архив (двойной клик на Mac)

2

Установите Xcode

Запускаем MacOS и устанавливаем Xcode с App Store или официального сайта Apple.

Размер ~12 GB, установка может занять 30-60 минут.

3

Запустите Xcode

Откройте Xcode. При первом запуске примите лицензионное соглашение и дождитесь установки компонентов.

4

Подключите iPhone к Mac

Подключите ваши айфоны к макбуку кабелем. На iPhone появится запрос "Доверять этому компьютеру?" — нажмите Доверять и введите код-пароль.

5

Откройте проект в Xcode

В открывшемся окне Xcode нажмите Open Existing Project.

Предварительно скачанный magicload разархивируйте (на MacOS просто даблклик по архиву).

В открывшемся окне выберите папку magicload, в ней файл WebDriverAgent.xcodeproj, нажмите Open.

6

Настройте Team (Apple ID)

В открывшемся проекте слева находим раздел "TARGETS". Для каждого target нужно настроить подпись:

Выберите target (например, WebDriverAgentRunner)
Перейдите на вкладку "Signing & Capabilities"
В поле "Team" выберите свой Apple ID (Personal Team)
Убедитесь что "Automatically manage signing" включен

На скриншоте: слева список TARGETS, справа — вкладка Signing & Capabilities с выбранным Team

Важно! Нужно выбрать Team для ВСЕХ targets в списке (WebDriverAgentLib, WebDriverAgentRunner и др.)! Если где-то просит войти в iCloud — входим.

7

Установите iOS Simulator (если требуется)

В верхней панели Xcode найдите выпадающий список устройств. Если видите кнопку Get рядом с версией iOS — нажмите её и установите симулятор iOS (это нужно для сборки).

Нет, на ваш айфон новый iOS установлен не будет — это только для Xcode.

8

Выберите устройство и схему сборки

По завершении всех этих действий в верхнем баре Xcode:

Слева выбираем схему WebDriverAgentRunner (не WebDriverAgentLib!)
Справа выбираем ваш подключенный iPhone (он появится в списке с именем устройства)

Важно! Выбирайте именно тот iPhone, который подключили кабелем. Не выбирайте "Any iOS Device" или симулятор!

9

Запустите сборку

После всех этих действий в самом верху кликаем на "Product" и жмём "Test".

Начнётся билд. Как всё будет готово — перед вами появится всплывающее окно с надписью "Build Succeeded", а на айфоне появится приложение "Magic Runner".

Если билд не удался: возвращаемся к "TARGETS", выбираем "WebDriverAgentRunner" и в Bundle Identifier приписываем единичку в конец, затем снова билдим.

10

Разрешите приложение на iPhone

Приложение на iPhone не трогаем! Открываем настройки:

Переходим в Основные → VPN и управление устройством
Добавляем разработчика с названием как ваш iCloud в доверенные

Готово! 🎉 Magic-Runner установлен. Теперь можете использовать софт для автоматизации на этом iPhone — как с Mac, так и с Windows.

Помните: При бесплатном Apple ID приложение нужно переподписывать каждые 7 дней. Просто повторите шаги 4-10.

Как узнать UDID

UDID (Unique Device Identifier) — уникальный идентификатор вашего iPhone. Есть несколько способов его узнать:

Через Finder (macOS) или iTunes (Windows)

1

Подключите iPhone к компьютеру и откройте Finder (macOS) или iTunes (Windows).

2

Выберите ваше устройство в боковой панели.

3

Кликните несколько раз по строке с серийным номером — она изменится на UDID.

4

Скопируйте UDID (правый клик → Копировать).

Через Magic Publisher

Самый простой способ:

1

Запустите Magic Publisher и подключите iPhone.

2

Устройство появится в списке с отображением UDID.

3

Нажмите на иконку копирования рядом с UDID.

Онлайн сервисы

Вы можете использовать онлайн сервисы для определения UDID:

udid.io — откройте с iPhone в Safari
get.udid.io — альтернативный сервис

Используйте только проверенные сервисы! UDID — чувствительная информация.

Доверие устройству

Если iPhone не появляется в софте или выдает ошибку подключения:

Сброс настроек доверия

На iPhone откройте Настройки → Основные → Перенос или сброс iPhone
Нажмите Сбросить
Выберите Сбросить геонастройки
Введите код-пароль
Переподключите iPhone к компьютеру
Снова нажмите "Доверять" в появившемся окне

Интерфейс программы

Главное окно Magic Publisher разделено на несколько зон:

Панель устройств (слева)

Список подключенных iPhone с информацией:

Имя устройства и модель
UDID
Версия iOS
Статус подключения
Текущий прогресс задачи

Панель управления (справа)

Запустить — начать выполнение задачи на выбранных устройствах
Остановить — прервать текущую задачу
Настройки — параметры публикации
Логи — история действий и ошибки

Настройки

Основные параметры

Папка с аккаунтами	Путь к папке с файлами аккаунтов TikTok
Папка с контентом	Путь к медиафайлам для публикации
Количество публикаций	Сколько карусел/видео загружать на аккаунт (1-6)
Задержка между действиями	Время паузы между операциями (рекомендуем 2-5 сек)

Работа с папками креативов

Правильная организация папок с контентом — ключ к успешной автоматизации. Разберём подробно, как создавать и настраивать папки с креативами.

Важно! Софт автоматически выбирает контент из папки и распределяет его между аккаунтами. Каждый аккаунт получает уникальный набор креативов.

Структура папки с креативами

Папка с креативами должна содержать подпапки с контентом. Каждая подпапка — это один пост (карусель или видео).

                        
📁 Креативы/
├── 📁 Пост_1/
│   ├── 🖼️ photo1.jpg
│   ├── 🖼️ photo2.jpg
│   ├── 🖼️ photo3.jpg
│   └── 📄 caption.txt (опционально)
├── 📁 Пост_2/
│   ├── 🎬 video.mp4
│   └── 📄 caption.txt (опционально)
├── 📁 Пост_3/
│   ├── 🖼️ image1.png
│   ├── 🖼️ image2.png
│   └── 📄 caption.txt (опционально)
└── ... (другие папки)
                        
                    

Правила именования

Названия папок: Могут быть любыми, но рекомендуем использовать понятные имена (например, "Пост_1", "Реклама_товара", "Видео_обзор")
Названия файлов: Могут быть любыми, софт автоматически определит тип контента по расширению
Порядок фото в карусели: Определяется алфавитным порядком имён файлов. Используйте нумерацию: 01.jpg, 02.jpg, 03.jpg

Типы контента

📸 Карусели (несколько фото)

Для создания карусели поместите несколько изображений в одну папку:

Поддерживаемые форматы: .jpg, .jpeg, .png, .webp
Рекомендуемое разрешение: 1080x1350 (портрет) или 1080x1080 (квадрат)
Максимум фото в карусели: 35 изображений
Минимум: 2 изображения для карусели

🎬 Видео

Для публикации видео поместите один видеофайл в папку:

Поддерживаемые форматы: .mp4, .mov
Рекомендуемое разрешение: 1080x1920 (вертикальное)
Максимальная длительность: 10 минут
Рекомендуемый размер: до 500 МБ

Файл caption.txt (описание поста)

В каждой папке с креативом можно создать файл caption.txt с текстом описания:

                        Это описание поста! 🔥

#хештег1 #хештег2 #хештег3

@упоминание_аккаунта

Совет: Если файл caption.txt отсутствует, пост будет опубликован без описания. Вы также можете настроить общее описание для всех постов в настройках софта.

Как софт выбирает контент

1

Сканирование папки

При запуске задачи софт сканирует выбранную папку и находит все подпапки с контентом.

2

Распределение по аккаунтам

Контент распределяется между аккаунтами случайным образом. Каждый аккаунт получает уникальный набор постов (если контента достаточно).

3

Публикация

Софт загружает контент на устройство и публикует его через приложение TikTok.

Примеры правильной организации

✅ Правильно: Карусель из 5 фото

                        
📁 Карусель_товар/
├── 🖼️ 01_главное.jpg
├── 🖼️ 02_детали.jpg
├── 🖼️ 03_размеры.jpg
├── 🖼️ 04_цвета.jpg
├── 🖼️ 05_упаковка.jpg
└── 📄 caption.txt
                        
                    

✅ Правильно: Видео с описанием

                        
📁 Видео_обзор/
├── 🎬 review.mp4
└── 📄 caption.txt

❌ Неправильно: Всё в одной папке

                        
📁 Креативы/
├── 🖼️ photo1.jpg      ← Ошибка! Файлы должны быть в подпапках
├── 🖼️ photo2.jpg
├── 🎬 video.mp4
└── 📄 caption.txt
                        
                    

Часто задаваемые вопросы

❓ Сколько креативов нужно подготовить?

Рекомендуем подготовить минимум: (количество аккаунтов) × (количество публикаций на аккаунт) × 2. Например, для 10 аккаунтов с 3 публикациями каждый — минимум 60 креативов.

❓ Что если креативов меньше, чем аккаунтов?

Софт будет повторно использовать креативы. Это может привести к одинаковому контенту на разных аккаунтах, что нежелательно.

❓ Можно ли использовать одну папку для разных задач?

Да, но софт запоминает уже использованные креативы. Для новых задач рекомендуем создавать новые папки или очищать историю в настройках.

❓ Как добавить звук к карусели?

Звук к карусели добавляется автоматически из библиотеки TikTok. Вы можете настроить это в параметрах задачи.

Публикация контента

1

Подготовьте аккаунты

Поместите файлы аккаунтов в папку. Формат: username:password или JSON.

2

Подготовьте контент

Создайте папку с видео/фото для публикации. Поддерживаемые форматы: MP4, MOV, JPG, PNG.

3

Выберите устройства

Отметьте галочками iPhone, на которых нужно выполнить задачу.

4

Запустите

Нажмите "Запустить" и следите за прогрессом в реальном времени.

Частые ошибки

Причины:

Не установлен iTunes (Windows)
Кабель поврежден или не оригинальный
iPhone заблокирован
Не подтверждено доверие компьютеру

Решение:

Установите iTunes с официального сайта Apple
Попробуйте другой USB-порт (желательно USB 3.0)
Разблокируйте iPhone и подтвердите доверие
Перезагрузите компьютер и iPhone

Причины:

Истекла лицензия
Устройство уже привязано к другому аккаунту
Проблемы с интернет-соединением

Решение:

Проверьте статус лицензии в боте @mpisoft_bot
Продлите подписку если истекла
Свяжитесь с поддержкой для смены привязки

Причины:

TikTok не установлен на iPhone
Устаревшая версия TikTok
Регион iPhone не поддерживает TikTok

Решение:

Установите TikTok из App Store
Обновите TikTok до последней версии
Смените регион App Store если нужно

Причина: Недостаточно средств для оплаты

Решение:

Откройте @mpisoft_bot
Нажмите "Пополнить баланс"
Пополните через CryptoBot

Причины:

Нет интернет-соединения
Блокировка VPN или файрволом
Временные проблемы с сервером

Решение:

Проверьте интернет-соединение
Отключите VPN если включен
Попробуйте через 5-10 минут
Если проблема сохраняется — напишите в поддержку

Документация Magic Publisher

Скачивание и установка

Системные требования

🐍 Установка Python 3.11.5 (ОБЯЗАТЕЛЬНО)

Скачать Python 3.11.5:

Установка:

Пошаговая установка

Получите доступ к софту

Скачайте архив

Установите iTunes

⚠️ ОБЯЗАТЕЛЬНО: Снимите блокировку файлов

Запустите софт

Активация лицензии

Отсканируйте QR-код

Подтвердите в боте

Софт активирован

Добавление устройства

Поддерживаемые устройства

Подготовка iPhone перед добавлением

Пошаговая инструкция добавления

Запустите Magic Publisher

Подключите iPhone к компьютеру

Нажмите "Добавить устройство"

Добавьте устройство

Дайте доверие на iPhone

Дождитесь сброса iPhone

Продолжите в софте

Введите имя устройства

Установка Magic-Runner

Вариант 1: У вас нет MacOS

Вариант 2: У вас есть MacOS (рекомендуется)

Самостоятельно подписываем Magic-Runner

Что для этого потребуется?

Как это работает и какие преимущества?

Пошаговая инструкция

Скачайте проект magicload

Установите Xcode

Запустите Xcode

Подключите iPhone к Mac

Откройте проект в Xcode

Настройте Team (Apple ID)

Установите iOS Simulator (если требуется)

Выберите устройство и схему сборки

Запустите сборку

Разрешите приложение на iPhone

Как узнать UDID

Через Finder (macOS) или iTunes (Windows)

Через Magic Publisher

Онлайн сервисы

Доверие устройству

Сброс настроек доверия

Интерфейс программы

Панель устройств (слева)

Панель управления (справа)

Настройки

Основные параметры

Работа с папками креативов

Структура папки с креативами

Правила именования

Типы контента

📸 Карусели (несколько фото)

🎬 Видео

Файл caption.txt (описание поста)

Как софт выбирает контент

Сканирование папки

Распределение по аккаунтам

Публикация

Примеры правильной организации

✅ Правильно: Карусель из 5 фото

✅ Правильно: Видео с описанием

❌ Неправильно: Всё в одной папке

Часто задаваемые вопросы

❓ Сколько креативов нужно подготовить?

❓ Что если креативов меньше, чем аккаунтов?

❓ Можно ли использовать одну папку для разных задач?

❓ Как добавить звук к карусели?

Публикация контента

Подготовьте аккаунты

Подготовьте контент

Выберите устройства