https://github.com/shadowsocks/shadowsocks-android

A shadowsocks client for Android
https://github.com/shadowsocks/shadowsocks-android

android shadowsocks

Last synced: 7 days ago
JSON representation

A shadowsocks client for Android

• Host: GitHub
• URL: https://github.com/shadowsocks/shadowsocks-android
• Owner: shadowsocks
• License: other
• Created: 2012-12-16T13:40:29.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-07T02:13:51.000Z (29 days ago)
• Last Synced: 2024-10-08T10:47:49.236Z (28 days ago)
• Topics: android, shadowsocks
• Language: Kotlin
• Homepage:
• Size: 51.3 MB
• Stars: 35,078
• Watchers: 1,567
• Forks: 11,578
• Open Issues: 42
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome - shadowsocks-android - A shadowsocks client for Android (Kotlin)
• awesome-kotlin-android - shadowsocks-android - shadowsocks 客户端 🔥🔥🔥🔥🔥 (完整 app / 测试)
• my-awesome - shadowsocks/shadowsocks-android - 10 star:35.2k fork:11.6k A shadowsocks client for Android (Kotlin)
• awesome-github-star - shadowsocks-android
• awesome-android-kotlin-apps - shadowsocks-android
• my-awesome - shadowsocks-android - A shadowsocks client for Android (Software)
• awesome-network-stuff - **27960**星

README

        
## [Shadowsocks](https://shadowsocks.org) for Android

[![CircleCI](https://circleci.com/gh/shadowsocks/shadowsocks-android.svg?style=shield)](https://circleci.com/gh/shadowsocks/shadowsocks-android)

[![API](https://img.shields.io/badge/API-23%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=23)

[![Releases](https://img.shields.io/github/downloads/shadowsocks/shadowsocks-android/total.svg)](https://github.com/shadowsocks/shadowsocks-android/releases)

[![Language: Kotlin](https://img.shields.io/github/languages/top/shadowsocks/shadowsocks-android.svg)](https://github.com/shadowsocks/shadowsocks-android/search?l=kotlin)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/22ca240f272445548e332a42d5a20d95)](https://www.codacy.com/gh/shadowsocks/shadowsocks-android/dashboard?utm_source=github.com&utm_medium=referral&utm_content=shadowsocks/shadowsocks-android&utm_campaign=Badge_Grade)

[![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-orange.svg)](https://www.gnu.org/licenses/gpl-3.0)



for Android & Chrome OS ([beta](https://play.google.com/apps/testing/com.github.shadowsocks))  



for Android TV ([beta](https://play.google.com/apps/testing/com.github.shadowsocks.tv))

### 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](https://github.com/shadowsocks/shadowsocks-android/blob/master/CONTRIBUTING.md).

### [TRANSLATE](https://discourse.shadowsocks.org/t/poeditor-translation-main-thread/30)

## 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 .