User Guide - ZvanTors/GoodByeDPI-GUI GitHub Wiki

πŸ“˜ User Guide

A complete walkthrough of every part of the GoodByeDPI GUI interface.


πŸ–Ό Interface Overview

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
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸŽ› Mode Cards

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.

🎞 Smooth Resize

When you switch to Custom, the window grows smoothly to fit the extra input field. When you switch back, it shrinks. No jarring jumps.


πŸ”§ Custom Arguments Field

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-payload

βœ… Live Validation

As 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.

πŸ“– Arguments Guide

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

▢️ Start / ⏹ Stop

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.


πŸ“Š Status Pill & Uptime Chip

Element Meaning
πŸ”΄ ● Stopped GoodByeDPI is not running
🟒 ● Running (pulsing) GoodByeDPI is active
⏱ 00:00:00 Session timer β€” appears only when running

πŸ“‹ Output Log

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)

πŸš€ Auto-Start with Windows

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:

  1. Open Task Scheduler (taskschd.msc)
  2. Look for GoodbyeDPIManager
  3. 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.


πŸ”” System Tray

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.


🍞 Toast Notifications

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.


πŸ”„ Update Checker

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

ℹ️ About Dialog

Click the v1.2.0 badge in the header (top-right) to see:

  • App version
  • Powered-by libraries (clickable links)
  • Author credits
  • GitHub button

πŸ’Ύ Persistence

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 πŸ’¬

⚠️ **GitHub.com Fallback** ⚠️