gitwtfhub

wtf is nekoboxforandroid?

matsuridayo/nekoboxforandroid — explained in plain English

Analysis updated 2026-06-21

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

TL;DR

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.

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

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

KotlinAndroidsing-box

How it stacks up

matsuridayo/nekoboxforandroidandroid/nowinandroidafollestad/material-dialogs
Stars20,55521,15119,597
LanguageKotlinKotlinKotlin
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldeveloperdeveloper

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

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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

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

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane