ghostgram/README.ru.md

Ghostgram

English · Русский

Ghostgram — неофициальный клиент Telegram для iOS. Он собран на официальном исходном коде Telegram iOS (13.0) и добавляет функции приватности, истории сообщений и оформления. Все они в одном меню: Настройки → Ghostgram.

Ghostgram не связан с Telegram.

• Канал: @ghostgrama
• Чат: @ghostgramchat
• Форум: @ghostgramforum

Функции

Приватность

• Режим призрака. Читать сообщения и смотреть истории без отметок «прочитано» и «просмотрено», скрывать «печатает» и другие статусы (запись голосового или кружка, отправка фото, выбор стикера…), быть не в сети или всегда в сети. «Читать при действиях» отмечает чат прочитанным, когда ты отвечаешь или ставишь реакцию. Исключения по чатам, папкам и типам чатов.
• Скрытие сообщений от заблокированных.
• Отложенная отправка: пауза перед отправкой текста и медиа.
• Анонимный режим: маска на камеру и изменённый голос одним нажатием.
• Подмена: показывать другой номер телефона, открывать другой профиль вместо выбранного. И то и другое — только на твоём устройстве.

Сообщения

• Удалённые и изменённые. Удалённые сообщения остаются в чате, у изменённых сохраняются прежние версии. Исключения, автоочистка по давности, экспорт и импорт истории.
• Обход ограничений: копирование и скриншоты в защищённых чатах, сохранение исчезающих и одноразовых медиа, открытие спойлеров, обход ограничений контента, скрытие рекламы.
• Отправка: правила замены слов, антикапс, ответ с цитатой, анонимные стикеры, без «via @бот», скрытие «Отправить как», отправка по Return.
• Перевод: Google, Telegram или системный переводчик, кнопка перевода на сообщениях, перевод перед отправкой, текст на фото.
• Меню и жесты: своё меню сообщения (переслать без автора, сохранить в «Избранное» или «Фото»…), двойное нажатие для редактирования, закладки.
• Экспорт чатов: один чат или весь аккаунт в HTML и JSON.

Безопасность

• Защита чатов: код-пароль или Face ID на выбранные чаты, секретная папка, скрытие чатов на скриншотах и записи экрана.
• Код-пароль: больше вариантов автоблокировки, блокировка при каждом запуске, «заблокировать сейчас».
• Аккаунты: Face ID при переключении аккаунтов, отдельные настройки для каждого аккаунта, перенос настроек с другого аккаунта.

Медиа и звонки

• Голос: смена голоса с пресетами и своим голосом (высота, тембр, реверберация, эхо…), эквалайзер, расшифровка голосовых и кружков (сервер Telegram с Premium, распознавание Apple без него — на устройстве, если для языка есть модель), автоматическая расшифровка, перевод текста.
• Кружки и камера: AR-маски в кружках и видеозвонках, студия масок, водяной знак на фото.
• Звонки: запись звонков, тихое выключение микрофона, саундборд, статистика во время звонка, звонки только по TCP, без просьб оценить звонок.
• Загрузки и качество: ускорение загрузки и отправки, большие фото, субтитры к видео по распознаванию речи.

Оформление

• Тема и фон: AMOLED, разделители, затухание краёв, анимированный GIF-фон чатов и профилей, снег.
• Сообщения: шрифты (из iOS или свои), пузыри, галочки, стикеры.
• Список чатов: строки, свайпы, аватарки, папки.
• Панели: таббар, поле ввода, быстрые кнопки.
• Иконки: наборы иконок, бейдж под Dynamic Island.
• Профиль и настройки: ID, дата-центр, даты, какие пункты показывать в Настройках.

Ещё

• VPN по подписке: подписки и серверы VLESS, Telegram ходит через твой сервер. Ядро Xray — отдельный фреймворк внутри приложения, загружается только при включённом VPN.
• Значки у имён (GCONNECT).
• Фейковые подарки: подарки в твоём профиле, которые видишь только ты.
• Дополнительно: встроенный Safari или другой браузер, картинка в картинке для YouTube, IP и api_id в сеансах, «Недавние действия» и «Администраторы» в меню, больше вариантов отключения звука и кэша, без предложений Premium.
• Настройки Ghostgram: язык, экспорт и импорт всех настроек, сброс.

Интерфейс на английском, русском, украинском и арабском.

Сборка

Нужны Mac с Xcode и Python 3. Bazel build-system/Make/Make.py скачивает сам при первом запуске.

1. Склонировать репозиторий с подмодулями:

   git clone --recursive -j8 https://github.com/ichmagmaus111/ghostgram.git
   cd ghostgram
   

2. Создать файл конфигурации и заполнить его: api_id и api_hash с my.telegram.org, свой Apple team_id и bundle_id, если подписываешь своим аккаунтом.

   cp build-system/ghostgram-configuration.example.json build-system/ghostgram-configuration.json
   

3. Сборка для симулятора:

   build-system/GGBuild.sh
   

   Симулятор подпись не проверяет, но Make.py всё равно читает профиль, совпадающий с team_id и bundle_id. Положи свои профили в build-system/ghostgram-codesigning/profiles или укажи другую папку подписи в GG_CODESIGN. Без них скрипт берёт build-system/fake-codesigning, а там профили только для ph.telegra.Telegraph.

4. Сборка для устройства (IPA):

   build-system/GGBuildRelease.sh <номер сборки>
   

   Нужны сертификат распространения (.p12 с пустым паролем) в build-system/ghostgram-codesigning/certs и профили приложения и его расширений в build-system/ghostgram-codesigning/profiles. Результат — build-output/ipa/Ghostgram.ipa.

Оба скрипта привязывают Bazel к Xcode, выбранному через xcode-select (build-system/GGXcodeConfig.sh), и накладывают патчи из build-system/GGPatches на подмодули rules_apple и tgcalls. Файл конфигурации, папка подписи и результаты сборки — в .gitignore.

Ядро VPN (по желанию)

Ghostgram/Features/Vless/Core/build-core.sh

Нужны Go 1.26 или новее и инструменты командной строки Xcode; первый запуск скачивает Xray-core. Без ядра приложение тоже собирается, а экран VPN сообщает, что ядра в сборке нет.

Устройство кода

• Ghostgram/ — всё, что добавляет Ghostgram: GGCore (настройки, строки, журнал), GGHooks (места, где Ghostgram подключается к коду Telegram), GGSettingsUI (меню), Features/ (функции), Strings/ (переводы; generate.py собирает таблицы строк, check.py их проверяет).
• Остальное дерево — Telegram iOS. Правки в собственных файлах Telegram минимальные и вызывают GGHooks.

Лицензия

Ghostgram распространяется по GNU General Public License v2, как и исходный код Telegram iOS, на котором он построен. У сторонних компонентов свои лицензии; их список есть в приложении (Настройки → Ghostgram → О приложении → Сторонние компоненты).

Если собираешь своё приложение из этого кода, соблюдай правила Telegram для разработчиков: получи свой api_id, не называй приложение Telegram и не используй его логотип, береги данные пользователей и публикуй свой код.