Welcome to the AyuGram FAQ!

Terminology: AyuGram is a 'client' or a 'fork', nothing else — not a 'mod'. It is not recommended to distort the name of the client in our chat, even as a joke (e.g. as 'augram'). This is unacceptable.

The client name is pronounced as AyuGrám [ʌjuːgram].

Why such a strange name?
Ayu means cute, and Gram is the basic suffix for all Telegram clients.
Translated directly, it means «cute Telegram».

AyuGram is a client that contains functionality that violates the Telegram developer's ToS.

You can learn more about the client at docs.ayugram.one

The FAQ messages will be changed/updated.

Приветствуем вас, FAQ по AyuGram!

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

Итак, начнём с названия, правильно AyuGrám [аюгрáм]. Почему такое странное название?
Ayu — симпатичный, Gram — базовый суффикс у всех тг-клиентов.
Если дословно, «симпатичный телеграм».

AyuGram — продвинутый клиент и/или форк exteraGram и никак более (не мод и другие коверкание названия, это наказуемо), содержит функционал, который частично нарушает ToS разработчика Telegram и на который придётся потратить время для его изучения.

Для начала договоримся о том, что AyuGram — это клиент или форк, не более. Не рекомендуется в нашем чате искажать название клиента, даже в шутку. Это недопустимо, или последует наказание.

Более подробно ознакомиться с клиентом можно docs.ayugram.one

Также для русскоговорящих имеется тема на 4PDA с FAQ.

Сообщения FAQ будут изменяться/дополняться.

Из-за «тяжести» информации FAQ был переделан и переиздан.
Если и после этого будут вопросы, не обольщайтесь, будет кара небесная. 🤓

∙ About AyuGram
∙ Important information
∙ Is it malicious?
∙ Authorization and troubleshooting common issues
∙ Translator & message forwarding
∙ Notifications work
∙ Message saving system
∙ Local Premium
∙ Peek Online
∙ Message Filters
∙ AI Chat
∙ Error when installing/updating
∙ Ghost Mode
∙ Streamer Mode
∙ Answers to frequent questions. Part Ⅰ | Part Ⅱ
∙ Forum rules
∙ What are plugins and where do you get them from?

∙ Кратко о AyuGram
∙ Сообщение с важной информацией
∙ Вирусы?!
∙ Авторизация и решение сопутствующих проблем
∙ Переводчик и пересылка сообщений
∙ Работа уведомлений
∙ Работа сохранения сообщений
∙ Локальный премиум
∙ Подглядеть онлайн
∙ Фильтры
∙ ИИ Чат
∙ Ошибка при установке/обновлении
∙ Режим призрака
∙ Режим стримера
∙ Ответы на частые вопросы. Часть Ⅰ | Часть Ⅱ
∙ Регламент/поведение в чате
∙ Что такое плагины и откуда их брать?

With the growing popularity of the client, non-existent Telegram clients appeared. They have silly names (doxgram, hakogram, echpochmakgram, etc.); in simple terms, they are selling non-existent apps by adding non-existent/non-implementable features to the denoscription (such as displaying what your friend is writing in real time; deanon; restoration of messages/accounts, etc.).

The situation is similar with the iOS version — it doesn’t exist. If you're asked to login into Apple Account — you're being scammed.
More detailed information about it here.

Therefore, the code for Android has been closed to prevent it from falling into foreign hands for free.
If you're a dev with experience and some public background — you may write to the devs to become a contributor.

We take no responsibility if you fell for scammers' tricks.

Below are official sources:
exteraGram: Channel | Forum
AyuGram: Channel | Forum | FCM | Releases

С ростом популярности клиента и развилось мошенничество, клиенту начали не только присваивать имена (doxgram, hakogram, эчпочмакграм и др.), но и авторство, простыми словами, продают, добавив к описанию несуществующие/нереализуемые функции (отображение, что пишет собеседник; пробив/деанон; восстановление переписок/аккаунтов и т. д.).
Про один "клиент" уже имеется интересный разбор, почитайте.

Также дела обстоят с версией iOS — её нет. Краткие ответы, если вам лень читать.

Поэтому код для Android был закрыт, дабы не попадали в чужие руки даром.
Если вы имеете опыт/практические умения в разработке приложений и популярны в этой среде, то можете написать разработчикам, чтобы стать участником проекта.

Мы не несём никакой ответственности, если вы повелись на уловки мошенников — нянчиться с вами никто не будет.

Ниже представлены официальные источники:
exteraGram: Канал | Форум
AyuGram: Канал | Форум | FCM | Релизы

My antivirus shows that AyuGram is a virus

The first thing you might encounter is an antivirus message stating that AyuGram may be a virus.

You have two options:
1. You can add AyuGram to the list of trusted applications and continue using it, ignoring the antivirus warning.
2. If you trust your antivirus, you can uninstall AyuGram and leave the chat.

Reputation is the most valuable asset.
The developers never even consider adding viruses to the program or engaging in such activities.

Мой антивирус обнаружил вирус в AyuGram!

Первое, с чем вы, возможно, столкнётесь — это сообщение антивируса о том, что AyuGram может быть вирусом.

У вас есть два варианта:
1. Вы можете добавить AyuGram в список доверенных приложений и продолжить пользоваться им, не обращая внимания на предупреждение антивируса.
2. Если вы уверены в своём антивирусе, вы можете удалить AyuGram и выйти из чата.

Репутация — это самое ценное.
Даже мысли не возникает у разработчиков о том, чтобы добавить в программу вирусы или заниматься подобными делами.

Account creation must be done ONLY through the official Telegram client.

Can't get the code?
First, log in to your account using the official Telegram client or Telegram X.
When logging into AyuGram, you must uncheck the «Test Backend» option before requesting the code. The Test Backend, also known as a test server, is an environment used by developers to verify that features and systems are working correctly.
If the previous steps didn't help, try one of the following methods:
• Activate a VPN or a proxy server.
• Change your network connection type (Wi-Fi ⇄ Mobile Data).
• Take a break and try again later (no sooner than 24 hours).
﹡Keep in mind that for frequent code requests, the Telegram system will issue a temporary restriction (for 24 hours) that cannot be accelerated or bypassed in any way.
• If you've tried everything and nothing has worked, follow this guide.
(This guide also helps with other login errors).


Content not loading (Stuck on «Connecting…») or messages not sending on some accounts?
• First, completely restart the application.
• If the problem persists, log out of the account and then log back in.
• Is content still loading slowly in AyuGram, while in Telegram it's fast?
— Just accept it; it’s an artificial slowdown imposed by Telegram developers on all forks.

Создание аккаунта происходит ТОЛЬКО через официальный клиент Telegram.

Не можете получить код?
• Сначала войдите в свой аккаунт через официальный клиент Telegram или Telegram X.
• При входе в AyuGram в обязательном порядке снимите галочку с пункта «Тестировать Backend» перед запросом кода. Тестовый Backend или же тестовый сервер предназначен исключительно для разработчиков.
Если предыдущие шаги не помогли, примените один из следующих методов:
• Активируйте VPN или прокси-сервер.
• Смените тип сетевого подключения (Wi-Fi ⇄ Мобильный интернет).
• Возьмите паузу и повторите попытку позже (не ранее чем через сутки).
﹡Имейте ввиду, за частые попытки запроса кода система Telegram выдаст ограничение (24 часа), которое никак нельзя ускорить или пропустить.
• Если вы перепробовали всё, а чуда не произошло, ваш путь лежит к этой инструкции. Эта инструкция помогает и с другими ошибками входа.


Не загружается контент (Бесконечное «Подключение»…) или не отправляются сообщения в некоторых аккаунтах?
• Сначала полностью перезапустите приложение.
• Если проблема сохраняется, выполните выход из аккаунта с последующим повторным входом.
• Всё также медленно грузится контент в AyuGram, а в Telegram быстро?
— Смиритесь, это искусственное замедление от разработчиков Telegram для всех форков.

The difference between FCM and regular (vanilla) versions. How to remove the notification? (✿◕‿◕)

FCM (Firebase Cloud Messages) versions work using Google services or their equivalent, MicroG. As a result, they consume less power, and there is no notification with emoticons (kaomoji), as well as less lag (provided that "Background activity" is not enabled).
The only difference between fcm and fcmweb is the package name and compliance with Google Play formalities, such as charging commissions on payments, which is why prices in the web version are lower, and content restrictions from Google, etc.

How to disable kaomoji?
1st method:
Disable the AyuPush Service by long-pressing the notification, or by turning off «Background activity» in AyuGram settings (Customization) and then force-closing the app.
In the first case of this method, battery consumption will remain just as high; in the second case, you will lose notifications.

2nd method:
Download the APK file from AyuGram FCM. If you encounter a package conflict or the kaomoji appears, follow the 1st method; battery consumption will not increase.

Explanations
☐ AyuGram works as a standalone application, not as an add-on or anything similar.

☐ What's the point of the vanilla version then, if FCM exists?
— The vast majority uses the FCM version. The other one is for specific cases, like users who have two Telegram clients installed (which is a bit strange), or for GrapheneOS users.

☐ If you are not receiving notifications, click here.

☐ You can read more here, as well as in the documentation.

Разница между FCM и обычной (ванильной) версиями. Как убрать уведомление? (✿◕‿◕)

Версии FCM (Firebase Cloud Messages) работают за счёт Google сервисов или аналог MicroG, тем самым, потребляют меньше энергию, и нет уведомления со смайликами (каомодзи), а также меньше лагов (если же не включена «Работа в фоне»).
Отличие fcm от fcmweb только именем пакета и с сохранением формальностей Google Play: взиманием комиссий при оплате, поэтому в web-версии цены дешевле; ограничение контента со стороны Google и т.д.

Как отключить каомодзи?
1-ый способ:
Отключение AyuPush Service, зажав на уведомление, либо выключением в настройках AyuGram (Кастомизация) «Работа в фоне» и принудительное закрытие приложения.
В первом случае этого способа, расход батареи будет таким же высоким, во втором случае, вы лишитесь уведомлений.

2-ой способ:
Скачиваете APK-файл из AyuGram FCM. Конфликт пакетов?!
Появилось каомодзи — читаете 1-ый способ, расход батареи не увеличится.

Пояснения
☐ AyuGram работает как обычное приложение, а не дополнение и ещё как-нибудь.

☐ Какой тогда смысл в ванильной версии, если есть FCM? — Подавляющее большинство ей пользуется, бывают случаи, когда у пользователя установлено 2 клиента Telegram, что немного странно или же пользователи GrapheneOS.

☐ Если у вас не приходят уведомления, тыкните.

☐ Подробнее прочитать можете здесь, а также в документации.

Some messages are not saved (files, edits, ...), and/or I'm experiencing lag. What should I do?

☐ Unlike clients with similar functionality, AyuGram saves deleted messages to a separate database (DB), without affecting the main Telegram DB.

☐ Furthermore, the storage system attempts to automatically download or cache files before they expire on the server, which increases the chances of saving media.
If this doesn't happen due to technical reasons beyond our control (e.g., no/poor internet connection, a low-end device, etc.), it is not the client's problem. There's no need to complain about it. The edit history and last seen status work on the same principle.

☐ By default, everything is stored in Download/AyuGram/Saved Attachments, but you can change this in the AyuGram settings.

☐ Please note that media files in public chats and channels are not saved by default — you can change this in the settings (tap on «Save attachments» in the spy settings).

☐ The AyuGram DB can be transferred using two links: tg://ayu/db_export and tg://ayu/db_import. Save them to your Saved Messages to use them from there, or use them in the spy feature. You must first grant «All files access» permission; it won't work without it.

☐ If you see out-of-place photos/videos in your gallery, either create a .nomedia file in that folder manually or rename the folder by adding a dot to the beginning of its name.

☐ If deleted messages are only partially displayed, you can see the full history by tapping in a chat ︙ ➝ AyuGram ➝ View deleted messages.

☐ That was for the Android version. On the desktop client, the database is stored at tdata/ayudata.db. The peculiar behavior is that the remote sessions disappear after the client is closed.

☐ You can view the edit history by opening the context menu on a message and selecting History. If this option is not available, please refer to the second paragraph above.

☐ If the app is lagging, read the post about how notifications work. As a last resort, clear the deleted messages, the cache, and both databases.

☐ More details on how message saving works.

У меня сохраняются не все удалёнки/история редактирования, также у меня лагает, что делать?!

☐ В отличие от клиентов с аналогичным функционалом, в AyuGram удалёнки сохраняются в отдельную базу данных (далее бд), не затрагивая саму бд Telegram.

☐ Кроме того, система хранения пытается автоматически загрузить или закэшировать файлы до их истечения на сервере, что даёт больше шансов сохранить медиа. Если это не произошло по независящим техническим причинам (отсутствие и/или слабое интернет-соединение, слабое устройство и т.д.), то это уже не проблема клиента, ныть об этом не надо. По такому же принципу работает с историей изменений и последним онлайном.

☐ По умолчанию всё хранится в Download/AyuGram/Saved Attachments, но вы можете изменить это в настройках AyuGram.
Обратите внимание, что медиафайлы в публичных чатах и каналах по умолчанию не сохраняются — вы можете изменить это в настройках (нажмите на «Сохранять вложения» в настройках шпиона).

☐ Перенос бд AyuGram осуществляется с помощью двух ссылок: tg://ayu/db_export и tg://ayu/db_import (сохраните их в избранное и можете оттуда использовать, либо в шпионе), заранее дав разрешение «Доступ ко всем файлам», без него у вас не получится.

☐ Если вы видите в галерее «несуразного» вида фото/видео — создайте файл .nomedia в этой папке вручную или переименуйте папку, добавив в начало имени точку.

☐ При частичном отображении удалёнок и для полноты картины нажмите в чате ︙ ➝ AyuGram ➝ Посмотреть удалёнки.

☐ Это было для Android, на Desktop бд хранится tdata/ayudata.db. И особенность такова, что после закрытия клиента удалёнки исчезают.

☐ Посмотреть историю изменений можно, вызвав контекстное меню на сообщении ➝ История; если нет, то читаете 2-ой абзац.

☐ Если лагает, то читаете пост про работу уведомлений. В крайнем случае, чистите удалёнки, кэш и обе бд.

☐ Более подробно о работе сохранения сообщений.

What is Local Premium?

Local Premium allows you to set emoji status and replies' color. Only you would see it — no one else, even AyuGram users.
You'd be able to use a translator, tho it'd be laggy.
On PC, it'd only allow you to use translator — emoji and replies' color won't save.
If you have Telegram Premium, some premium features might conflict when enabled.
Starting with a recent update, non-premium users will be able to use local premium emoji, which will only be visible to other exteraGram or AyuGram for Android users.

Publishing stories without premium access depends on the country code. Stories cannot be posted without premium access in Russia, Ukraine, India, and Iran.

It can be enabled in AyuGram settings ➝ Customization ➝ Local Premium.

Что такое локальный премиум?

Локальный премиум на то и локальный, что премиум у себя видите только вы сами, и только в АЮГРАМ.
Локальный значит фейковый, фейковый значит ненастоящий!
Эмодзи статус и цвета реплаев сохраняются только на Android. На ПК не работает — и это не баг.
Если у вас оплаченный Telegram премиум, то при включении некоторые премиум функции будут конфликтовать.
С недавнего обновления для пользователей без премиум смогут использовать локальные премиум эмодзи, которые будут видны только другим пользователям exteraGram или AyuGram на Android.

Публикация историй без наличия премиума зависит от номера страны.
Истории нельзя выкладывать без премиума в России, Украине, Индии и Иране (этот список неполный).
И ещё вопрос: если вы захотите изменить номер другого региона, будут ли применяться параметры к нему или нет? Проверяйте сами.
Включается в настройках AyuGram ➝ Кастомизация ➝ Локальный премиум.

И зачем он нужен тогда, если он локальный?! —Для перевода всего чата, хоть и он будет немного подтупливать.

Не можете смириться с этим фактом?
Тогда купите премиум или оформите через официального бота, все функции серверные или смиритесь.

What is «Peek Online» and why doesn't it work?

It's a feature replacement from Telegram Premium that allows you to see if others are online, even if their status is hidden from YOU.

IF NOTHING IS DISPLAYED — IT MEANS THE USER HAS HIDDEN THEIR ONLINE STATUS AND THERE'S NO WAY TO FIND OUT!

This feature isn't a hacking tool. It just quickly toggles your 'last seen' privacy settings for a moment. This is just long enough for the app to see and record the other person's online time for you. That's all there is to it.

There's another method if you have two accounts. For instance, if a user hides their online status from your first account but not your second, attempting to check from the first account will cause the second account to act as a bridge, passing the status information over.

Что такое «Подглядеть онлайн» и почему он не работает?

Замена функции из Telegram Premium, предоставляя узнать онлайн у других, если он скрыт у ВАС.

ЕСЛИ НИЧЕГО НЕ ВЫВЕЛОСЬ — ЗНАЧИТ У ПОЛЬЗОВАТЕЛЯ СКРЫТ ОНЛАЙН И НИКАК НЕЛЬЗЯ УЗНАТЬ!

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

Также есть и другой способ работы, если в клиенте имеется два аккаунта.
Например, у вас есть пользователь, который скрыл для 1-го аккаунта активность, но для 2-го открыт.
Попытавшись подсмотреть с 1-го, то 2-ой аккаунт будет мостом, который будет перенаправлять данные о сети на 1-ый.