AyuGram FAQ

🇷🇺 Инструкция по исправлению запуска AyuGram на macOS

🍏 Если при попытке открыть/установить клиент система выдаёт ошибку или блокирует приложение, воспользуйтесь одним из предложенных способов.

☐ ​Способ №1: Системные настройки.
• Перейдите в Системные настройки ➝ Конфиденциальность и безопасность.
• Прокрутите страницу вниз до раздела «Безопасность».
• Найдите уведомление: «Приложение AyuGram.app было заблокировано, так как его автор не является установленным разработчиком».
• Нажмите кнопку «Всё равно открыть».
• Введите пароль от вашей учетной записи Mac для подтверждения.

☐ Способ №2: Снятие карантина через Терминал.
• Откройте приложение Терминал (через Spotlight или в папке «Программы» ➝ «Утилиты»).
• Скопируйте и вставьте следующую команду:
xattr -rd com.apple.quarantine /Applications/AyuGram.app
• Нажмите «Enter».
• Запустите снова AyuGram.

🇬🇧 Troubleshooting AyuGram launch on macOS

🍏 If the system displays an error or blocks the application when you attempt to open or install the client, use one of the following methods.

☐ Method №1: System settings.
• ​Navigate to System settings ➝ Privacy & Security.
• ​Scroll down to the Security section.
• ​Locate the notification: «AyuGram app was blocked from use because it is not from an identified developer».
• ​Click the «Open anyway» button.
• ​Enter your Mac account password to confirm the action.

☐ Method №2: Removing quarantine via Terminal.
• ​Open the Terminal app (via Spotlight or in the «Applications» ➝ «Utilities folder»).
• ​Copy and paste the following command:
xattr -rd com.apple.quarantine /Applications/AyuGram.app
• Press «Enter».
• Relaunch AyuGram.

🇷🇺 ЭТИ ВЕРСИИ ДЛЯ ТЕХ, У КОГО ПРОБЛЕМЫ СО ВХОДОМ

⚠️ Эти файлы — не «специальные».
Это просто старые версии, которые когда-то были на форуме, но из-за особенностей форумов в Telegram были безвозвратно утеряны.
﹡Эта инструкция решает проблемы у тех пользователей, которым предлагают добавить почту или купить премиум для входа в аккаунт.

Сама инструкция:
﹡Перед установкой, удалите нынешнее приложение с соответствующим именем пакета без сохранения данных, дабы исключить ошибку пакетов.
﹡Также удостоверьтесь, что у вас есть доступ к сеансам, чтобы получить код, после авторизации, обновитесь до актуальной версии.

🇬🇧 THESE VERSIONS ARE FOR USERS EXPERIENCING LOGIN ISSUES

⚠️ These files aren't «special».
Due to the nature of forums on Telegram, old posts get irretrievably deleted. These are just some of those old versions that were once posted but are now gone.
﹡This guide is for those who are being asked to add an email or buy Premium when trying to log in.

The instructions are as follows:
﹡Before installing, you must uninstall the current application with the corresponding package name without saving its data to prevent a package conflict.
﹡Also, ensure you have access to your other active sessions to receive the login code. After you log in, update to the latest version.

🇺🇸 [EN]: Questions about Plugins 🧩

1. Q: What are plugins?
A: Plugin is a separate Python module that “connects” to exteraGram/AyuGram and extends the client without modifying its core code.

2. Q: What are they for? Why should I enable them?
A: Plugins add ready-to-use features to the client: downloading media from other platforms (Media Downloader), UI customization, weather forecasts (Weather), currency conversion (Currency), and much more. You enable only the ones you need, making your messenger convenient and personalized without unnecessary features.

3. Q: How can I write my own plugin?
A: The documentation is available at plugins.exteragram.app

4. Q: Where can I find ready-made plugins?
A: Folder with trusted channels: https://t.me/addlist/pPhOtEq00KhjYTc6

🇷🇺 [RU]: Вопросы про плагины 🧩

1. В: Что такое плагины?
О: Плагин — это отдельный модуль на Python, который «подключается» к exteraGram/AyuGram и расширяет клиент без правки основного кода.

2. В: Для чего они нужны? Зачем мне их включать?
О: Плагины добавляют в клиент готовые фичи: скачивание медиа с других ресурсов (Media Downloader), изменение UI, прогноз погоды (Weather), перевод валют (Currency), и многое другое. Вы включаете только те, что нужны вам, и получаете удобный кастомизированный мессенджер без лишнего функционала.

3. В: Как мне написать свой плагин?
О: Документация находится на сайте plugins.exteragram.app

4. В: Где найти готовые плагины?
О: Папка с проверенными каналами: https://t.me/addlist/pPhOtEq00KhjYTc6

Старая подпись, автоапдейтер выключен.

Т.к. форум съел сообщение со старой подписью, решили перенести сюда

🇺🇸[EN]: Chat Regulations/Behavior

For a detailed understanding of all the rules and nuances of our community, we strongly recommend reviewing the full version of this article.

Let's talk about the chat.

To write anything in the chat, you must first complete a captcha. This is a mandatory requirement and cannot be bypassed or appealed.

To see the rules, you can use the .rules or /rules commands in the chat. If you are unable to send messages, you can do so via the bot.

If you haven't found an answer to your question in the FAQ or the chat, you can contact our technical support.

Do you want to continue chatting in our cozy AyuGram community, or do you believe you were wrongfully restricted (i.e., banned or muted)?
Fill out the form, and we will consider your case¹. You can also submit an appeal through the bot.

We're all human and need our rest. To the point: the chat remains open, but only text messages are allowed (yes, a more relaxed mode).
This rule is in effect from 00:00 to 09:00 MSK (Moscow Standard Time).

And most importantly... Do not DM the admins. And what should you do if you can't find an answer to "your question"?
Reread what's written above.

Footnotes:
¹ This depends on the violation. Violations vary: some are accidental, while others are severe and may not be eligible for appeal.

🇷🇺[RU]: Регламент/поведение в чате

Для подробного ознакомления со всеми правилами и нюансами нашего сообщества настоятельно рекомендуем изучить полную версию этой статьи.

Поговорим о чате.

Чтобы написать что-то в чат, вы должны пройти капчу, это обязательное условие и это никак не обходится/обжалуется.

Чтобы узнать правила, можно воспользоваться командами в чате .rules или /rules, если нет возможности написать, то в боте.

Если не нашли ответа на свой вопрос в FAQ или в чате, то Вы можете написать в тех. поддержку.

Хотите дальше общаться в уютном чате AyuGram или были незаслуженно ограничены, т.е. забанены или в муте?
Заполните форму и мы подумаем¹, также можно подать апелляцию через бота.

Все мы люди, и также устаём, поэтому всем необходим отдых. К делу, чат открыт, но разрешён только текст (да, более смягчённый режим).
Эта мера действует с 00:00 — 09:00 по МСК.

И самое главное... Не писать админам. И что же делать, если нет ответа на "мой вопрос"? Перечитать, что выше написано.

Примечания:
¹ В зависимости от нарушений. Бывают разные: случайные, без шанса и наоборот.

🇺🇸[EN]: Frequently Asked Questions. Part II

16. Q: AyuSync???
A: Synchronization of remote and changed messages between platforms (Android & Desktop). This feature has been removed, and there are currently no plans for its return

17. Q: I got logged out, and all my accounts are gone. How do I recover them?
A: Congratulations, you’ve triggered Telegram’s spam protection. This might have happened because you were messaging, threatening, scamming someone, or your message looked suspicious. And AyuGram has nothing to do with this. To log back into your account, you’ll need to use the official Telegram app and log in via SMS. If your account was linked to a virtual number, unfortunately, we can’t help you.
And any excuses like “I’m not spamming anyone” or “I didn’t do anything shady” will not be accepted

18. Q: Why everything is black when taking a screenshot or recording the screen?
A: Enable «App Content in Task Switcher — Show Content» in the passcode settings

19. Q: Why are stars cheaper?
A: AyuGram/exteraGram are based on the direct version, unlike Google Play, which takes a commission on purchases

20. Q: You have so many chats/channels, how can I tell which one is the official one?
A: The ✈ icon must appear immediately following the channel or chat name. When clicked, it will display the message: «… is the official resource of exteraGram». This indicator is only visible within the exteraGram and AyuGram clients

21. Q: My session crashed, was it cached?
A: The AyuGram feature that saves your session to the cache after any actions (see p.17), log out of your account

22. Q: AyuGram on iOS?
A: Currently, AyuGram is not available on iOS. If anyone offers it to you, it is a scam (read more)

🇷🇺[RU]: Частые вопросы. Часть Ⅱ

16. В: AyuSync???
О: Синхронизация удалённых и изменённых сообщений между платформами (Android & Desktop). Эта функция была удалена, и в данный момент нет планов по её возвращению

17. В: У меня завершаются сеансы принудительно, по несколько раз в день
О: Всё это происходит из-за системы антиспам Telegram (если вы писали, угрожали, скамили кого-то, или же ваше сообщение было подозрительным). И AyuGram тут не причём. Чтобы войти на аккаунт, нужно через официальный Telegram зайти по СМС. Если же у вас был аккаунт на виртуальном номере, к сожалению, помочь ничем не сможем.
Отмазки в стиле я никому не спамлю/никаких махинаций не совершаю — не принимаются

18. В: При снимке/записи экрана всё чёрное?
О: Включите в разделе код-пароль «Просмотр при переключении задач — Показывать»

19. В: Почему звёзды дешевле?
О: AyuGram/exteraGram основаны на direct-версии, в отличие от Google Play, который берёт комиссию с покупок

20. В: У Вас много чатов/каналов, как понять, что он официальный?
О: После названия канала/чата должна присутствовать ✈, при нажатии «… является официальным ресурсом exteraGram» и отображается только в клиентах exteraGram/AyuGram

21. В: У меня вылетела сессия и она была закеширована?
О: Функция AyuGram, которая сохраняет ваш сеанс в кэш после каких-либо действий (см. п.17), выйдите из аккаунта

22. В: AyuGram на iOS?
О: В данный момент на iOS нет AyuGram, если предлагают, то это обман (подробнее)

🇺🇸[EN]: Frequently asked questions. Part Ⅰ

Question-Answer Format

1. Q: When will the update be released?
A: A single developer works on this client, and they have a life of their own. Asking about updates in the chat is considered bad form.

2. Q: How can I help the project? And what do I get in return?
A: By supporting the project and sending a screenshot of the transaction, you'll get a 🇷🇺
next to your nickname, which is displayed in the exteraGram and AyuGram clients. And something else…

3. Q: On my PC, the session logs out after restarting the client.
A: Unpack the archive and open the .exe file directly.

4. Q: Log files are being created on my desktop (PC).
A: Move the AyuGram files (tdata, the exe itself, and modules) into a dedicated folder, create a shortcut to the .exe file on your desktop, and launch it from there.

5. Q: How many accounts can I add?
A: 🤖: 8 (without Premium)/16 (with Premium),
💻: 100 (without Premium)/200 (with Premium).

6. Q: The camera/video messages are not working (it crashes, shows strange colors, lags, etc.).
A: Disable Extended Frame Rate.

7. Q: How do I open t.me links on PC?
A: Go to AyuGram Preferences ➝ Other ➝ Associate links with AyuGram.

8. Q: The app constantly asks for microphone permission, even though it has already been granted.
A: Grant the «Nearby devices» permission.

9. Q: Will there be an AyuGram for iOS?
A: Not at the moment, but someday.

10. Q: How can I watch paid content for free?
A: You can't. Buy it.

11. Q: How do I disable the update notification?
A: As of version 20240720, you can't. Previously, in AyuGram/exteraGram, you could tap on the logo and disable it.

12. Q: Messages are disappearing or are not visible.
A: Clear the Telegram database. Go to Settings ➝ Data and Storage ➝ Storage Usage ➝ ︙ ➝ Clear Local Database.

13. Q: I can't find an answer to my question. What should I do?
A: Serious problems require serious solutions — uninstall AyuGram.

14. Q: I don't know which file to download. Can you advise?
A: Download the first one (universal). A link for your own research.

15. Q: Anything else?
A: We recommend reading the FAQ for the exteraGram client.

🇷🇺[RU]: Частые вопросы. Часть Ⅰ

Формат сообщения вопрос-ответ

1. В: Когда будет обновление?
О: Клиент делает живой человек, и у него тоже есть жизнь. Дождитесь обновления, вопросы в чате — моветон.

2. В: Как я могу помочь проекту? И что я могу получить взамен?
О: Поддержав проект и отправив скриншот о переводе, вы получаете 🇷🇺 возле никнейма, отображаемый в клиентах exteraGram и AyuGram. И ещё что-то…

3. В: На ПК после перезахода в клиент вылетает сессия.
О: Распакуйте архив и откройте .exe файл.

4. В: На рабочем столе (ПК) создаются логи.
О: Перемещаете файлы AyuGram (tdata, сам ехе и modules) в папку, создаёте ярлык на рабочем столе, привязываете ярлык к .ехе файлу.

5. В: Сколько можно добавить аккаунтов?
О: 🤖: 8 (без премиума) / 16 (с премиум), 💻: 100 (без премиума) / 200 (с премиум).

6. В: Не работает камера/видеосообщения (вылетает, разные цвета, лагает и т.д.).
О: Отключите расширенный диапозон FPS.

7. В: Открытие ссылок t.me на ПК?
О: Откройте Настройки AyuGram ➝ Другое ➝ Ассоциировать ссылки с AyuGram.

8. В: Постоянно выпрашивает разрешение на микрофон, хотя уже выдано.
О: Дайте разрешение на «Устройства поблизости».

9. В: На iOS будет AyuGram?
О: В данный момент нет, но когда нибудь будет.

10. В: Как бесплатно посмотреть платный контент?
О: Никак, купить.

11. В: Как отключить уведомление об обновлении?
О: С версии 20240720 — никак. Ранее, AyuGram/exteraGram, жмёте на лого и отключаете.

12. В: Пропадают сообщения или их не видно.
О: Очищаете базу данных Telegram в настройках ➝ Данные и память ➝ Использование памяти ➝ ︙➝ Очистить базу данных.

13. В: Не могу найти ответ, что делать?
О: Серьёзные проблемы требуют серьёзных решений — удалить AyuGram.

14. В: Не знаю какой файл скачать, подскажите?
О: Качаете первый (универсальный). Ссылка для саморазвития.

15. В: Что-то ещё?
О: Рекомендуем прочитать FAQ по клиенту exteraGram.

🇷🇺 Режим стримера

👁 Что такое режим стримера? (Desktop)

Скрывает окна и уведомления AyuGram от программ для захвата экрана. Это означает, что вы можете включить демонстрацию экрана (например, в Discord), и никто не увидит ваши сообщения и диалоги.

В зависимости от настроения Windows, будет отображаться либо как чёрный квадрат, либо как «ничего». Буквально.

Контекстные меню по-прежнему видны.

🇬🇧 Streamer mode

👁 What is a Streamer mode? (Desktop)

This one hides AyuGram windows and notifications from capture apps. It means that you can enable screensharing (e.g. in Discord) and nobody will see your messages and dialogs.
Depending on Windows' mood, it'll be displayed either as a black box or as «nothing». literally.

Context menus are still visible.

🇷🇺 Режим призрака

👻 Режим призрака позволяет частично скрыть вашу активность. С каждой из этих функций вы можете прочитать в документации.
• Прочитанные сообщения становятся опять непрочитанными? — Почистите бд тг, выключите полностью призрак и прочтите заново сообщения.
• ​Для обеспечения непрерывного офлайна необходимо активировать весь стек настроек призрака (5/5) и функцию Использовать отложку.
⚠️ Длительная симуляция офлайна ведёт к удалению аккаунта, т.к. сервер Telegram посчитает его заброшенным. Если не совершать кратковременных выходов в сеть, учётная запись будет безвозвратно удалена автоматической системой защиты по истечении срока неактивности.

Офлайн статус будет обновлён в следующих случаях:
1. Взаимодействие с сообщениями
• Использование функции «Прочитать».
• Закрепление сообщений в группах, каналах и форумах. В личных переписках — закрепление «для обоих собеседников» (кроме чата «Избранное»).
• Отправка исчезающих сообщений (TTL).
• ​Отправка приветственных стикеров в новых чатах.
• ​Трансляция геопозиции в реальном времени.

2. Управление чатами и сообществами
• Создание каналов, групп и веток на форумах.
• Открытие или закрытие тем, а также выход из групп и форумов.
• Изменение названий, фото или превью (оформления) тем и самих сообществ.
• Некорректное удаление групп (не через профиль или без подтверждения «Удалить для всех»).
• Вступление в закрытые группы по пригласительным ссылкам.

3. Звонки и мультимедиа
• Входящие и исходящие видеозвонки, создание видеочатов и проведение трансляций.
• Публикация историй.
• Использование функции «Предложить фото» для профиля контакта.

4. Технические и системные ограничения
• Работа при нестабильном соединении во время отправки файлов или в моменты глобальных сбоев серверов Telegram.
• Использование шаблонов «Нет на месте» и сторонних плагинов, заменяющих премиум функционал.

🇬🇧 Ghost Mode

👻 Ghost mode allows you to partially conceal your online activity. You can review the specifics of each feature in the documentation.
• Are read messages reverting to an unread status? — Clear the Telegram database, disable ghost mode entirely, and re-read the messages.
• To ensure a continuous offline appearance, you must activate the complete stack of ghost settings (5/5) and the Use scheduled send feature.
⚠️ Prolonged offline simulation leads to account termination, as Telegram's servers will deem it abandoned. If you do not perform brief network check-ins, the account will be irrevocably deleted by the automated security system once the inactivity threshold is reached.

Your offline status will be reset (updated to "online") in the following scenarios:
1. Message interaction
• Utilizing the «Read» function.
• Pinning messages in groups, channels, and forums. In private conversations — pinning «for both participants» (excluding the «Saved Messages» chat).
• Sending self-destructing messages (TTL).
• Sending greeting stickers in newly initiated chats.
• Live location broadcasting.

2. Chat and community management
• Creating channels, groups, or forum threads.
• Opening/closing topics, as well as leaving groups and forums.
• Modifying titles, profile pictures, or previews (branding) for topics and communities.
• Improper deletion of groups (e.g., not through the profile or without confirming «Delete for all subscribers»).
• Joining private groups via invitation links.

3. Calls and multimedia
• Incoming and outgoing video calls, initiating video chats, or hosting broadcasts.
• Posting Stories.
• Using the «Suggest profile photo» feature for a contact.

4. Technical and system constraints
• Operating under an unstable connection during file uploads or during global Telegram server outages.
• Utilizing «Away Messages» templates or third-party plugins designed to bypass/replace Premium functionality.

🇷🇺 Конфликт пакетов. Ошибка при установке или обновлении

📰 В этой статье вы узнаете, из-за чего происходит конфликт пакетов и что делать, если вы удалили приложение с сохранением данных.

⚠️ Для корректного отображения всех элементов и полноты картины настоятельно рекомендуется открыть эту статью в браузере.

Расшифровка других ошибок в клиенте:
• CONNECTION_LAYER_INVALID — переавторизуйтесь в клиенте.
• Ошибка обновления клиента 5 / «Сообщение не найдено» — переустановите приложение.

🇬🇧 Package conflict. Installation or update error

📰 In this article, you will learn the root causes of package conflicts and the necessary steps to take if you have uninstalled an application while opting to keep data.

⚠️ Please open this article in a browser for correct display of all elements and a complete view.

Troubleshooting other client errors:
• CONNECTION_LAYER_INVALID — log out and log back into the client.
• Client update error 5 / «Message not found» — reinstall the application.

🇷🇺 ИИ Чат: Ваш помощник

🤖 Что такое AI Chat или ИИ чат?
• ИИ чат — это ваш персональный ассистент на базе искусственного интеллекта, интегрированный прямо в exteraGram.
Он способен помочь в самых разных задачах: от простого перевода текста до написания кода или генерации творческих идей, в зависимости от ваших целей.

Где взять API-ключ?
• Получить его можно в соответствующей теме на форуме.

Что делать, если API-ключ не добавляется или не работает?
• Исчерпан лимит использования: у вашего ключа закончился бесплатный пробный период или на нём нулевой баланс. Создайте новый аккаунт или оформите платную подписку у провайдера API.
• Географические ограничения: некоторые сервисы ИИ ограничены для использования в определённых странах. Используйте VPN или прокси-сервер для обхода региональных ограничений.

Как его использовать?
• Ответ на существующее сообщение через контекстное меню.
Для начала включите параметр «Генерировать».
Находясь в любом чате, нажимаете на сообщение, чтобы вызвать контекстное меню, выбираете «Генерировать» и задаёте параметры для ответа, исходя из ваших запросов.
• Генерация нового текста через кнопку «Отправить».
В поле для ввода текста напишите свой запрос, удерживайте кнопку «➡️» и выберите «🤖», после чего ждёте ответ.

Дополнительные возможности
• Очистка контекста.
В меню, вызываемом удержанием кнопки «➡️», есть иконка корзины «🗑». Она полностью стирает историю вашего предыдущего общения с ИИ или можете вообще отключить историю.
• Настройка ролей.
Для выполнения специфических и повторяющихся задач, вы можете создавать и настраивать роли для ИИ.

🇬🇧 AI Chat: Your assistant

🤖 What is AI Chat?
• The AI Chat is your personal assistant powered by artificial intelligence, integrated directly into exteraGram. It can help with a wide range of tasks: from simple text translation to writing code or generating creative ideas, depending on your needs.

Where can I get an API key?
• You can get one in the relevant topic on our forum.

What should I do if the API key can't be added or isn't working?
• Usage limit has been reached: Your key's free trial has ended, or it has a zero balance. Create a new account or purchase a paid subscription from the API provider.
• Geographical restrictions: Some AI services are restricted for use in certain countries. Use a VPN or a proxy server to bypass regional restrictions.

How do I use it?
• Replying to an existing message via the context menu.
First, enable the «Generate» option. While in any chat, tap on a message to bring up the context menu, select «Generate», and set the parameters for the response based on your needs.
• Generating new text via the «Send» button.
In the text input field, write your prompt, then long-press the «➡️» button and select «🤖». After that, just wait for the response.

Additional features
• Clearing context.
In the menu that appears when you long-press the «➡️» button, there is a trash can icon «🗑». It completely clears your previous conversation history with the AI. You can also disable history altogether.
• Configuring roles.
For specific and repetitive tasks, you can create and customize roles for the AI.

🇺🇸[EN]: Message Filters

What are the filters?

They allow to hide messages in channels and chats (as well as in dialogs list) by using regular expressions.

You can use regex101.com to test your expressions. Don't forget to select «Java» flavor.

Shadow ban is the practice of hiding your messages from selected users without adding them to your block list.

Filters list ➝ tg:/­/ayu/filters
Add filter ➝ tg://ayu/filter/DIALOG_ID

🇷🇺[RU]: Фильтры

Что такое фильтры?

Это скрытие постов/сообщений в чатах в зависимости от регулярных выражений, а также они не будут отображаться в списке диалогов.

Вы можете использовать regex101.com для тестирования ваших выражений. Не забудьте выбрать вариант «Java».

Для тех, кто не понимает, что такое regex/регулярные выражения, то можете почитать этот пост на 4pda, там же можно посмотреть примеры и другие объяснения.

Теневой бан — скрытие сообщений от выбранных вами пользователей, без добавления их в чёрный список.

Быстрые ссылки:
Список фильтров ➝ tg://ayu/filters
Добавить фильтр в диалог ➝ ­tg://ayu/filter/DIALOG_ID­