README

Shadowsocks for Android









for Android & Chrome OS (beta)  

for Android TV (beta)


 PREREQUISITES

 JDK 11+
 Android SDK
  - Android NDK
 Rust with Android targets installed using rustup target add 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
 Build it using Android Studio or gradle script

 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.


 TRANSLATE

 OPEN SOURCE LICENSES


    redsocks: APL 2.0
    libevent: BSD
    tun2socks: BSD
    shadowsocks-rust: MIT
    libsodium: ISC
    OpenSSL: OpenSSL License



 LICENSE

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 .

Top issues

Discussions

Latest release

What's Changed

 Bug Fixes
- Fix DNS resolution failure on some devices (OnePlus 12 / Android 15) (3185)
- Fix profileName fallback missing
- Fix desugaring issue
- Fix build staleness
- Ensure VpnService is prepared before connecting

 Improvements
- VPN flags are now opt-in for plugins (3227)
- Eliminate gson dependency
- Remove non-existent include dirs (3198)
- Refine code style
- Add E2E test GitHub Actions workflow with x86_64 emulator

 Dependencies
- Update all dependencies to latest versions

Full Changelog: https://github.com/shadowsocks/shadowsocks-android/compare/v5.3.4...v5.3.5-ni