matsuridayo/nekoboxforandroid

Analysis updated 2026-06-21

★ 20,555KotlinAudience · generalComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Android proxy client
      Protocol support
      Subscription import
    Protocols
      Shadowsocks
      VMess and VLESS
      WireGuard
      Hysteria 2
    Subscriptions
      ClashMeta format
      v2rayN format
      sing-box format
    Audience
      Proxy users
      Privacy-focused
      Android users

mindmap root((repo)) What it does Android proxy client Protocol support Subscription import Protocols Shadowsocks VMess and VLESS WireGuard Hysteria 2 Subscriptions ClashMeta format v2rayN format sing-box format Audience Proxy users Privacy-focused Android users

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Connect your Android device to a Shadowsocks or VMess proxy server to access restricted content.

USE CASE 2

Import a subscription link from your proxy provider and manage multiple servers in one app.

USE CASE 3

Route Android app traffic through a proxy without rooting your device.

USE CASE 4

Use faster protocols like Hysteria 2 or TUIC for more resilient proxy connections on unstable networks.

What is it built with?

KotlinAndroidsing-box

How does it compare?

	matsuridayo/nekoboxforandroid	android/nowinandroid	afollestad/material-dialogs
Stars	20,555	21,151	19,597
Language	Kotlin	Kotlin	Kotlin
Setup difficulty	easy	moderate	easy
Complexity	2/5	3/5	2/5
Audience	general	developer	developer

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Android API 21 or higher, download only from GitHub Releases since the Google Play version is controlled by a third party and is not open source.

GPL-3.0, free to use and modify, but any distributed version must also be open source under the same license.

In plain English

NekoBox for Android is a universal proxy client for Android built on the sing-box proxy core. It supports a wide range of proxy protocols including SOCKS (4/4a/5), HTTP(S), SSH, Shadowsocks, VMess, Trojan, VLESS, AnyTLS, ShadowTLS, TUIC, Hysteria 1 and 2, WireGuard, Trojan-Go, NaiveProxy, and Mieru. Additional protocols are available via downloadable plugins. The app requires Android API 21 or higher and is licensed under GPL-3.0. It is available for download from GitHub Releases. The app supports subscription formats including widely used formats such as Shadowsocks, ClashMeta, and v2rayN, as well as sing-box outbound format. Only outbound node parsing is supported, diversion rules and similar settings from subscription files are ignored. The README notes that the Google Play version has been controlled by a third party since May 2024 and is non-open-source, so users are advised to download only from GitHub Releases. The project is based on the SagerNet/sing-box core, with the Android GUI derived from shadowsocks-android and SagerNet.

Copy-paste prompts

Prompt 1

I have a Shadowsocks server and want to set it up in NekoBox for Android. Walk me through adding the server and enabling the proxy.

Prompt 2

How do I import a ClashMeta subscription file into NekoBox for Android and switch between servers?

Prompt 3

What is the difference between VMess and VLESS in NekoBox for Android, and which should I use for better performance?

Prompt 4

I want split-tunneling in NekoBox so only certain apps go through the proxy. How do I configure that?

Frequently asked questions

What is nekoboxforandroid?

NekoBox for Android is a proxy client app that supports a wide range of protocols including Shadowsocks, VMess, WireGuard, and Hysteria 2, letting you route your Android traffic through a proxy server.

What language is nekoboxforandroid written in?

Mainly Kotlin. The stack also includes Kotlin, Android, sing-box.

What license does nekoboxforandroid use?

GPL-3.0, free to use and modify, but any distributed version must also be open source under the same license.

How hard is nekoboxforandroid to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is nekoboxforandroid for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub matsuridayo on gitmyhub

Verify against the repo before relying on details.