explaingit

matsuridayo/nekoray

Analysis updated 2026-06-24

15,374C++Audience · generalComplexity · 3/5Setup · moderate

TLDR

NekoBox for PC is a Qt desktop GUI for managing proxy configs on Windows and Linux, backed by sing-box. The original author has abandoned it.

Mindmap

mindmap
  root((nekoray))
    Inputs
      Subscription URLs
      Manual proxy configs
      Clash and v2rayN files
    Outputs
      Routed traffic
      System proxy switching
    Use Cases
      Manage many proxies
      Bypass restrictions
      Test proxy protocols
    Tech Stack
      Cpp
      Qt
      sing-box
Click or tap to explore — scroll the page freely

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

What do people build with it?

USE CASE 1

Import a Shadowsocks or Clash subscription and switch between servers from a tray icon

USE CASE 2

Test SOCKS, VMess, VLESS, Trojan, TUIC, and Hysteria2 servers from one desktop app

USE CASE 3

Route specific apps through a proxy without editing config files by hand

USE CASE 4

Run a portable proxy manager on a Windows laptop alongside Scoop

What is it built with?

C++Qtsing-box

How does it compare?

matsuridayo/nekorayhoffstadt/dearpyguipolybar/polybar
Stars15,37415,41815,259
LanguageC++C++C++
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Project is unmaintained and on Windows needs the Microsoft C++ Runtime installed, so look for a maintained fork first.

In plain English

NekoBox for PC is a graphical user interface (GUI) application for managing proxy configurations on Windows and Linux. A proxy is a server that routes your internet traffic through an intermediary, commonly used to bypass network restrictions or improve privacy. NekoBox provides a visual dashboard for setting up and switching between multiple proxy connections, rather than having to configure them manually through command-line tools or configuration files. The application is built using the Qt framework (a toolkit for building cross-platform desktop applications) and uses sing-box as its backend engine, which handles the actual network routing. It supports a wide range of proxy protocols including SOCKS, HTTP/HTTPS, Shadowsocks, VMess, VLESS, Trojan, TUIC, and Hysteria2. It can also import proxy configurations from subscription links in several common formats, including Shadowsocks, Clash, and v2rayN formats, letting you load a list of servers from a URL automatically. On Windows, it requires the Microsoft C++ Runtime library to be installed. On Linux, it is available through the AUR package manager for Arch-based distributions and via Scoop on Windows. The README notes that this project is no longer being maintained by the original author, and users should seek alternative projects.

Copy-paste prompts

Prompt 1
Find a maintained fork or successor to nekoray that supports the same sing-box backend
Prompt 2
Show me how to import a Clash subscription URL into nekoray on Windows
Prompt 3
Build nekoray from source on Arch Linux with the AUR PKGBUILD
Prompt 4
Compare nekoray to v2rayN and Clash Verge for managing 20 proxy servers
Prompt 5
Explain how nekoray bridges Qt UI events to sing-box routing rules

Frequently asked questions

What is nekoray?

NekoBox for PC is a Qt desktop GUI for managing proxy configs on Windows and Linux, backed by sing-box. The original author has abandoned it.

What language is nekoray written in?

Mainly C++. The stack also includes C++, Qt, sing-box.

How hard is nekoray to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is nekoray 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.