Files
LorenEteval_Furious/README.md
T
humatic-ai d63563c314 docs(windows): require amd64 wintun.dll for TUN mode
The official Wintun zip ships multiple architectures under bin/.
Furious Windows is amd64-only; wrong DLL can crash TUN mode.
Point readers to the TUN Mode wiki for full setup.

Made-with: Cursor
2026-04-08 18:14:35 +00:00

91 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Furious
[![Github Deploy](https://github.com/LorenEteval/Furious/actions/workflows/deploy-pypi.yml/badge.svg?branch=main)](https://github.com/LorenEteval/Furious/actions/workflows/deploy-pypi.yml)
[![winget](https://img.shields.io/badge/winget-Available-brightgreen?logo=windows)](https://winstall.app/apps/LorenEteval.Furious)
[![release](https://img.shields.io/github/v/release/LorenEteval/Furious)](https://github.com/LorenEteval/Furious/releases)
[![license](https://img.shields.io/github/license/LorenEteval/Furious)](https://github.com/LorenEteval/Furious/blob/main/LICENSE)
A cross‑platform GUI proxy client based on PySide6. Support Xray-core & hysteria.
---
## Features
* 🖥️ **Cross‑platform** — Runs on **Windows**, **macOS** and **Linux**
* ⚙️ **Built‑in Support For Xray-core & Hysteria** — Shipped as Python bindings for convenience
* 🔗 **Protocol Support** — VLESS, VMess, Shadowsocks, Trojan, hysteria1 & hysteria2
* 🌐 **TUN Mode Support** — Available on Windows, macOS and Linux
* 📝 **Integrated configuration editor** — Fully editable configuration UI
* 🔄 **Subscription management** — Add, update or schedule refreshes
* 🔌 **Client UX** — One‑click Connect / Disconnect
* 📥 **Import** via share link, JSON, or QR Code
* 📤 **Export** as share link, JSON, or QR Code
* 🔓 **Open-source & Reproducible Builds**
* ...
## Install
You can install from the **[GitHub Releases](https://github.com/LorenEteval/Furious/releases)** page or directly from **PyPI**.
### 🪟 winget (Windows only)
```
winget install --id=LorenEteval.Furious -e
```
### 🐍 PyPI
```
pip install Furious-GUI
```
## Wiki
* 🌐 [TUN Mode](https://github.com/LorenEteval/Furious/wiki/TUN-Mode)
* 🔄 [Subscription Management](https://github.com/LorenEteval/Furious/wiki/Subscription-Management)
* 📦 [Install From PyPI](https://github.com/LorenEteval/Furious/wiki/Install-From-PyPI)
### Windows TUN (`wintun.dll`)
The Windows release is **amd64 (x64)** only. The [official Wintun](https://www.wintun.net/) package ships **one `wintun.dll` per CPU architecture** under `wintun\bin\` (for example `amd64`, `arm`, `arm64`, and `x86`).
You must use the DLL from **`wintun\bin\amd64\wintun.dll`**. Loading a DLL from another architecture (for example `arm64` or `x86`) can **crash TUN mode**.
Full setup (including where to place the file and administrator steps) is documented in **[TUN Mode](https://github.com/LorenEteval/Furious/wiki/TUN-Mode)**.
## Contributing
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/LorenEteval/Furious)
## Credits
* [Xray-core](https://github.com/XTLS/Xray-core)
* [hysteria](https://github.com/apernet/hysteria)
* [tun2socks](https://github.com/xjasonlyu/tun2socks)
Special thanks to [@rakleed](https://github.com/rakleed) for adding the Windows package to winget.
---
## Donations
If you find this project useful, donations are warmly appreciated. They help sustain development, testing and future
improvements.
* BTC: `12Yp5Ffr6sXR5Ha5h43FnGW4RSCQeeJeUG`
* TRC20/TRON (USDT, TRON, ...): `TVHKXJq6S5cWzLwa7tLf6LoYB3T9ftiFkN`
## Star History
<a href="https://www.star-history.com/#LorenEteval/Furious&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=LorenEteval/Furious&type=date&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=LorenEteval/Furious&type=date&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=LorenEteval/Furious&type=date&legend=top-left" />
</picture>
</a>
## License
Licensed under **[GPL v3.0](https://github.com/LorenEteval/Furious/blob/main/LICENSE)**.