Skip to content

ChDNSChanger v3.3.1

Latest
Latest

Choose a tag to compare

View all tags
@Ch4120N Ch4120N released this 20 Jun 13:50
v3
f77e5d9

ChDNSChanger v3.3.1 – Release Notes

Release Date: June 2026
Author: Ch4120N
Contact: Ch4120N@Proton.me

🎉 Highlights

This release brings significant improvements to Windows adapter detection, ensuring that VirtualBox, VMware, VPN, and other virtual network adapters are now correctly ignored — the tool will always target your real physical connection. Both the CLI and GUI have been updated with this fix, along with refined user interface enhancements.

🆕 What’s New

🔧 Critical Fix – Virtual Adapter Filtering on Windows

  • Fixed: VirtualBox Host‑Only adapters (and similar virtual interfaces) were mistakenly selected as the active interface, causing DNS changes to apply to the wrong network.
  • Solution: The Windows DNS manager now queries WMI using PhysicalAdapter=TRUE to get only real hardware adapters, with a fallback to the previous keyword‑based filter.
  • Impact: Your actual Wi‑Fi or Ethernet connection is now reliably detected, regardless of installed virtualisation software.

✨ CLI Improvements

  • Enhanced colour palette and decorators for better readability.
  • Adaptive 3‑column menu layout that adjusts to terminal width.
  • Clearer status messages when no DNS servers are detected.
  • Ping test now offers immediate feedback before applying DNS.

🖥️ GUI Enhancements

  • Full custom title bar with minimise/close buttons and window dragging.
  • Real‑time activity log with timestamps and colour‑coded messages.
  • “Check for Updates” feature pings the GitHub API for newer versions.
  • All action buttons are automatically disabled when not running as administrator/root.
  • About dialog with feature list and license information.

📦 Files & Packages

The release contains the full source code of ChDNSChanger. It is a Python application that runs on Windows, Linux, and macOS. Pre‑compiled binaries are provided for Windows, Linux — simply run the scripts with Python 3.7+.

Download Options

File Description
ChDNSChanger-v3.3.1.zip Complete source code (extract and run)
servers.json Sample provider configuration file (You need to copy into config/ directory)

⚙️ Installation & Usage

  1. Install Python 3.7+ if not already available.
  2. Install dependencies: 
    python -m pip install -r requirements.txt
  3. Run the CLI (as Administrator/root): 
    sudo python3 chDNSChanger.py   # Linux/macOS
python chDNSChanger.py         # Windows (run as Admin)
  4. Launch the GUI: 
    sudo python3 chDNSChanger.GUI.py

See the README for detailed platform‑specific instructions.

🐛 Known Issues

  • On some older Windows 7 systems, the WMI PhysicalAdapter query may fail to return results; the tool will then fall back to the keyword filter, which is less reliable.
  • The GUI requires PyQt5 to be installed. If you encounter import errors, run pip install PyQt5.
  • macOS users must grant Terminal network permissions when using networksetup.

❤️ Support & Feedback

If you find this tool useful, please consider starring the repository on GitHub.
For bug reports, suggestions, or just a “thank you”, email Ch4120N@Proton.me.

Thank you for using ChDNSChanger!
— Ch4120N

Assets 4
Loading