106 lines
7.1 KiB
Markdown
106 lines
7.1 KiB
Markdown
[![License: GPL v3](https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/license.svg)](https://www.gnu.org/licenses/gpl-3.0) [![Pipeline status](https://ci.codeberg.org/api/badges/gitnex/GitNex/status.svg)](https://ci.codeberg.org/gitnex/GitNex) [![Release](https://img.shields.io/badge/dynamic/json.svg?label=release&url=https://codeberg.org/api/v1/repos/gitnex/GitNex/releases&query=$[0].tag_name)](https://codeberg.org/gitnex/GitNex/releases) [![Crowdin](https://badges.crowdin.net/gitnex/localized.svg)](https://crowdin.com/project/gitnex) [![Join the Discord chat at https://discord.gg/FbSS4rf](https://img.shields.io/discord/632219664587685908.svg)](https://discord.gg/FbSS4rf)
|
|
|
|
[<img alt="Become a Patreon" src="https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/patreon.png" height="40"/>](https://www.patreon.com/mmarif) [<img alt="Buy me a coffee" src="https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/buy-me-a-coffee.png" height="40"/>](https://www.buymeacoffee.com/mmarif)
|
|
|
|
# GitNex - Android client for Forgejo and Gitea
|
|
|
|
GitNex is a free/paid, open-source Android client for the Git repository management tools Forgejo and Gitea.
|
|
|
|
GitNex is licensed under the GPLv3 License. Please refer to the LICENSE file for the full text of the license. **No trackers are used**, and the source code is available here for anyone to audit.
|
|
|
|
## Downloads
|
|
|
|
[<img alt='Get it on F-Droid' src='https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/fdroid.png' height="80"/>](https://f-droid.org/en/packages/org.mian.gitnex/)
|
|
[<img alt='Get it on Google Play' src='https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/google-play.png' height="80"/>](https://play.google.com/store/apps/details?id=org.mian.gitnex.pro)
|
|
[<img alt='Download builds and releases' src='https://codeberg.org/gitnex/GitNex/raw/branch/main/assets/apk-badge.png' height="82"/>](https://cloud.swatian.com/s/WS4k3seXnmfQppo)
|
|
|
|
## Note about Forgejo and Gitea version
|
|
|
|
Please make sure that you are on the latest stable release or later for a better app experience.
|
|
|
|
Check the version [compatibility page](https://codeberg.org/gitnex/GitNex/wiki/Compatibility), which lists all the supported versions along with their compatibility ratios.
|
|
|
|
## Build from source
|
|
|
|
Option 1 - Download the source code, open it in Android Studio, and build it there.
|
|
|
|
Option 2 - Open the terminal (Linux) and navigate to the project directory. Then, run `./gradlew assembleFree`.
|
|
|
|
## Features
|
|
|
|
- Multiple accounts support
|
|
- File and directory browser
|
|
- File viewer
|
|
- Create files
|
|
- Explore repositories / issues / organizations / users
|
|
- Pull requests
|
|
- Files diff for PRs
|
|
- Notifications
|
|
- Drafts
|
|
- Repositories / issues list
|
|
- [& more...](https://codeberg.org/gitnex/GitNex/wiki/Features)
|
|
|
|
## Contributing
|
|
|
|
[Contributing](https://codeberg.org/gitnex/GitNex/wiki/Contributing)
|
|
|
|
## Translation
|
|
|
|
Help us translate GitNex into your native language.
|
|
|
|
We use [Crowdin](https://crowdin.com/project/gitnex) for translations. If your language is not listed, please request to add it to the project [here](https://codeberg.org/gitnex/GitNex/issues).
|
|
|
|
**Link: https://crowdin.com/project/GitNex**
|
|
|
|
## Screenshots:
|
|
|
|
[<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/001.png" alt="001.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/001.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/002.png" alt="002.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/002.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/003.png" alt="003.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/003.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/004.png" alt="004.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/004.png)
|
|
---|---|---|---
|
|
[<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/005.png" alt="005.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/005.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/006.png" alt="006.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/006.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/007.png" alt="007.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/007.png) | [<img src="https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/008.png" alt="008.png" width="200"/>](https://codeberg.org/gitnex/GitNex/raw/branch/main/fastlane/metadata/android/en-US/images/phoneScreenshots/008.png)
|
|
|
|
## Links
|
|
|
|
[Website](https://gitnex.com)
|
|
|
|
[Wiki](https://codeberg.org/gitnex/GitNex/wiki/Home)
|
|
|
|
[Troubleshoot Guide](https://codeberg.org/gitnex/GitNex/wiki/Troubleshoot-Guide)
|
|
|
|
[Faq](https://codeberg.org/gitnex/GitNex/wiki/FAQ)
|
|
|
|
[Release Blog](https://gitnex.codeberg.page)
|
|
|
|
## Thanks
|
|
|
|
Thanks to all the open source libraries, contributors, and donors.
|
|
|
|
#### Open source libraries
|
|
|
|
- [square/retrofit](https://github.com/square/retrofit)
|
|
- [google/gson](https://github.com/google/gson)
|
|
- [square/okhttp](https://github.com/square/okhttp)
|
|
- [square/picasso](https://github.com/square/picasso)
|
|
- [noties/Markwon](https://github.com/noties/Markwon)
|
|
- [ocpsoft/prettytime](https://github.com/ocpsoft/prettytime)
|
|
- [ramseth001/TextDrawable](https://github.com/ramseth001/TextDrawable)
|
|
- [vdurmont/emoji-java](https://github.com/vdurmont/emoji-java)
|
|
- [Pes8/android-material-color-picker-dialog](https://github.com/Pes8/android-material-color-picker-dialog)
|
|
- [HamidrezaAmz/BreadcrumbsView](https://github.com/HamidrezaAmz/BreadcrumbsView)
|
|
- [Baseflow/PhotoView](https://github.com/Baseflow/PhotoView)
|
|
- [apache/commons](https://github.com/apache/commons-io)
|
|
- [ge0rg/MemorizingTrustManager](https://github.com/ge0rg/MemorizingTrustManager)
|
|
- [mikaelhg/urlbuilder](https://github.com/mikaelhg/urlbuilder)
|
|
- [ACRA/acra](https://github.com/ACRA/acra)
|
|
- [chrisvest/stormpot](https://github.com/chrisvest/stormpot)
|
|
- [AmrDeveloper/CodeView](https://github.com/AmrDeveloper/CodeView)
|
|
|
|
#### Icon sets
|
|
|
|
- [lucide-icons/lucide](https://github.com/lucide-icons/lucide)
|
|
- [primer/octicons](https://github.com/primer/octicons)
|
|
- [google/material-design-icons](https://github.com/google/material-design-icons)
|
|
|
|
[Follow me on Fediverse - mastodon.social/@mmarif](https://mastodon.social/@mmarif)
|
|
|
|
*All trademarks and logos are the properties of their respective owners.*
|