whatisgithub

What is fancyss?

hq450/fancyss — explained in plain English

Analysis updated 2026-06-24

13,541ShellAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A plugin for ASUS, Merlin, and OpenWrt home routers that routes your entire home network through proxy protocols to bypass regional internet filtering, covering every device automatically without per-device setup.

Mindmap

mindmap
  root((fancyss))
    What It Does
      Router-level proxy
      Whole network coverage
      Bypass filtering
    Proxy Protocols
      Shadowsocks
      V2Ray
      Trojan
      NaiveProxy
    Hardware Platforms
      Broadcom HND
      Qualcomm QCA
      ARM Merlin
      MIPSEL routers
    Features
      Auto server lists
      Gaming mode
      Router UI panel
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

Install on your home router so every device on your network bypasses internet restrictions without installing anything on individual phones or computers.

USE CASE 2

Subscribe to a server list that auto-updates so your proxy servers refresh automatically without manual reconfiguration.

USE CASE 3

Switch between gaming mode and a standard proxy mode from the router's built-in management interface.

What is it built with?

ShellShadowsocksShadowsocksRV2RayTrojanNaiveProxy

How does it compare?

hq450/fancyssmyspaghetti/macos-virtualboxpowerlevel9k/powerlevel9k
Stars13,54113,54113,424
LanguageShellShellShell
Setup difficultymoderatemoderatemoderate
Complexity3/52/52/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

Must be installed on a compatible ASUS, Merlin, or OpenWrt router, available features vary by hardware architecture and firmware version.

So what is it?

Fancyss is a plugin for home routers running ASUS firmware or the popular Merlin and OpenWrt alternatives. It installs directly onto the router and routes network traffic through proxy protocols to bypass the internet filtering system used in China, commonly called the Great Firewall. Because the plugin lives on the router rather than on any individual device, every device on the home network benefits automatically without needing separate software installed on each phone, computer, or tablet. The plugin supports several different proxy protocols including Shadowsocks, ShadowsocksR, V2Ray, NaiveProxy, and Trojan. It provides a management interface through the router's software center that lets users add and configure proxy servers, subscribe to server lists that update automatically, sort servers, and switch between modes such as a gaming mode and a mode for returning to China-accessible services. The exact set of features varies depending on the router's hardware architecture and the firmware variant being used. The project maintains several separate versions targeting different hardware platforms: one for Broadcom HND and AXH routers, one for Qualcomm QCA routers, one for older ARM-based Merlin firmware, and one for MIPSEL-based routers. Some of these versions are still actively maintained while others have been discontinued or placed in archive status. The README is primarily in Chinese, reflecting its main audience, and contains detailed compatibility tables showing which features are available on which platform and firmware combination.

Copy-paste prompts

Prompt 1
I have an ASUS router running Merlin firmware and want to install fancyss. Walk me through adding a Shadowsocks server and enabling it for my whole home network.
Prompt 2
Help me configure a V2Ray server entry in fancyss on a Qualcomm QCA router, what fields do I need and what format does the config expect?
Prompt 3
How do I set up automatic server list subscriptions in fancyss so my proxy server list updates itself without me adding servers manually?

Frequently asked questions

What is fancyss?

A plugin for ASUS, Merlin, and OpenWrt home routers that routes your entire home network through proxy protocols to bypass regional internet filtering, covering every device automatically without per-device setup.

What language is fancyss written in?

Mainly Shell. The stack also includes Shell, Shadowsocks, ShadowsocksR.

How hard is fancyss to set up?

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

Who is fancyss for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.