| - Official Site: <https://nagram.app> |
| 6 | - Telegram Update Channel: <https://t.me/nagram_channel> |
| 7 | - Releases: <https://github.com/NextAlone/Nagram/releases> |
| 8 | - Issues here: <https://t.me/na_gram_reports/18> |
| 9 |
| 10 | ## Branding |
| 11 |
| 12 | Nagram's source code is licensed under GPLv3. The Nagram name and project |
| 13 | identity belong to [@NextAlone](https://github.com/NextAlone); the Nagram |
| 14 | application icon artwork is copyright © MaitungTM. These are separate brand |
| 15 | assets. Modified, forked, and third-party distributions must use distinct |
| 16 | branding and replace the Nagram brand assets. See [BRANDING.md](BRANDING.md) |
| 17 | for the complete policy. |
| 18 |
| 19 | ## Additional feature over Nagram |
| 20 |
| 21 | 1. Nice icon (copyright © MaitungTM) |
| 22 | 2. Combine message |
| 23 | 3. Editable text style |
| 24 | 4. Forced copy |
| 25 | 5. Invert reply |
| 26 | 6. Quick reply in longClick menu (thanks to @blxueya) |
| 27 | 7. Undo and Redo |
| 28 | 8. Scrollable chat preview (thanks to TeleTux) |
| 29 | 9. Noise suppress and voice enhance (thanks to ) |
| 30 |
| 31 | ---- |
| 32 |
| 33 | ## NekoX Changes |
| 34 |
| 35 | - Most of Nekogram's features |
| 36 | - Unlimited login accounts |
| 37 | - **Proxy** |
| 38 | - Built-in VMess, Shadowsocks, SSR, Trojan-GFW proxies support (No longer maintained) |
| 39 | - Built-in public proxy (WebSocket relay via Cloudflare CDN), [documentation and for PC](https://github.com/arm64v8a/NekoXProxy) |
| 40 | - Proxy subscription support |
| 41 | - Ipv6 MTProxy support |
| 42 | - Able to parse all proxy subscription format: SIP008, ssr, v2rayN, vmess1, shit ios app formats, clash config and more |
| 43 | - Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc |
| 44 | - Scan the QR code (any link, can add a proxy) |
| 45 | - The ( vmess / vmess1 / ss / ssr / trojan ) proxy link in the message can be clicked |
| 46 | - Allow auto-disabling proxy when VPN is enabled |
| 47 | - Proxy automatic switcher |
| 48 | - Don't alert "Proxy unavailable" for non-current account |
| 49 | - **Stickers** |
| 50 | - Custom [Emoji packs](https://web.archive.org/web/20221126140435/https://github.com/NekoX-Dev/NekoX/wiki/emoji) |
| 51 | - Add stickers without sticker pack |
| 52 | - Sticker set list backup / restore / share |
| 53 | - **Internationalization** |
| 54 | - OpenCC Chinese Convert |
| 55 | - Full InstantView translation support |
| 56 | - Translation support for selected text on input and in messages |
| 57 | - Google Cloud Translate / Yandex.Translate support |
| 58 | - Force English emoji keywords to be loaded |
| 59 | - Persian calendar support |
| 60 | - **Additional Options** |
| 61 | - Option to disable vibration |
| 62 | - Dialog sorting is optional "Unread and can be prioritized for reminding" etc |
| 63 | - Option to skip "regret within five seconds" |
| 64 | - Option to not send comment first when forwarding |
| 65 | - Option to use nekox chat input menu: replace record button with a menu which contains an switch to control link preview (enabled by default) |
| 66 | - Option to disable link preview by default: to prevent the server from knowing that the link is shared through Telegram. |
| 67 | - Option to ignore Android-only content restrictions (except for the Play Store version). |
| 68 | - Custom cache directory (supports external storage) |
| 69 | - Custom server (official, test DC) |
| 70 | - Option to block others from starting a secret chat with you |
| 71 | - Option to disable trending |
| 72 | - **Additional Actions** |
| 73 | - Allow clicking on links in self profile |
| 74 | - Delete all messages in group |
| 75 | - Unblock all users support |
| 76 | - Login via QR code |
| 77 | - Scan and confirm the login QR code directly |
| 78 | - Allow clearing app data |
| 79 | - Proxies, groups, channels, sticker packs are able to be shared as QR codes |
| 80 | - Add "@Name" when long-pressing @user option |
| 81 | - Allow creating a group without inviting anyone |
| 82 | - Allow upgrading a group to a supergroup |
| 83 | - Mark dialogs as read using tab menu |
| 84 | - Enabled set auto delete timer option for private chats and private groups |
| 85 | - Support saving multiple selected messages to Saved Messages |
| 86 | - Support unpinning multiple selected messages |
| 87 | - View stats option for messages |
| 88 | - **Optimization** |
| 89 | - Keep the original file name when downloading files |
| 90 | - View the data center you belong to when you don't have an avatar |
| 91 | - Enhanced notification service, optional version without Google Services |
| 92 | - Improved session dialog |
| 93 | - Improved link long click menu |
| 94 | - Improved hide messages from blocked users feature |
| 95 | - Don't process cleanup draft events after opening chat |
| 96 | - **Others** |
| 97 | - OpenKeychain client (sign / verify / decrypt / import) |
| 98 | - Text replacer |
| 99 | - **UI** |
| 100 | - Telegram X style menu for unpinning messages |
| 101 | - Built-in Material Design themes / Telegram X style icons |
| 102 | - And more :) |
| 103 |
| 104 | ## API and Protocol documentation |
| 105 |
| 106 | Telegram API manuals: <https://core.telegram.org/api> |
| 107 |
| 108 | MTProto protocol manuals: <https://core.telegram.org/mtproto> |
| 109 |
| 110 | ## Compilation Guide |
| 111 |
| 112 | **NOTE: For Windows users, please consider using a Linux VM (such as WSL2) or dual booting.** |
| 113 |
| 114 | Environment: |
| 115 |
| 116 | - Linux distribution based on Debian or Arch Linux, or macOS |
| 117 |
| 118 | - Native tools: `gcc` `go` `make` `cmake` `ninja` `yasm` |
| 119 |
| 120 | ```shell |
| 121 | # for Debian based distribution |
| 122 | sudo apt install gcc golang make cmake ninja-build yasm |
| 123 | # for Arch Linux based distribution |
| 124 | sudo pacman -S base-devel go ninja cmake yasm |
| 125 | # for macOS |
| 126 | xcode-select --install # install developer tools (will open confirm dialog) |
| 127 | brew install go cmake ninja yasm # install other tools by homebrew |
| 128 | ``` |
| 129 | - Android SDK: `build-tools;33.0.0` `platforms;android-33` `ndk;27.2.12479018` `cmake;3.18.1` `cmake;3.22.1` (the default location is **$HOME/Android/SDK**, otherwise you need to specify **$ANDROID_HOME** for it) |
| 130 |
| 131 | It is recommended to use [Android Studio](https://developer.android.com/studio) to install, but you can also use `sdkmanager` command on distributions based on Debian: |
| 132 |
| 133 | ```shell |
| 134 | sudo apt install sdkmanager |
| 135 | sdkmanager --sdk_root $HOME/Android/SDK --install "build-tools;33.0.0" "platforms;android-33" "ndk;27.2.12479018" "cmake;3.18.1" "cmake;3.22.1" |
| 136 | ``` |
| 137 |
| 138 | Build: |
| 139 |
| 140 | 1. Checkout submodules |
| 141 |
| 142 | ```shell |
| 143 | git submodule update --init --recursive |
| 144 | ``` |
| 145 |
| 146 | 2. Disable signature check by removing the following lines in **TMessagesProj/jni/jni.c**: |
| 147 | ```c |
| 148 | if (verifySign(env) != JNI_OK) { |
| 149 | return JNI_ERR; |
| 150 | } |
| 151 | ``` |
| 152 |
| 153 | 3. Build external libraries and native code: |
| 154 | ```shell |
| 155 | ./run libs native |
| 156 | ``` |
| 157 |
| 158 | 4. Fill out `TELEGRAM_APP_ID` and `TELEGRAM_APP_HASH` in **local.properties** (from [Telegram Developer](https://my.telegram.org/auth)) |
| 159 |
| 160 | 5. Replace **TMessagesProj/google-services.json** if you want FCM to work. |
| 161 |
| 162 | 6. Replace **release.keystore** with yours and fill out `ALIAS_NAME`, `KEYSTORE_PASS` and `ALIAS_PASS` in **local.properties**. |
| 163 |
| 164 | 7. Build with Gradle: |
| 165 |
| 166 | ```shell |
| 167 | ./gradlew assemble<Release/Debug> |
| 168 | ``` |
| 169 |
| 170 | ---- |
| 171 |
| 172 | ## Compilation with GitHub Action |
| 173 |
| 174 | 1. Create your own `release.keystore` to replace `TMessagesProj/release.keystore`. |
| 175 |
| 176 | 2. Prepare LOCAL_PROPERTIES |
| 177 |
| 178 | - KEYSTORE_PASS: from your keystore |
| 179 | - ALIAS_NAME: from your keystore |
| 180 | - ALIAS_PASS: from your keystore |
| 181 | - TELEGRAM_APP_ID: from [Telegram Developer](https://my.telegram.org/auth) |
| 182 | - TELEGRAM_APP_HASH: from [Telegram Developer](https://my.telegram.org/auth) |
| 183 |
| 184 | ```env |
| 185 | KEYSTORE_PASS=123456 |
| 186 | ALIAS_NAME=key0 |
| 187 | ALIAS_PASS=123456 |
| 188 | TELEGRAM_APP_ID=123456 |
| 189 | TELEGRAM_APP_HASH=abcdefg |
| 190 | ``` |
| 191 |
| 192 | Then, use base64 to encode the above. |
| 193 |
| 194 | 3. Add Repo Action Secrets |
| 195 |
| 196 | - LOCAL_PROPERTIES: from step 2 |
| 197 | - HELPER_BOT_TOKEN: from telegram [@Botfather](https://t.me/Botfather), such as `1111:abcd` |
| 198 | - HELPER_BOT_TARGET: from telegram chat id, such as `777000` |
| 199 |
| 200 | 4. Disable signature check by removing the following lines in **TMessagesProj/jni/jni.c**: |
| 201 | ```c |
| 202 | if (verifySign(env) != JNI_OK) { |
| 203 | return JNI_ERR; |
| 204 | } |
| 205 | ``` |
| 206 |
| 207 | 5. Run Release Build |
| 208 |
| 209 | ## FAQ |
| 210 |
| 211 | #### What is the differences between Nagram, NekoX and Nekogram? |
| 212 |
| 213 | Developed by different developers, read the feature list above to understand the differences. |
| 214 |
| 215 | #### I've encountered a bug! |
| 216 |
| 217 | First, make sure you have the latest version installed (check the channel). |
| 218 |
| 219 | Then, if the issue appears in the official Telegram client too, please submit it to the officials, (be careful not to show custom clients in the description and screenshots). |
| 220 |
| 221 | Then, submit it to our [bot](https://t.me/OrIssuesBot). |
| 222 |
| 223 | If you experience a *crash*, you also need to click on the version number at the bottom of the settings and select "Enable Log" and send it to us. |
| 224 |
| 225 | ## Localization |
| 226 |
| 227 | Nagram is forked from Telegram, thus most locales follows the translations of Telegram for Android, checkout <https://translations.telegram.org/en/android/>. |
| 228 |
| 229 | Is Nagram not in your language, or the translation is incorrect or incomplete? Get involved in the translations on our [Weblate](https://xtaolabs.crowdin.com/nagram). |
| 230 |
| 231 | [](https://xtaolabs.crowdin.com/nagram) |
| 232 |
| 233 | ## Thanks |
| 234 |
| 235 | - [NekoX](https://web.archive.org/web/20240306062834/https://github.com/NekoX-Dev/NekoX) |
| 236 | - [Nekogram](https://gitlab.com/Nekogram/Nekogram) |
| 237 | - [Pigeongram](https://gitlab.com/JasonKhew96/Nekogram) |
| 238 | - [Nullgram](https://github.com/qwq233/Nullgram) |
| 239 | - [TeleTux](https://github.com/TeleTux/TeleTux) |
| 240 | - [OwlGram](https://github.com/OwlGramDev/OwlGram) |
| 241 |