Getting Started - ZvanTors/GoodByeDPI-GUI GitHub Wiki
Get up and running with GoodByeDPI GUI in under two minutes.
| Requirement | |
|---|---|
| 🪟 | Windows 10 or 11 (64-bit) |
| 🔑 | Administrator privileges — required to modify network packets |
| 🌐 | No VPN active — they can conflict with each other |
⚠️ Windows 7 / 8 are not supported.
Grab the latest GoodByeDPI.GUI.exe from the
Releases page.
The file is a single portable EXE — no installer, no dependencies.
Right-click the EXE → Run as administrator.
Windows will show a UAC prompt — click Yes. This is required because GoodbyeDPI needs low-level access to network packets.
💡 Tip: If UAC is disabled on your system, the app will refuse to run with a clear error message.
On first launch, you'll see three cards:
| Card | Best For |
|---|---|
| ⚡ Fast (Recommended) | Most ISPs — good default choice |
| 🛡 Compatible | When Fast mode causes issues |
| 🔧 Custom | Power users who know GoodbyeDPI flags |
Just click a card to select it. The border turns blue to show it's active.
📖 Want to know more? See Modes Explained.
Press the big green ▶ Start button.
You'll see:
- The status pill turn from red ● Stopped to green ● Running
- The uptime chip appear and start ticking
- A separator line
─── GoodbyeDPI started ───in the log
Open your browser and visit any previously blocked site. It should now load normally.
Click ⏹ Stop to disable DPI circumvention. The app stays open — you can start it again anytime.
That's it. GoodByeDPI GUI is now running.
| If you want to... | Read this |
|---|---|
| Understand every button | User Guide |
| Learn about each mode | Modes Explained |
| Pass your own flags | Custom Arguments |
| Auto-start with Windows | User Guide |
| Fix a problem | Troubleshooting |
Need help? Open a discussion 💬
This wiki is the complete documentation for GoodByeDPI GUI — a clean, powerful graphical interface for GoodbyeDPI.
If you're new here, start with Getting Started. If you're looking for something specific, use the navigation below.
|
|
GoodByeDPI GUI wraps the powerful GoodbyeDPI command-line tool in a modern, easy-to-use desktop application for Windows.
It helps you bypass Deep Packet Inspection (DPI) — the technology some ISPs use to block or throttle websites.
💡 No terminal. No config files. Just click and browse.
| Feature | What it does | |
|---|---|---|
| 🎛 | Mode Cards | Pick Fast, Compatible, or Custom visually |
| ⚡ | One-Click Start/Stop | Toggle DPI circumvention instantly |
| 🍞 | Toast Notifications | Friendly, non-intrusive feedback |
| 📖 | Arguments Guide | Built-in reference for every GoodbyeDPI flag |
| ✅ | Live Validator | Catches typos before you start |
| 🔔 | System Tray | Runs quietly in the background |
| 🎨 | Modern Dark UI | Catppuccin-inspired design |
| 🌐 | Auto Update Checker | Knows when a new version is out |