A desktop GUI frontend for shadowsocks-rust client implemented with gtk-rs.
This application is currently Linux only. Compatibility with other OSes isn't planned, because there already exists plenty of alternative solutions for Windows and MacOS.
This package contains two binaries:
| Binary | Functionality |
|------------|------------------------------------------------------------------------------------------|
| ssgtk | The main executable; launches the GUI application. |
| ssgtkctl | The runtime API controller; see Q&A. |
Be advised that this application may be incomplete and/or buggy. But do rest assured that it won't destroy your OS or something.
Your input is very welcomed! If you have any suggestions or have found any issue (no matter how small or unimportant) with the code or the documentation, please feel free to raise an issue. Or better yet, submit a PR if you can!
If you are using this application for the first time, you should first read the configuration guide.
You can install the AUR package that I maintain.
```sh
paru shadowsocks-gtk-rs ```
You can always install directly from crates.io.
sh
cargo install shadowsocks-gtk-rs
cargo-installrust, see here.sslocal binary from shadowsocks-rust as the backend.
GTK3 and libappindicator, using your distro's package manager.The latest versions are highly recommended.
| Distro | GTK3 | libappindicator |
|---------------|----------------|------------------------|
| Arch pacman | gtk3 | libappindicator-gtk3 |
| Debian apt | libgtk-3-dev | libappindicator3-dev |
| Fedora dnf | gtk3-devel | libappindicator-gtk3 |
If you are using any recent version of Gnome as your desktop environment, you also need gnome-shell-extension-appindicator for the tray icon to show up.
```sh git clone https://github.com/spyophobia/shadowsocks-gtk-rs.git cd shadowsocks-gtk-rs
./run-local.sh ```