Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://gitlab.com/mahc9kez/shadowsocks-android-foss
FOSS fork of [shadowsocks-android](https://github.com/shadowsocks/shadowsocks-android)
https://gitlab.com/mahc9kez/shadowsocks-android-foss
proxy shadowsocks
Last synced: about 1 month ago
JSON representation
FOSS fork of [shadowsocks-android](https://github.com/shadowsocks/shadowsocks-android)
- Host: gitlab.com
- URL: https://gitlab.com/mahc9kez/shadowsocks-android-foss
- Owner: mahc9kez
- License: other
- Created: 2019-12-16T04:48:04.857Z (about 5 years ago)
- Default Branch: master
- Last Synced: 2024-08-01T22:42:11.912Z (5 months ago)
- Topics: proxy, shadowsocks
- Stars: 22
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
## [Shadowsocks](https://shadowsocks.org) FOSS for Android
[![API](https://img.shields.io/badge/API-23%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=23)
[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-orange.svg)](https://www.gnu.org/licenses/gpl-3.0)[](https://f-droid.org/en/packages/com.gitlab.mahc9kez.shadowsocks.foss/)
This project is a fork of [shadowsocks-andorid](https://github.com/shadowsocks/shadowsocks-android). It aimed to be FOSS, ad-free, does not require any proprietary dependencies or services, and does not collect your data nor share with any third party services.
Currently keep updating with upstream, no extra features are added but modified a few default options with different theme.
### PREREQUISITES
* JDK 1.8
* Android SDK
- Android NDK
* Rust with Android targets installed
`$ rustup target install armv7-linux-androideabi aarch64-linux-android i686-linux-android x86_64-linux-android`### BUILD
You can check whether the latest commit builds under UNIX environment by checking Travis status.
* Install prerequisites
* Clone the repo using `git clone --recurse-submodules ` or update submodules using `git submodule update --init --recursive`
* `sed -i 's/com.github.shadowsocks/com.gitlab.mahc9kez.shadowsocks.foss/' core/src/main/jni/badvpn/tun2socks/tun2socks.c`
* Build it using Android Studio or gradle script### BUILD WITH DOCKER
* Clone the repo using `git clone --recurse-submodules ` or update submodules using `git submodule update --init --recursive`
* Run `docker run --rm -v ${PWD}:/build -w /build shadowsocks/android-ndk-go ./gradlew assembleDebug`### VERSIONING
Version Name:
Same as upstream releases but [a-z] suffix for each revision```
[4] [08] [07] [01] 0
4 .8 .7 a [ABI]ABI:
0 universal
1 armeabi-v7a
2 arm64-v8a
3 x86
4 x86_64
```### CONTRIBUTING
If you are interested in contributing or getting involved with this project, please read the CONTRIBUTING page for more information. The page can be found [here](https://gitlab.com/mahc9kez/shadowsocks-android-foss/-/blob/master/CONTRIBUTING.md).
### TRANSLATION
We keep most of translation from [upstream](https://discourse.shadowsocks.org/t/poeditor-translation-main-thread/30), except Simplified Chinese (zh-rCN) translation. This project does not include or accept zh-rCN translation.
F-Droid translation are located in [metadata/](metadata/), you can contribute directly by sending Merge Requests.
## OPEN SOURCE LICENSES
- redsocks: APL 2.0
- libevent: BSD
- tun2socks: BSD
- shadowsocks-rust: MIT
- libsodium: ISC
- OpenSSL: OpenSSL License
### LICENSE
Files under [art/](art/) folder are used to generate certain icons which are licensed under Apache-2.0
Based heavily on [shadowsocks-andorid](https://github.com/shadowsocks/shadowsocks-android) by Max Lv and Mygod Studio
Copyright (C) 2017 by Max Lv <>
Copyright (C) 2017 by Mygod Studio <>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see .