monogram-android
diff --git a/‎.gitattributes‎
Lines changed: 16 additions & 0 deletions b/‎.gitattributes‎
Lines changed: 16 additions & 0 deletions
diff --git a/‎.gitignore‎
Lines changed: 37 additions & 19 deletions b/‎.gitignore‎
Lines changed: 37 additions & 19 deletions
diff --git a/‎.gitmodules‎
Lines changed: 3 additions & 0 deletions b/‎.gitmodules‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎README.md‎
Lines changed: 11 additions & 2 deletions b/‎README.md‎
Lines changed: 11 additions & 2 deletions
diff --git a/‎README_ES.md‎
Lines changed: 12 additions & 2 deletions b/‎README_ES.md‎
Lines changed: 12 additions & 2 deletions
diff --git a/‎README_KOR.md‎
Lines changed: 11 additions & 2 deletions b/‎README_KOR.md‎
Lines changed: 11 additions & 2 deletions
diff --git a/‎README_RU.md‎
Lines changed: 11 additions & 2 deletions b/‎README_RU.md‎
Lines changed: 11 additions & 2 deletions
diff --git a/‎README_UR.md‎
Lines changed: 11 additions & 2 deletions b/‎README_UR.md‎
Lines changed: 11 additions & 2 deletions
@@ -0,0 +1,16 @@
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# These are explicitly windows files and should use crlf
+*.bat           text eol=crlf
@@ -1,21 +1,39 @@
-*.iml
-.gradle
-/local.properties
-/.idea/caches
-/.idea/libraries
-/.idea/modules.xml
-/.idea/workspace.xml
-/.idea/navEditor.xml
-/.idea/assetWizardSettings.xml
-.DS_Store
-/build
-/captures
-.externalNativeBuild
-.cxx
+# Gradle files
+.gradle/
+build/
+
+# Kotlin Gradle plugin data
+.kotlin/
+
+# Local configuration file (sdk path, etc)
 local.properties
-/.idea
-/.kotlin/sessions
-/app/release
-*/build
+
+# Log/OS Files
+*.log
+.DS_Store
+
+# Android Studio generated files and folders
+captures/
+.externalNativeBuild/
+.cxx/
+*.aab
+*.apk
+output-metadata.json
+
+# IntelliJ
+*.iml
+.idea/
+misc.xml
+deploymentTargetDropDown.xml
+render.experimental.xml
+
+# Keystore files
+*.jks
+*.keystore
+
+# Google Services (e.g. APIs or Firebase)
 google-services.json
-/.kotlin/errors
+
+# Android Profiling
+*.hprof
+/app/release/baselineProfiles
@@ -1,3 +1,6 @@
 [submodule "presentation/src/main/cpp/third_party/libvpx"]
 	path = presentation/src/main/cpp/third_party/libvpx
 	url = https://github.com/webmproject/libvpx.git
+[submodule "presentation/src/main/cpp/third_party/rlottie"]
+	path = presentation/src/main/cpp/third_party/rlottie
+	url = https://github.com/monogram-android/rlottie
@@ -50,6 +50,7 @@ Support the project on [**Boosty**](https://boosty.to/monogram).
 
 ## Key Features
 
+- **Independent Client** — Not a fork of Telegram for Android. MonoGram is built entirely from scratch as a standalone project.
 - **Material Design 3** — A beautiful, adaptive UI that looks great on phones, tablets, and foldables.
 - **Secure** — Built-in biometric locking and encrypted local storage.
 - **Media Rich** — High-performance media playback with ExoPlayer and Coil 3.
@@ -72,7 +73,7 @@ Follow these steps to set up the project locally.
 ### 1. Clone the Repository
 
 ```bash
-git clone https://github.com/monogram-android/monogram.git
+git clone --recurse-submodules https://github.com/monogram-android/monogram.git
 cd monogram
 ```
 
@@ -105,7 +106,15 @@ API_HASH=your_api_hash_here
 10. Click **Update** next to the FCM credentials section.
 11. Upload the service account JSON on the page that opens.
 
-### 4. Build and Run
+### 4. First Time Setup: Building libvpx
+
+The animations require libvpx to be compiled. This has to be done before starting a Gradle build or it will cause build failures.
+
+1. Change your working directory to `presentation/src/main/cpp`
+2. In `build.sh`, add your `ANDROID_NDK_HOME`
+3. Run `build.sh` and wait for it to finish
+
+### 5. Build and Run
 
 1. Open the project in **Android Studio**.
 2. Increase the IDE indexing limits so `TdApi.java` (the TDLib wrapper) is indexed correctly. In **Android Studio** or **IntelliJ IDEA**, open **Help → Edit Custom Properties...**, paste the lines below, and restart the IDE if prompted:
 
@@ -54,6 +54,8 @@ Ayuda al proyecto en [**Boosty**](https://boosty.to/monogram).
 
 ## Características Clave
 
+- **Cliente Independiente** — No es un fork de Telegram para Android. MonoGram
+  está construido completamente desde cero como un proyecto independiente.
 - **Material Design 3** — Una bonita y adaptativa UI que se ve grandiosa en
   celulares, tablets y plegables.
 - **Seguro** — Almacenamiento local encriptado y bloqueo biométrico incluido.
@@ -82,7 +84,7 @@ Sigue estos pasos para configurar el proyecto localmente.
 ### 1. Clona el Repositorio
 
 ```bash
-git clone https://github.com/monogram-android/monogram.git
+git clone --recurse-submodules https://github.com/monogram-android/monogram.git
 cd monogram
 ```
 
@@ -124,7 +126,15 @@ API_HASH=your_api_hash_here
 10. Clickea en **Update** después de la sección FCM credentials.
 11. Sube el service account JSON en la página que se abre.
 
-### 4. Compilar y Ejecutar
+### 4. Primera Configuración: Compilar libvpx
+
+Las animaciones requieren que libvpx esté compilado. Esto debe hacerse antes de iniciar una compilación de Gradle; de lo contrario, la compilación fallará.
+
+1. Cambia tu directorio de trabajo a `presentation/src/main/cpp`.
+2. En `build.sh`, añade tu `ANDROID_NDK_HOME`.
+3. Ejecuta `build.sh` y espera a que termine.
+
+### 5. Compilar y Ejecutar
 
 1. Abre el proyecto en **Android Studio**.
 2. Aumenta los límites de indexado del IDE para que `TdApi.java` (el wrapper de
 
@@ -49,6 +49,7 @@
 
 ## 주요 기능
 
+- **독립 클라이언트** — Telegram for Android의 포크가 아닙니다. MonoGram은 독립 프로젝트로서 처음부터 완전히 새롭게 구축되었습니다.
 - **Material Design 3** — 스마트폰, 태블릿, 폴더블 기기에서 모두 멋지게 보이는 아름답고 적응형인 UI입니다.
 - **보안** — 생체 인식 잠금 및 암호화된 로컬 저장소가 내장되어 있습니다.
 - **풍부한 미디어** — ExoPlayer와 Coil 3를 사용한 고성능 미디어 재생을 지원합니다.
@@ -71,7 +72,7 @@
 ### 1. 저장소 클론
 
 ```bash
-git clone https://github.com/monogram-android/monogram.git
+git clone --recurse-submodules https://github.com/monogram-android/monogram.git
 cd monogram
 ```
 
@@ -104,7 +105,15 @@ API_HASH=your_api_hash_here
 10. FCM 자격 증명 섹션 옆의 **Update**를 클릭합니다.
 11. 열린 페이지에서 다운로드한 서비스 계정 JSON 파일을 업로드합니다.
 
-### 4. 빌드 및 실행
+### 4. 최초 설정: libvpx 빌드
+
+애니메이션을 사용하려면 libvpx를 먼저 컴파일해야 합니다. Gradle 빌드를 시작하기 전에 이 작업을 하지 않으면 빌드가 실패할 수 있습니다.
+
+1. 작업 디렉터리를 `presentation/src/main/cpp`로 이동합니다.
+2. `build.sh`에 `ANDROID_NDK_HOME`을 추가합니다.
+3. `build.sh`를 실행하고 완료될 때까지 기다립니다.
+
+### 5. 빌드 및 실행
 
 1. **Android Studio**에서 프로젝트를 엽니다.
 2. `TdApi.java`(TDLib 래퍼)가 올바르게 인덱싱되도록 IDE 인덱싱 제한을 늘립니다. **Android Studio** 또는 **IntelliJ IDEA**에서 **Help → Edit Custom Properties...**를 열고 아래 줄을 붙여넣은 후, 메시지가 나타나면 IDE를 다시 시작합니다:
 
@@ -50,6 +50,7 @@
 
 ## Ключевые особенности
 
+- **Независимый клиент** — Не форк Telegram для Android. MonoGram написан полностью с нуля как самостоятельный проект.
 - **Material Design 3** — Красивый, адаптивный интерфейс, который отлично смотрится на телефонах, планшетах и складных устройствах.
 - **Безопасность** — Встроенная биометрическая блокировка и зашифрованное локальное хранилище.
 - **Мультимедиа** — Высокопроизводительное воспроизведение медиа с ExoPlayer и Coil 3.
@@ -72,7 +73,7 @@
 ### 1. Клонирование репозитория
 
 ```bash
-git clone https://github.com/monogram-android/monogram.git
+git clone --recurse-submodules https://github.com/monogram-android/monogram.git
 cd monogram
 ```
 
@@ -105,7 +106,15 @@ API_HASH=your_api_hash_here
 10. Нажмите **Update** рядом с разделом FCM credentials.
 11. Загрузите JSON сервисного аккаунта на открывшейся странице.
 
-### 4. Сборка и запуск
+### 4. Первичная настройка: сборка libvpx
+
+Для анимаций требуется собрать libvpx. Это нужно сделать до запуска сборки Gradle, иначе сборка завершится с ошибками.
+
+1. Перейдите в директорию `presentation/src/main/cpp`
+2. В `build.sh` укажите ваш `ANDROID_NDK_HOME`
+3. Запустите `build.sh` и дождитесь завершения
+
+### 5. Сборка и запуск
 
 1. Откройте проект в **Android Studio**.
 2. Увеличьте лимиты индексации IDE, чтобы `TdApi.java` (обёртка над TDLib) корректно индексировался. В **Android Studio** или **IntelliJ IDEA** откройте **Help → Edit Custom Properties...**, вставьте строки ниже и при необходимости перезапустите IDE:
 
@@ -50,6 +50,7 @@
 
 ## اہم خصوصیات
 
+- **آزاد کلائنٹ (Independent Client)** — یہ Telegram for Android کا فورک نہیں ہے۔ MonoGram ایک مکمل طور پر نئے سرے سے بنایا گیا آزاد پروجیکٹ ہے۔
 - **Material Design 3** — ایک خوبصورت، موافق (adaptive) UI جو فونز، ٹیبلیٹس، اور فولڈ ایبلز پر بہترین نظر آتا ہے۔
 - **محفوظ (Secure)** — بائیو میٹرک لاکنگ اور انکرپٹڈ لوکل اسٹوریج شامل ہے۔
 - **میڈیا سے بھرپور (Media Rich)** — ExoPlayer اور Coil 3 کے ساتھ اعلیٰ کارکردگی والا میڈیا پلے بیک۔
@@ -72,7 +73,7 @@
 ### 1. ریپوزٹری کلون کریں
 
 ```bash
-git clone https://github.com/monogram-android/monogram.git
+git clone --recurse-submodules https://github.com/monogram-android/monogram.git
 cd monogram
 ```
 
@@ -105,7 +106,15 @@ API_HASH=your_api_hash_here
 10. FCM اسناد والے سیکشن کے آگے **Update** پر کلک کریں۔
 11. کھلنے والے پیج پر سروس اکاؤنٹ JSON اپ لوڈ کریں۔
 
-### 4. بلڈ اور رن
+### 4. پہلی مرتبہ سیٹ اپ: libvpx کی تعمیر
+
+اینیمیشنز کے لیے libvpx کو کمپائل کرنا ضروری ہے۔ یہ کام Gradle بلڈ شروع کرنے سے پہلے کرنا ہوگا، ورنہ بلڈ ناکام ہو سکتی ہے۔
+
+1. اپنی ورکنگ ڈائرکٹری `presentation/src/main/cpp` پر لے جائیں۔
+2. `build.sh` میں اپنا `ANDROID_NDK_HOME` شامل کریں۔
+3. `build.sh` چلائیں اور مکمل ہونے تک انتظار کریں۔
+
+### 5. بلڈ اور رن
 
 1. **Android Studio** میں پروجیکٹ کھولیں۔
 2. IDE کی انڈیکسنگ کی حد میں اضافہ کریں تاکہ `TdApi.java` (TDLib ریپر) صحیح طرح انڈیکس ہو سکے۔ **Android Studio** یا **IntelliJ IDEA** میں، **Help → Edit Custom Properties...** کھولیں، نیچے دی گئی لائنز پیسٹ کریں، اور اگر کہا جائے تو IDE کو ری اسٹارٹ کریں: