中文用户指南

Shadowsocks-Qt5 is a fast, reliable and platform-cross GUI fronted for Shadowsocks.

Latest Stable Version: 0.4.2

• Shadowsocks-Qt5 is written in C++/Qt5.
• An intuitive and native UI. And JUST a GUI fronted. Keep your favourite Shadowsocks port as backend.
• The gui-config.json file is partially compatible with shadowsocks-gui. In order to serve better, some new values have been added.
• gui-config.json is located under ~/.config/shadowsocks on UNIX platforms, or under the main programme's directory in Windows.

• It is not a standalone programme. ss-qt5 needs a shadowsocks backend such as Shadowsocks-libev and Shadowsocks-Python.
• Shadowsocks-Python is highly recommended to serve as backend for better performance and stability.
• Don't be panic if you encounter a bug. Please feel free to open issues. Just remember to run from terminal or cmd and paste the output to the description of issue.

1. Download prebuilt binaries from releases.
2. Install/update your favourite shadowsocks backend. (You may want to download prebuilt ss-libev).

For those who want to build from source, follow the instructions below.

Open this project using Qt Creator and build it.

Or type the command in MSYS.

qmake INSTALL_PREFIX=../ss-qt5
make
make install

You will get ss-qt5.exe and gui-config.json in ../ss-qt5 directory.

You should have installed Qt 5 and its development packages before building.

# Some distros use seperated qmake-qt4, qmake-qt5. Then, just run `qmake-qt5`. You can specify INSTALL_PREFIX=/usr/local if needed. default is /usr
qmake INSTALL_PREFIX=/usr
make
make install

Mac OS X and FreeBSD are not tested and they're NOT supported officially. Well, I do hope you can help me mantain the compatibility if you have spare time.