You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Max Lv 64b2dfb77c Bump version 20 hours ago
.circleci Update Circle CI to API 29 8 months ago
.github Update FUNDING.yml 9 months ago
core Add link-to-issue comment 4 days ago
gradle/wrapper Update dependencies 2 weeks ago
mobile Fix handling of missing plugin 2 weeks ago
plugin Update dependencies 2 weeks ago
tv Add OSS licenses to tv 4 weeks ago
.gitignore Update overture and migrate to go mod 1 year ago
.gitmodules Use re2 2 months ago
.travis.yml Use api-28-ndk image for CI 1 year ago
AUTHORS add AUTHORS 3 years ago Clarifying instruction documents (#2213) 9 months ago
LICENSE Update README and LICENSE 3 years ago Update 4 weeks ago
build.gradle Bump version 20 hours ago
detekt.yml Update dependencies 1 week ago Update android plugin 6 months ago
gradlew Use coreLibraryDesugaring 1 month ago
gradlew.bat Improve gesture navigation on Android Q beta 5 7 months ago Update 1 year ago Update to NDK r19 1 year ago
settings.gradle Initial design for Android TV 1 year ago Update translations 7 months ago

Shadowsocks for Android

CircleCI API Releases Codacy Badge

for Android & Chrome OS (beta)
for Android TV (beta)


  • JDK 1.8
  • Android SDK
    • Android NDK


You can check whether the latest commit builds under UNIX environment by checking Travis status.

  • Clone the repo using git clone --recurse-submodules <repo> or update submodules using git submodule update --init --recursive
  • Build it using Android Studio or gradle script


mkdir build
sudo chown 3434:3434 build
docker run --rm -v ${PWD}/build:/build circleci/android:api-28-ndk bash -c "cd /build; git clone; cd shadowsocks-android; git submodule update --init --recursive; ./gradlew assembleDebug"


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.




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