User Guide - ZvanTors/GoodByeDPI-GUI GitHub Wiki
A complete walkthrough of every part of the GoodByeDPI GUI interface.
The window is divided into six sections:
ββββββββββββββββββββββββββββββββββββββββββββββββ
β π‘ GoodByeDPI GUI [v1.2.0] β Header
ββββββββββββββββββββββββββββββββββββββββββββββββ€
β DPI Circumvention Settings β
β ββββββββββ ββββββββββ ββββββββββ β
β β Fast β βCompat. β βCustom β β Mode Cards
β ββββββββββ ββββββββββ ββββββββββ β
β β Run on Windows startup β
ββββββββββββββββββββββββββββββββββββββββββββββββ€
β [βΆ Start] [βΉ Stop] β Stopped β± 00:00:00 β β Controls
ββββββββββββββββββββββββββββββββββββββββββββββββ€
β Output β Log Area β
β βββ GoodbyeDPI started βββ β
β ... β
β [Clear] [Copy] β
ββββββββββββββββββββββββββββββββββββββββββββββββ€
β [π Check for updates] β€ Made with ... β β Footer
ββββββββββββββββββββββββββββββββββββββββββββββββThree cards let you choose how GoodByeDPI runs:
| Card | Args | When to use |
|---|---|---|
| β‘ Fast | -6 |
Default. Works for most users. |
| π‘ Compatible | -5 |
If Fast mode causes websites to hang. |
| π§ Custom | (your own) | Advanced users. Full control. |
Click any card to select it. The selected card gets a blue border and a tinted background.
π§ Custom reveals an extra input field for your own arguments β see Custom Arguments.
When you switch to Custom, the window grows smoothly to fit the extra input field. When you switch back, it shrinks. No jarring jumps.
Only visible when the Custom card is selected.
The input field accepts any valid GoodbyeDPI command-line arguments.
Example:
-f 2 -e 40 --native-frag --reverse-frag --max-payloadAs you type, a status line appears under the field:
| Indicator | Meaning |
|---|---|
| β Arguments look valid | No problems detected |
| β Warning message | Unusual combo β will still run |
| β Error message | Typo or missing value β will warn before start |
Hover over the status line to see all errors and warnings in a tooltip.
Click the ? button next to the field to open the Arguments Guide β a tabbed reference of every flag with:
- π Live search across all flags
- β One-click add (appends to your args)
- π― Presets tab (replaces the whole line)
- π· Badges:
RECOMMENDED,DANGEROUS,DEFAULT
| Button | What it does |
|---|---|
| βΆ Start | Launches goodbyedpi.exe with the current mode's arguments |
| βΉ Stop | Kills the process (graceful, no orphan processes) |
Before starting, if you're in Custom mode with invalid args, a confirmation dialog will appear.
| Element | Meaning |
|---|---|
| π΄ β Stopped | GoodByeDPI is not running |
| π’ β Running (pulsing) | GoodByeDPI is active |
| β± 00:00:00 | Session timer β appears only when running |
Real-time output from goodbyedpi.exe, with color coding:
| Color | Meaning |
|---|---|
| π’ Green | Normal output |
| π΄ Red | Errors |
| π‘ Yellow | Warnings |
| π΅ Blue | Separators (βββ lines) |
Buttons:
- Clear β empty the log
- Copy β copy entire log to clipboard (shows a toast)
Tick Run on Windows startup (Task Scheduler) to launch GoodByeDPI GUI automatically at login.
This creates a Windows Task named GoodbyeDPIManager with
highest privileges.
To verify or remove manually:
- Open Task Scheduler (
taskschd.msc) - Look for
GoodbyeDPIManager - Check "Run with highest privileges" is enabled
β οΈ If you move the EXE to a new folder, disable and re-enable the option to update the path.
Closing the window shows an Exit Options dialog:
| Button | Result |
|---|---|
| Exit | Fully quits the app |
| Minimize to Tray | Hides the window; app keeps running |
| Cancel | Keeps the window open |
From the tray icon you can:
- βΆ Start
- βΉ Stop
- See current status
- Exit
Double-click the tray icon to restore the window.
Small, self-dismissing notifications appear at the bottom-right corner:
| Type | When |
|---|---|
| βΉ Info | Neutral updates |
| β Success | Something worked (e.g., task created) |
| β Warning | Attention needed |
| β Error | Something failed |
Click a toast to dismiss it immediately. They also fade out on their own after a few seconds.
Automatic: runs silently on every launch.
Manual: click π Check for updates at the bottom-left.
- If a new version exists β Update Available dialog with a Download button
- If you're current β toast: "You're on the latest version"
- If offline β warning toast
Click the v1.2.0 badge in the header (top-right) to see:
- App version
- Powered-by libraries (clickable links)
- Author credits
- GitHub button
These are remembered between sessions:
- β Selected mode
- β Custom arguments
- β Window position & size
- β Auto-start setting (via Task Scheduler)
No manual save needed.
Still have questions? Check FAQ or open a discussion π¬