Maskeleme — Discord DPI widget (GoodbyeDPI GUI)

TR: Türkiye’de Discord gibi servislere DPI engeli altında erişmek için küçük bir masaüstü widget’ı.
Windows: GoodbyeDPI motorunu yönetir.
Linux / macOS: ByeDPI motorunu otomatik kurar ve yönetir.

EN: A small desktop widget for Discord and similar services behind DPI blocking.
Windows: Controls GoodbyeDPI.
Linux / macOS: Auto-setup for ByeDPI.

Önemli / Important
GoodbyeDPI / ByeDPI’nin yerine geçmez; ince bir arayüzdür.
This does not replace GoodbyeDPI / ByeDPI; it is a thin UI wrapper.
VPN değildir / Not a VPN — trafiği şifrelemez / does not encrypt traffic.

---

İndirme / Download

Son sürüm: Releases

Dosya / File	Platform
Maskeleme-Windows.exe (Windows)	Windows 10/11
Maskeleme-Linux.zip (Linux)	Linux
Maskeleme-macOS.zip (macOS)	macOS

Hızlı başlangıç: Windows’ta exe’yi yönetici olarak çalıştırın. Linux/macOS’ta zip’i açıp ./run.sh çalıştırın.

---

Credits / Teşekkürler

Bu yazılım aşağıdaki açık kaynak projeler olmadan çalışmaz.
This software cannot work without these upstream projects.

Component	Author / Upstream	Repository	License
GoodbyeDPI	ValdikSS	https://github.com/ValdikSS/GoodbyeDPI	Apache-2.0
WinDivert	basil00	https://github.com/basil00/Divert · https://reqrypt.org/windivert.html	LGPL (upstream)
ByeDPI	hufrea	https://github.com/hufrea/byedpi	See upstream

• licenses/LICENSE-goodbyedpi.txt
• licenses/LICENSE-windivert.txt
• NOTICE

Maskeleme, ValdikSS / GoodbyeDPI / ByeDPI ile resmi olarak bağlantılı değildir.
Maskeleme is not affiliated with ValdikSS, GoodbyeDPI, or ByeDPI.

---

Türkçe

Ne yapar?

• Koyu temalı küçük widget (görev çubuğunda yok, tepside durur; Görev Yöneticisi’nde ad: Maskeleme)
• Başlat / Durdur ile DPI motorunu açar / kapatır
• Discord düğmesi (ilk tıklamada yol sorar, kaydeder)
• Dil, Windows / sistem arayüz diline göre ayarlanır (Maskeleme, Masking, …)

Windows kurulumu

1. Releases → Maskeleme-Windows.exe (Windows) indirin
2. Çift tıklayın
3. UAC’de Evet deyin (WinDivert için yönetici gerekir)

Motor dosyaları: %LocalAppData%\Maskeleme\

Linux / macOS kurulumu (otomatik)

Manuel Python / ByeDPI / proxy adımlarına gerek yok. Zip’i açıp:

chmod +x run.sh
./run.sh

run.sh sizin yerinize:

1. Python 3 + Tk yoksa kurar (apt / dnf / pacman / brew)
2. ByeDPI (ciadpi) yoksa Linux’ta indirir, macOS’ta derler → ./bin
3. Widget’ı başlatır

Widget’ta Başlat:

• SOCKS5 127.0.0.1:1080 dinler
• Mümkünse sistem SOCKS proxy’sini açar (GNOME / macOS)

Durdur: motoru kapatır ve proxy ayarını geri alır.

Linux zip’inde ciadpi (x86_64 + aarch64) gömülüdür. macOS’ta ilk çalıştırmada kaynak derleme için make / clang gerekir.

Kullanım

Kontrol	Açıklama
Başlat / Durdur	DPI motorunu açar / kapatır
Discord	Discord’u açar (yol yoksa sorar)
×	Widget’ı gizler (tepside kalır)
Tepsi → Çıkış	Widget + motoru kapatır

Windows’ta kaynaktan derleme

powershell -ExecutionPolicy Bypass -File .\pack\build.ps1

Uyarılar

• VPN değildir; trafiği şifrelemez.
• Windows’ta yönetici ister.
• Antivirüs, paket yakalama nedeniyle uyarı verebilir.
• Yalnızca yasal kullanım için; yerel yasalara uyun.

Lisans

Maskeleme arayüzü: MIT (LICENSE).
GoodbyeDPI / WinDivert / ByeDPI: kendi lisansları.

---

English

What it does

• Compact dark widget (no taskbar button; tray only; process name Maskeleme)
• Start / Stop controls the DPI engine
• Discord button (asks for path once, then remembers it)
• Title follows system UI language (Maskeleme, Masking, …)

Windows install

1. Download Maskeleme-Windows.exe (Windows) from Releases
2. Double-click
3. Accept UAC (Administrator required for WinDivert)

Engine files extract to %LocalAppData%\Maskeleme\

Linux / macOS install (automatic)

No manual Python / ByeDPI / proxy steps. Unzip, then:

chmod +x run.sh
./run.sh

run.sh will:

1. Install Python 3 + Tk if missing (apt / dnf / pacman / brew)
2. Fetch ByeDPI on Linux or build it on macOS into ./bin
3. Launch the widget

Start in the widget:

• Listens on SOCKS5 127.0.0.1:1080
• Enables system SOCKS proxy when possible (GNOME / macOS)

Stop shuts down the engine and restores proxy settings.

The Linux zip ships ciadpi for x86_64 and aarch64. On macOS, the first run builds from source (make / clang required).

Usage

Control	Description
Start / Stop	Starts / stops the DPI engine
Discord	Opens Discord (asks for path if needed)
×	Hides the widget (stays in tray)
Tray → Exit	Quits widget + engine

Build on Windows

powershell -ExecutionPolicy Bypass -File .\pack\build.ps1

Warnings

• Not a VPN; does not encrypt traffic.
• Requires Administrator on Windows.
• Antivirus may flag packet diversion.
• For lawful use only; follow local laws.

License

Maskeleme UI: MIT (LICENSE).
GoodbyeDPI / WinDivert / ByeDPI: their own licenses.

---

Tests / Testler

cd crossplatform
python3 -m pip install -r requirements-dev.txt
python3 -m pytest -q

---

Repository layout / Depo yapısı

Maskeleme.exe          # Windows build output
pack/                  # C# source + icon + build script
crossplatform/         # Linux/macOS Python widget, run.sh, tests
  run.sh               # One-click setup + launch
  bin/                 # ByeDPI binaries (release zip / auto-download)
x86/  x86_64/          # GoodbyeDPI + WinDivert (upstream)
licenses/  NOTICE  LICENSE

Upstream

• GoodbyeDPI: https://github.com/ValdikSS/GoodbyeDPI
• ByeDPI: https://github.com/hufrea/byedpi
• WinDivert: https://github.com/basil00/Divert

Maskeleme yalnızca bir kullanım kolaylığı katmanıdır.
Maskeleme is only a convenience layer on top of that work.