Nagram

Nagram is a third-party Telegram client based on NekoX with some modifications.

• Official Site: https://nagram.app
• Channel: https://t.me/nagram_channel
• Assets: https://t.me/nagram_assets
• Releases: https://github.com/NextAlone/Nagram/releases
• Issues here: https://t.me/na_gram_reports/18

Branding

Nagram's source code is licensed under GPLv3. The Nagram name and project identity belong to @NextAlone; the Nagram application icon artwork is copyright © MaitungTM. These are separate brand assets. Modified, forked, and third-party distributions must use distinct branding and replace the Nagram brand assets. See BRANDING.md for the complete policy.

Additional feature over Nagram

1. Nice icon (copyright © MaitungTM)
2. Combine message
3. Editable text style
4. Forced copy
5. Invert reply
6. Quick reply in longClick menu (thanks to @blxueya)
7. Undo and Redo
8. Scrollable chat preview (thanks to TeleTux)
9. Noise suppress and voice enhance (thanks to )

---

NekoX Changes

• Most of Nekogram's features
• Unlimited login accounts
• Proxy
  • Built-in VMess, Shadowsocks, SSR, Trojan-GFW proxies support (No longer maintained)
  • Built-in public proxy (WebSocket relay via Cloudflare CDN), documentation and for PC
  • Proxy subscription support
  • Ipv6 MTProxy support
  • Able to parse all proxy subscription format: SIP008, ssr, v2rayN, vmess1, shit ios app formats, clash config and more
  • Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc
  • Scan the QR code (any link, can add a proxy)
  • The ( vmess / vmess1 / ss / ssr / trojan ) proxy link in the message can be clicked
  • Allow auto-disabling proxy when VPN is enabled
  • Proxy automatic switcher
  • Don't alert "Proxy unavailable" for non-current account
• Stickers
  • Custom Emoji packs
  • Add stickers without sticker pack
  • Sticker set list backup / restore / share
• Internationalization
  • OpenCC Chinese Convert
  • Full InstantView translation support
  • Translation support for selected text on input and in messages
  • Google Cloud Translate / Yandex.Translate support
  • Force English emoji keywords to be loaded
  • Persian calendar support
• Additional Options
  • Option to disable vibration
  • Dialog sorting is optional "Unread and can be prioritized for reminding" etc
  • Option to skip "regret within five seconds"
  • Option to not send comment first when forwarding
  • Option to use nekox chat input menu: replace record button with a menu which contains an switch to control link preview (enabled by default)
  • Option to disable link preview by default: to prevent the server from knowing that the link is shared through Telegram.
  • Option to ignore Android-only content restrictions (except for the Play Store version).
  • Custom cache directory (supports external storage)
  • Custom server (official, test DC)
  • Option to block others from starting a secret chat with you
  • Option to disable trending

API and Protocol documentation

Telegram API manuals: https://core.telegram.org/api

MTProto protocol manuals: https://core.telegram.org/mtproto

Compilation Guide

NOTE: For Windows users, please consider using a Linux VM (such as WSL2) or dual booting.

Environment:

• Linux distribution based on Debian or Arch Linux, or macOS

• Native tools: gcc go make cmake ninja yasm

  # for Debian based distribution
  sudo apt install gcc golang make cmake ninja-build yasm
  # for Arch Linux based distribution
  sudo pacman -S base-devel go ninja cmake yasm
  # for macOS
  xcode-select --install # install developer tools (will open confirm dialog)
  brew install go cmake ninja yasm # install other tools by homebrew
  

• 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)

  It is recommended to use Android Studio to install, but you can also use sdkmanager command on distributions based on Debian:

  sudo apt install sdkmanager
  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"
  

Build:

1. Checkout submodules

   git submodule update --init --recursive
   

2. Disable signature check by removing the following lines in TMessagesProj/jni/jni.c:

    if (verifySign(env) != JNI_OK) {
        return JNI_ERR;
    }
   

3. Build external libraries and native code:

   ./run init libs
   ./run libs native
   

4. Fill out TELEGRAM_APP_ID and TELEGRAM_APP_HASH in local.properties (from Telegram Developer)

5. Replace TMessagesProj/google-services.json if you want FCM to work.

6. Replace release.keystore with yours and fill out ALIAS_NAME, KEYSTORE_PASS and ALIAS_PASS in local.properties.

7. Build with Gradle:

   ./gradlew assemble<Release/Debug>
   

---

Compilation with GitHub Action

1. Create your own release.keystore to replace TMessagesProj/release.keystore.

2. Prepare LOCAL_PROPERTIES

• KEYSTORE_PASS: from your keystore
• ALIAS_NAME: from your keystore
• ALIAS_PASS: from your keystore
• TELEGRAM_APP_ID: from Telegram Developer
• TELEGRAM_APP_HASH: from Telegram Developer

KEYSTORE_PASS=123456
ALIAS_NAME=key0
ALIAS_PASS=123456
TELEGRAM_APP_ID=123456
TELEGRAM_APP_HASH=abcdefg

Then, use base64 to encode the above.

3. Add Repo Action Secrets

• LOCAL_PROPERTIES: from step 2

• HELPER_BOT_TOKEN: from telegram @Botfather, such as 1111:abcd; the bot that keeps the in-app update metadata

• NAGRAM_CHANNEL_BOT_TOKEN, NAGRAM_API_ID, NAGRAM_API_HASH: the bot that posts the builds to the channels, and the Telegram API credentials its Bot API server runs with

  The channels are repository variables: NAGRAM_CHANNEL_ASSETS_CHAT_ID gets every build, NAGRAM_CHANNEL_CHAT_ID gets a copy of the releases. Nothing is posted while the token or the channels are not set. A release needs its notes in docs/releases/<version code>.md, with optional English notes in <version code>.en.md.

  The GitLab pipeline posts to its own channel instead, with the HELPER_BOT_TARGET CI/CD variable holding the chat id, such as -1001234567890.

4. Disable signature check by removing the following lines in TMessagesProj/jni/jni.c:

    if (verifySign(env) != JNI_OK) {
        return JNI_ERR;
    }
   

5. Run Release Build

FAQ

What is the differences between Nagram, NekoX and Nekogram?

Developed by different developers, read the feature list above to understand the differences.

I've encountered a bug!

First, make sure you have the latest version installed (check the channel).

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).

Then, submit it to our bot.

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.

Localization

Nagram is forked from Telegram, thus most locales follows the translations of Telegram for Android, checkout https://translations.telegram.org/en/android/.

Is Nagram not in your language, or the translation is incorrect or incomplete? Get involved in the translations on our Weblate.

Thanks

• NekoX
• Nekogram
• Pigeongram
• Nullgram
• TeleTux
• OwlGram