Update README

This commit is contained in:
世界 2021-03-05 17:44:33 +08:00
parent a2fb6ad09a
commit e01fe0d361
No known key found for this signature in database
GPG Key ID: CD109927C34A63C4
3 changed files with 128 additions and 83 deletions

View File

@ -0,0 +1,15 @@
---
name: Language builtin request
about: Request to amend the built-in translation
title: ''
labels: ''
assignees: ''
---
**Language (please complete the following information):**
- Language: [e.g. en_US]
- Pack Link: [e.g. https://translations.telegram.org/en/]
**If the language has already been built in, please describe the reason for the replacement:**
e.g. The language pack is no longer maintained / The original meaning is modified

View File

@ -15,46 +15,47 @@ NekoX is an **free and open source** third-party Telegram client, based on Teleg
## NekoX Changes ## NekoX Changes
- Most of Nekogram's features - Most of Nekogram's features
- Max account limit set to 32 - Max account limit set to 16
- OpenCC Chinese Convert - OpenCC Chinese Convert
- Built-in Vmess, Shadowsocks, SSR proxies support - Built-in VMess, Shadowsocks, SSR, Trojan-GFW proxies support
- Built-in public proxy list / Proxy subscription support. - Built-in public proxy list / Proxy subscription support
- Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc. - Able to parse all proxy subscription format: SIP008, ssr, v2rayN, vmess1, shit ios app formats, clash config and more
- Scan the qrcode (any link, can add a proxy). - Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc
- The ( vemss / vmess1 / ss / ssr / rb ) proxy link in the message can be clicked. - Scan the QR code (any link, can add a proxy)
- Allow auto disable proxy when VPN is enabled - 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 - Proxy automatic switcher
- Add stickers without sticker pack - Add stickers without sticker pack
- Allow disable vibration - Allow disabling vibration
- Allow clicking on links in self profile - Allow clicking on links in self profile
- Sticker set list backup / restore / share - Sticker set list backup / restore / share
- Full InstantView translation support - Full InstantView translation support
- Translation support for selected text on input and in messages - Translation support for selected text on input and in messages
- Delete all messages in group - Delete all messages in group
- Dialog sorting is optional "Unread and can be prioritized for reminding" etc. - Dialog sorting is optional "Unread and can be prioritized for reminding" etc
- Allow to skip "regret within five seconds" - Allow to skip "regret within five seconds"
- Unblock all users support - Unblock all users support
- Login via qrcode - Login via QR code
- Scan and confirm the login qrcode directly - Scan and confirm the login QR code directly
- Allow clear application data - Allow clearing app data
- Option to not send comment first when forwarding - Option to not send comment first when forwarding
- 0ption to use nekox chat input menu: replace record button with a menu which contains an switch to control link preview (enabled by default) - 0ption 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 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). - Option to ignore Android-only content restrictions (except for the Play Store version).
- OpenKaychain client ( sign / verify / decrypt / import ) - OpenKaychain client (sign / verify / decrypt / import)
- Google Cloud Translate / Yandex.Translate support - Google Cloud Translate / Yandex.Translate support
- Custom cache directory (supports external storage) - Custom cache directory (supports external storage)
- Custom AppId and Hash (optional NekoX / Andorid / Android X or Manual input) - Custom app ID and Hash (optional NekoX / Andorid / Android X or Manual input)
- Custom server (official, test DC or Manual input) - Custom server (official, test DC)
- Keep the original file name when downloading files - Keep the original file name when downloading files
- View the data center you belong to when you don't have an avatar - View the data center you belong to when you don't have an avatar
- Proxies, groups, channels, sticker packs are able to shared as qrcodes. - Proxies, groups, channels, sticker packs are able to shared as QR codes
- Force English emoji keywords to be loaded - Force English emoji keywords to be loaded
- Add "@Name" when long press @ user option - Add "@Name" when long-pressing @user option
- Enhanced notification service, optional version without Google Services. - Enhanced notification service, optional version without Google Services
- Don't alert "Proxy unavailable" for non-current account - Don't alert "Proxy unavailable" for non-current account
- Option to block others from starting a secret chat with you - Option to block others from starting a secret chat with you
- Allow create group without invite - Allow creation of group without invite
- Option to upgrade group to supergroup - Option to upgrade group to supergroup
- Mark dialogs as read using tab menu - Mark dialogs as read using tab menu
- Option to hide device info - Option to hide device info
@ -62,8 +63,14 @@ NekoX is an **free and open source** third-party Telegram client, based on Teleg
- Improved link long click menu - Improved link long click menu
- Text replacer - Text replacer
- Option to disable trending - Option to disable trending
- Tgx style message unpin menu - Telegram X style menu for unpinning messages
- Built-in Material Design themes / Telegram X style icons - 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 ## Compilation Guide
@ -72,17 +79,17 @@ Consider using a Linux VM or dual booting.**
**Important:** **Important:**
1. Install Android Sdk and NDK ( default location is $HOME/Android/Sdk, otherwise you need to specify $ANDROID_HOME for it ) 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](https://developer.android.com/studio) to install. [here is how to install AndroidStudio](https://developer.android.com/studio/install). It is recommended to use [AndroidStudio](https://developer.android.com/studio) to install.
2. Install golang ( 1.15.8 ). 2. Install golang ( 1.15 ).
```shell ```shell
# debian sid # debian sid
apt install -y golang apt install -y golang
``` ```
3. Install rust and its stdlib for android abis, add environment variables for it. 3. 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. It is recommended to use the official script, otherwise you may not find rustup.
@ -108,9 +115,9 @@ rustup target install armv7-linux-androideabi aarch64-linux-android i686-linux-a
More features, **without** [additional trackers](https://gitlab.com/search?utf8=%E2%9C%93&snippets=false&scope=&repository_ref=master&search=AnalyticsHelper&group_id=10273976&project_id=22804922). More features, **without** [additional trackers](https://gitlab.com/search?utf8=%E2%9C%93&snippets=false&scope=&repository_ref=master&search=AnalyticsHelper&group_id=10273976&project_id=22804922).
#### What is the difference between Full and Mini version? #### What is the difference between the Full and Mini version?
The full version comes with built-in proxy support for v2ray, shadowsocks, and shadowsocksr, 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. 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? #### What if I don't need a proxy?
@ -118,17 +125,35 @@ Then it is recommended to use the `Mini` version.
#### I've encountered a bug! #### I've encountered a bug!
First, make sure you have the latest version installed (check the channel, play store updates usually have a delay). First, make sure you have the latest version installed (check the channel, Play store versions usually have a delay).
Then, if the issue appears on the official telegram as well, please submit it to the officials, ( but be careful not to show NekoX in the description and screenshots, the official developers don't like us! ). 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](https://t.me/NekoXChat) with #bug. Then, please *detail* your issue, create an issue or submit it to our [group](https://t.me/NekoXChat) 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. 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.
#### How can I help with Localization? ## Localization
Join the project at https://hosted.weblate.org/projects/nekox/ Is NekoX not in your language, or the translation is incorrect or incomplete? Get involved in the translations on our [Weblate](https://hosted.weblate.org/engage/nekox/).
[![Translation status](https://hosted.weblate.org/widgets/nekox/-/horizontal-auto.svg)](https://hosted.weblate.org/engage/nekox/)
### 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:
* 简体中文: [moecn](https://translations.telegram.org/moecn)
* 正體中文: [taiwan](https://translations.telegram.org/taiwan)
* 日本語: [ja_raw](https://translations.telegram.org/ja_raw)
You can [open an issue to](https://github.com/NekoX-Dev/NekoX/issues/new?&template=language_request.md) request to amend the built-in translation.
## Credits ## Credits
@ -144,5 +169,3 @@ Join the project at https://hosted.weblate.org/projects/nekox/
<li>opencc-data: <a href="https://github.com/nk2028/opencc-data">Apache License 2.0</a></li> <li>opencc-data: <a href="https://github.com/nk2028/opencc-data">Apache License 2.0</a></li>
<li>android-device-list: <a href="https://github.com/pbakondy/android-device-list/blob/master/LICENSE">MIT</a> </li> <li>android-device-list: <a href="https://github.com/pbakondy/android-device-list/blob/master/LICENSE">MIT</a> </li>
</ul> </ul>
[![Translation status](https://hosted.weblate.org/widgets/nekox/-/multi-auto.svg)](https://hosted.weblate.org/engage/nekox/)

View File

@ -1,55 +1,62 @@
NekoX is an third-party Telegram client, based on Telegram-FOSS with features added. NekoX is an third-party Telegram client, based on Telegram-FOSS with features added.
* Most of Nekogram's features - Most of Nekogram's features
* Max account limit set to 32 - Max account limit set to 16
* OpenCC Chinese Convert - OpenCC Chinese Convert
* Built-in Vmess, Shadowsocks, SSR proxies support - Built-in VMess, Shadowsocks, SSR, Trojan-GFW proxies support
* Built-in public proxy list / Proxy subscription support. - Built-in public proxy list / Proxy subscription support
* Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc. - Able to parse all proxy subscription format: SIP008, ssr, v2rayN, vmess1, shit ios app formats, clash config and more
* Scan the qrcode (any link, can add a proxy). - Proxies import and export, remarks, speed measurement, sorting, delete unusable nodes, etc
* The ( vemss / vmess1 / ss / ssr / rb ) proxy link in the message can be clicked. - Scan the QR code (any link, can add a proxy)
* Allow auto disable proxy when VPN is enabled - The ( vmess / vmess1 / ss / ssr / trojan ) proxy link in the message can be clicked
* Proxy automatic switcher - Allow auto-disabling proxy when VPN is enabled
* Add stickers without sticker pack - Proxy automatic switcher
* Allow disable vibration - Add stickers without sticker pack
* Allow clicking on links in self profile - Allow disabling vibration
* Sticker set list backup / restore / share - Allow clicking on links in self profile
* Full InstantView translation support - Sticker set list backup / restore / share
* Translation support for selected text on input and in messages - Full InstantView translation support
* Delete all messages in group - Translation support for selected text on input and in messages
* Dialog sorting is optional "Unread and can be prioritized for reminding" etc. - Delete all messages in group
* Allow to skip "regret within five seconds" - Dialog sorting is optional "Unread and can be prioritized for reminding" etc
* Unblock all users support - Allow to skip "regret within five seconds"
* Login via qrcode - Unblock all users support
* Scan and confirm the login qrcode directly - Login via QR code
* Allow clear application data - Scan and confirm the login QR code directly
* Option to not send comment first when forwarding - Allow clearing app data
* 0ption 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 not send comment first when forwarding
* Option to disable link preview by default: to prevent the server from knowing that the link is shared through Telegram. - 0ption 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 ignore Android-only content restrictions (except for the Play Store version). - Option to disable link preview by default: to prevent the server from knowing that the link is shared through Telegram.
* OpenKaychain client ( sign / verify / decrypt / import ) - Option to ignore Android-only content restrictions (except for the Play Store version).
* Google Cloud Translate / Yandex.Translate support - OpenKaychain client (sign / verify / decrypt / import)
* Custom cache directory (supports external storage) - Google Cloud Translate / Yandex.Translate support
* Custom AppId and Hash (optional NekoX / Andorid / Android X or Manual input) - Custom cache directory (supports external storage)
* Custom server (official, test DC or Manual input) - Custom app ID and Hash (optional NekoX / Andorid / Android X or Manual input)
* Keep the original file name when downloading files - Custom server (official, test DC)
* View the data center you belong to when you don't have an avatar - Keep the original file name when downloading files
* Proxies, groups, channels, sticker packs are able to shared as qrcodes. - View the data center you belong to when you don't have an avatar
* Force English emoji keywords to be loaded - Proxies, groups, channels, sticker packs are able to shared as QR codes
* Add "@Name" when long press @ user option - Force English emoji keywords to be loaded
* Enhanced notification service, optional version without Google Services. - Add "@Name" when long-pressing @user option
* Don't alert "Proxy unavailable" for non-current account - Enhanced notification service, optional version without Google Services
* Option to block others from starting a secret chat with you - Don't alert "Proxy unavailable" for non-current account
* Allow create group without invite - Option to block others from starting a secret chat with you
* Option to upgrade group to supergroup - Allow creation of group without invite
* Mark dialogs as read using tab menu - Option to upgrade group to supergroup
* Option to hide device info - Mark dialogs as read using tab menu
* Improved session dialog - Option to hide device info
* Improved link long click menu - Improved session dialog
* Text replacer - Improved link long click menu
* Option to disable trending - Text replacer
* Tgx style message unpin menu - Option to disable trending
* Built-in Material Design themes / Telegram X style icons - 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 :)
Anti-Feature: Non-Free Network, since the servers run proprietary software. Anti-Feature: Non-Free Network, since the servers run proprietary software.
The official source code of the app contains binary blobs, so this tracks a fork which builds those from source. Hence, versions might become available with a certain lag. The official source code of the app contains binary blobs, so this tracks a fork which builds those from source. Hence, versions might become available with a certain lag.