The third-party Telegram android app.

Overview

NekoX

NekoX is an free and open source third-party Telegram client, based on Telegram-FOSS with features added.

Get it on F-Droid

We are no longer able to update versions on the Play Store, check https://telegra.ph/So-they-solved-the-person-who-asked-the-question-04-28 .

NekoX Changes

  • Most of Nekogram's features
  • Unlimited login accounts
  • OpenCC Chinese Convert
  • Built-in VMess, Shadowsocks, SSR, Trojan-GFW proxies support
  • Built-in public proxy list / 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
  • Built-in WebSocket relay support (Connect via Cloudflare CDN)
  • Allow auto-disabling proxy when VPN is enabled
  • Proxy automatic switcher
  • Add stickers without sticker pack
  • Allow disabling vibration
  • Allow clicking on links in self profile
  • Sticker set list backup / restore / share
  • Full InstantView translation support
  • Translation support for selected text on input and in messages
  • Delete all messages in group
  • Dialog sorting is optional "Unread and can be prioritized for reminding" etc
  • Allow to skip "regret within five seconds"
  • Unblock all users support
  • Login via QR code
  • Scan and confirm the login QR code directly
  • Allow clearing app data
  • 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).
  • OpenKeychain client (sign / verify / decrypt / import)
  • Google Cloud Translate / Yandex.Translate support
  • Custom cache directory (supports external storage)
  • Custom app ID and Hash (optional NekoX / Android / Android X or Manual input)
  • Custom server (official, test DC)
  • Keep the original file name when downloading files
  • View the data center you belong to when you don't have an avatar
  • Proxies, groups, channels, sticker packs are able to shared as QR codes
  • Force English emoji keywords to be loaded
  • Add "@Name" when long-pressing @user option
  • Enhanced notification service, optional version without Google Services
  • Don't alert "Proxy unavailable" for non-current account
  • Option to block others from starting a secret chat with you
  • Allow creation of group without invite
  • Option to upgrade group to supergroup
  • Mark dialogs as read using tab menu
  • Improved session dialog
  • Improved link long click menu
  • Improved hide messages from blocked users feature
  • Text replacer
  • Persian calendar support
  • Option to disable trending
  • Telegram X style menu for unpinning messages
  • Built-in Material Design themes / Telegram X style icons
  • Enabled set auto delete timer option for private chats and private groups
  • Don't process cleanup draft events after opening chat
  • Support saving multiple selected messages to Saved Messages
  • Support unpinning multiple selected messages
  • View stats option for messages
  • And more :)

Compilation Guide

NOTE: Building on Windows is, unfortunately, not supported. Consider using a Linux VM or dual booting.

Important:

  1. Install Android SDK and NDK (default location is $HOME/Android/SDK, otherwise you need to specify $ANDROID_HOME for it)

It is recommended to use AndroidStudio to install.

  1. Install golang ( 1.16 ).
# debian sid
apt install -y golang-1.16
  1. Install Rust and its stdlib for Android ABIs, and add environment variables for it.

It is recommended to use the official script, otherwise you may not find rustup.

> $HOME/.bashrc && source $HOME/.cargo/env rustup install $(cat ss-rust/src/main/rust/shadowsocks-rust/rust-toolchain) rustup default $(cat ss-rust/src/main/rust/shadowsocks-rust/rust-toolchain) rustup target install armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android ">
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --default-toolchain none -y
echo "source \$HOME/.cargo/env" >> $HOME/.bashrc && source $HOME/.cargo/env

rustup install $(cat ss-rust/src/main/rust/shadowsocks-rust/rust-toolchain)
rustup default $(cat ss-rust/src/main/rust/shadowsocks-rust/rust-toolchain)
rustup target install armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android
  1. Build native dependencies: ./run init libs
  2. Build external libraries and native code: ./run libs update
  3. Fill out TELEGRAM_APP_ID and TELEGRAM_APP_HASH in local.properties
  4. Replace TMessagesProj/google-services.json if you want fcm to work.
  5. Replace release.keystore with yours and fill out ALIAS_NAME, KEYSTORE_PASS and ALIAS_PASS in local.properties if you want a custom sign key.

./gradlew assemble

FAQ

What is the differences between NekoX and Nekogram?

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

What is the difference between the Full and Mini version?

The full version comes with built-in proxy support for v2ray, shadowsocks, shadowsocksr, and trojan, which is usually provided to advanced users to help friends who have no computer knowledge in mainland China to bypass censorship. Don't complain about imperfect functions or ask to add other rare proxy types, you can use their clients directly.

What if I don't need a proxy?

Then it is recommended to use the Mini version.

What is the noGcm version?

Google Cloud Messaging, also known as gcm / fcm, message push service by google used by original Telegram android app, it requires your device to have Google Service Framework (non-free) installed.

I've encountered a bug!

First, make sure you have the latest version installed (check the channel, Play store versions usually have a delay).

Then, if the issue appears in the official Telegram client too, please submit it to the officials, (be careful not to show NekoX in the description and screenshots, the official developers doesn't like us!).

Then, please detail your issue, create an issue or submit it to our group with #bug.

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

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

Translation status

Adding a new language

First and foremost, Android must already support the specific language and locale you want to add. We cannot work with languages that Android and the SDK do not support, the tools simply break down. Next, if you are considering adding a country-specific variant of a language (e.g. de-AT), first make sure that the main language is well maintained (e.g. de). Your contribution might be useful to more people if you contribute to the existing version of your language rather than the country-specific variant.

Anyone can create a new language via Weblate.

Adding unofficial translations for Telegram

Current built-in language packs:

You can open an issue to request to amend the built-in translation.

Credits

Comments
  • Add fdroidRelease build type

    Add fdroidRelease build type

    Since we (fdroid) don't have much capacity to manually update apps, and I've observed that you are not updating NekoX in fdroid manually actively, it's reasonable to enable full auto update by providing a universal APK

    opened by proletarius101 19
  • Pgp encryption

    Pgp encryption

    Is your feature request related to a problem? Please describe. Since pgp is implemented in would like to encrypt messages too.

    Describe the solution you'd like Maybe add another checkbox for "encrypt message"

    enhancement 
    opened by anon97945 13
  • v8.8.5-preview01 - the app freezes after passing PIN check

    v8.8.5-preview01 - the app freezes after passing PIN check

    Describe the bug After update v8.8.5-preview01 I cannot use the app: it asks for fingerprint/PIN at start and then freezes

    To Reproduce Steps to reproduce the behavior:

    1. Update on 1rm64 (full with GCM) from 8.7.4 to v8.8.5-preview01
    2. Start the app and try to open account

    Logcat Cannot use logcat as the application does not start.

    Expected behavior It should open my account after passing PIN check.

    Smartphone (please complete the following information):

    • Device: OnePlus 7T Pro
    • OS: Android 11
    • Version v8.8.5-preview01

    Additional context Maybe it is caused I have >5 active accounts in client?

    opened by gjf 10
  • Persian Jalali Date Picker

    Persian Jalali Date Picker

    There's a growing community of Iranian people using Nekogram X. A custom telegram date format (converted gregorian date to jalali date) matching the local Iran calendar would be an amazing addition. This feature is requested by the Iranian Nekogram X community. Here is a sample of a calendar switch button implemented in a closed source local unofficial telegram:

    IMG_20200715_235629_743

    enhancement 
    opened by JohnSmit268 10
  • Unable to join community through mobile app

    Unable to join community through mobile app

    Describe the bug Unable to join community through mobile app... It's telling to leave groups or channel, after leaving more than one group/channel could not be able to join community

    To Reproduce Steps to reproduce the behavior:

    1. Go for a channel
    2. While trying to click on join its shows error
    3. Screen shot attached

    Logcat Settings - click version - "Enable Log", then click "Send Logs" to @NekoXChat or just upload at issue.

    Expected behavior Should be able to join a community

    Screenshots If applicable, add screenshots to help explain your problem.

    Smartphone (please complete the following information):

    • Device: MI11X
    • OS: Android 12
    • Version
      Screenshot_20220311-234222 Nekogram X v8.5.4-play arm64-v8a miniPlay release Additional context Add any other context about the problem here.
    opened by Jafhus 7
  • Wrong message quoted in Replies chat

    Wrong message quoted in Replies chat

    Describe the bug Messages from comment threads in the Replies chat are posted with the incorrect quote, with the quoted messages being from an entirely different chat. Screencaps posted below, first is from the vanilla Telegram app, which is what it should look like. Second screencap is from NekoX. "A S" is my account, the messages quoted from Robert are from a DM I have open with that person.

    To Reproduce Steps to reproduce the behavior:

    1. Comment on a channel's post
    2. wait for other user to reply to comment
    3. View comment in Replies chat.

    Logcat Uploaded at issue. NekoX-1632636155445.log

    Screenshots If applicable, add screenshots to help explain your problem. Screenshot_20210925-062227_Telegram Screenshot_20210925-062332_Nekogram_X_1

    Smartphone (please complete the following information):

    • Device: OnePlus 9 Pro
    • OS: LineageOS 18.1 Android11
    • Version 18.1-20210917-microG-lemonadep

    Additional context Add any other context about the problem here.

    opened by asorel1942 7
  • 直接分享增加发送到收藏夹

    直接分享增加发送到收藏夹

    经常用 Telegram 来收藏东西,方便 PC 和手机互通而不依赖特定浏览器插件,但官方版 Telegram 不支持在安卓的“直接分享”列表里显示收藏夹作为目标,只会显示几个最近联系人,要发送到收藏必须从下方应用列表中选择 Telegram 再选择收藏夹作为目标,比较麻烦,希望 NekoX 能支持这个功能。

    opened by UnderCooled 7
  • app doesnt start after update

    app doesnt start after update

    just installed Version 7.7.2-armeabi-v7a via f-droid over recent version. new version wont start/open. rebooting wont help.

    Logcat have one, cannot send nor attach here. Settings - click version - "Enable Log", then click "Send Logs" to @NekoXChat or just upload at issue.

    Expected behavior app should open

    Screenshots If applicable, add screenshots to help explain your problem.

    Smartphone (please complete the following information):

    • Device: poco x3nfc
    • OS: [ Android11 crdroid]
    • Version [7.4]

    Additional context Add any other context about the problem here.

    opened by R44D44 7
  • Translations on Weblate were nuked

    Translations on Weblate were nuked

    Someone with the nickname assnekox modified all source and translation strings to the term assnekox.

    All the translations were removed except for several correct ones.

    opened by yarons 6
  • f-droid vs github apk

    f-droid vs github apk

    what's the difference between the f-droid build ? is it more foss than the github one ? (talking about features not how fdroid's signing and building is different)

    opened by bingoxo 6
  • Nekogram X disappear on Play Store

    Nekogram X disappear on Play Store

    Describe the bug A clear and concise description of what the bug is.

    To Reproduce Steps to reproduce the behavior:

    1. Go to https://play.google.com/store/apps/details?id=nekox.messenger
    2. Then its Not found

    Logcat Settings - click version - "Enable Log", then click "Send Logs" to @NekoXChat or just upload at issue.

    Expected behavior Its appear on play store

    Screenshots If applicable, add screenshots to help explain your problem.

    Smartphone (please complete the following information):

    • Device: [Poco F3]
    • OS: [Android 12]
    • Version [-]

    Additional context Add any other context about the problem here.

    opened by cyberboh 5
  • Some GIFs wont play (HD GIF not supported?)

    Some GIFs wont play (HD GIF not supported?)

    Describe the bug A clear and concise description of what the bug is. Some (large?) GIFs wont play.

    To Reproduce Steps to reproduce the behavior:

    1. Go to @SpoilMEdiaBot
    2. Click on "Start"
    3. Bot sends a large (HD) GIF
    4. GIF wont play, can be saved and re-sent but won't preview (animated) and wont play anywhere

    Expected behavior HD GIFs should play as any other GIF

    opened by TrashAccount3424 0
  • Disable title bar decoration

    Disable title bar decoration

    Is your feature request related to a problem? Please describe. I would prefer to remove the falling snow in the title bar as I find the animation distracting.

    Describe the solution you'd like There is a setting "title bar decoration" with 3 options. Please can we add a 4th option "none"?

    Describe alternatives you've considered All of the existing options lead to some animation.

    Additional context

    opened by AdamPS 0
  • Option to ignore messages from blocked users disappeared

    Option to ignore messages from blocked users disappeared

    Steps to reproduce the behavior:

    1. Go to NekoSettings In the last version of the app from F-Droid 8.7.4 there is a lack of option to ignore messages from blocked users. Option exists in 8.2.7-rc03

    photo_2022-12-31_02-42-28 photo_2022-12-31_02-43-14

    opened by borismavrin 2
  • Hide

    Hide "All Chats" tab option bug

    When enabled this option, "All Chat" tab will surely be hided, but the first chat forder's contents will be replaced by "All Chat" tab's contents. Switch to any other folder and back will correct it.

    This occurs when I open the application from launcher everytime.

    Tested on v9.1.6-preview01-17546df4 and v8.9.3-preview01.

    opened by rizutazu 1
  • add timeline

    add timeline

    It would be great to just put a timeline for the channel part. We want to get the latest proxies from different channels based on time on the timeline. Let's not go through the channels one by one. and the option to select which channel shows up on the timeline thanks

    opened by 3000vps 0
Releases(v8.9.3-preview01)
Owner
NekoX Dev
NekoX Dev
Third-party native Jellyfin Android app

Findroid Findroid is third-party Android application for Jellyfin that provides a native user interface to browse and play movies and series. I am dev

Jarne Demeulemeester 513 Jan 1, 2023
Let third-party launcher always get themed icon in MIUI (Maybe also works for other Android based OS).

English 简体中文 Introduction This module can let third party launcher always use icons with MIUI/Flyme Themes. It may also work with other custom Android

Strawing 5 Sep 18, 2022
Force enable gesture for third-party launcher in MIUI.

Fuck MIUI Gesture English Brief Enable this module to allow setting system gesture as nagation when using third party launcher. Strong Mode: Force usi

null 15 Dec 25, 2022
A simple party manager app

Party App ?? Android native app using Kotlin to manage parties ?? Status: Under development ?? How to use The backend of this project can be founded h

Ítalo Sérvio 1 Dec 2, 2021
Share your minecraft-adventure with your friends in nation-party.

Nation Party Make your adventure as shared with your friends and family in Nation Party. Features * Create your own party with your own name; * Invite

Luiz Otávio 1 Jan 9, 2022
Telegram messenger for Android

Telegram messenger for Android Telegram is a messaging app with a focus on speed and security. It’s superfast, simple and free. This repo contains the

DrKLO 21.3k Jan 1, 2023
Re - Redirect outgoing calls to Signal or Telegram

Re Redirect outgoing calls to Signal or Telegram. Tiny app to redirect outgoing

lucky 26 Oct 8, 2022
Redirect outgoing calls to Signal/Telegram/Threema.

Red Redirect outgoing calls to Signal/Telegram/Threema. Tiny app to redirect outgoing calls to Signal/Telegram/Threema if available. You can cancel re

lucky 26 Oct 8, 2022
A lightweight, feature-rich wrapper for the Telegram Bot API, providing a handy Kotlin DSL to quickly build your bot.

Kotlin Telegram Bot Kotlin based wrapper over Telegram API. Current version of the Telegram Api: 6.0 Principles Annotations Magic. The basic interacti

Jey 61 Dec 27, 2022
Bringing webhooks into Telegram. Push messages to chats via URL with a simple API.

Webhooks over Telegram (WoT) WoT aims to provide a simple API for registering webhooks and sending messages to Telegram chats via them using a single

d1s utils 2 Oct 5, 2022
A repository that contains various examples of how to use the telegram-bot library.

Telegram-bot templates This repository contains simple different examples of how to use the telegram-bot library. How to use All the examples are conv

Jey 3 Nov 15, 2022
Simple Telegram bot that responds with list of results obtained from Google.

Simple project focused on learning a little more about how Telegram bots work and are created. The bot has a very basic functionality: the user types

Jesus Ericks 3 Nov 13, 2022
Food Recipe App is an app for collecting most of food recipe in one app

Food Recipe App is an app for collecting most of food recipe in one app

Heba Elsaid 10 Dec 25, 2022
Arjun Naik 1 Apr 16, 2022
Ride-Sharing Uber Lyft Android App - Learn to build a ride-sharing Android Taxi Clone App like Uber, Lyft - Open-Source Project By MindOrks

Ride-Sharing Uber Lyft Android App - Learn to build a ride-sharing Android Taxi Clone App like Uber, Lyft - Open-Source Project By MindOrks

MindOrks 1.2k Dec 29, 2022
Android-basics-kotlin-tip-time-app - Tip Time app from Android Basics in Kotlin

Tip Time Tip Time app from Android Basics in Kotlin at developers.google.com. It

Ramon Lima e Meira 0 Jan 2, 2022
Environmental-Monitoring-Android-App - This Android App is used to monitor environmental parameters data from remote sensors

Environmental-Monitoring-Android-App - This Android App is used to monitor environmental parameters data from remote sensors. Parameters includes but not limited to temperature, humidity, air quality, level of Ionizing radiation, ...

Francisco Pascal Elias TAMBASAFIDY 0 Jan 4, 2022
Library to change Android launcher App Icon and App Name programmatically !

AppIconNameChanger Change Android App launcher Icon and App Name programmatically ! Download Demo APK from HERE Kindly use the following links to use

Prabhakar Thota 587 Dec 29, 2022
HideDroid is an Android app that allows the per-app anonymization of collected personal data according to a privacy level chosen by the user.

HideDroid An Android App for preserving user privacy HideDroid is an Android app that allows the per-app anonymization of collected personal data acco

null 100 Dec 12, 2022