User Guide

📘 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 💬