.githubUpdate issue_template.md to include remote DNSMygod19 days ago
mobileRefine #1217Mygod4 days ago
pluginImport strings.xml from POEditor.comMygod1 month ago
projectReplace tag manager with firebase configMax Lv5 days ago
.gitignoreAdd build files for overtureMax Lv19 days ago
.gitmodulesAdd build files for overtureMax Lv19 days ago
.headache.cfgUpdate LICENSEMax Lv4 months ago
.jvmoptsMaxPermSize was removed in JDK 1.8 (#1207)Xingyu C16 days ago
.travis.ymlAdd arm64 supportMax Lv1 month ago
AUTHORSadd AUTHORSMax Lv10 months ago
CONTRIBUTING.mdUpdate CONTRIBUTING.mdMygod11 months ago
LICENSEUpdate README and LICENSEMygod3 months ago
README.mdRefine README.mdMygod1 month ago
build.sbtUpdate dependenciesMygod21 days ago
shadow-notify.pngupdate to the new iconsMax Lv3 years ago
shadow.pngupdate the icon colorMax Lv3 years ago

Shadowsocks for Android

A shadowsocks client for Android, written in Scala.


Build Status


  • JDK 1.8
  • SBT 0.13.0+
  • Go 1.4+
  • Android SDK
    • Build Tools 25+
    • Android Support Repository and Google Repository (see build.sbt for version)
    • Android NDK r14+


  • Set environment variable ANDROID_HOME to /path/to/android-sdk
  • (optional) Set environment variable ANDROID_NDK_HOME to /path/to/android-ndk (default: $ANDROID_HOME/ndk-bundle)
  • Set environment variable GOROOT_BOOTSTRAP to /path/to/go
  • Create your key following the instructions at https://developer.android.com/studio/publish/app-signing.html
  • Create mobile/local.properties from mobile/local.properties.example with your own key information
  • Invoke the building like this
    git submodule update --init --recursive

    # Build the App
    sbt clean go-build android:package-release


Translators can go to POEditor to help translate shadowsocks-android. Guidelines:

  • It's okay to leave some strings untranslated if you think it should use the same string as English (US).
  • faq_url should not be changed. If you'd like to translate FAQ, submit a pull request with the translated faq.md (it should be named properly, e.g. .github/faq.zh-CN.md). Administrators will take care of the rest.
  • Do not add/edit/remove comments.



Copyright (C) 2017 by Max Lv <max.c.lv@gmail.com>
Copyright (C) 2017 by Mygod Studio <contact-shadowsocks-android@mygod.be>

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 http://www.gnu.org/licenses/.

About FluentSend Feedback