- GitHub: https://github.com/annervisser/gnome-dns-switcher
- PyPi: https://pypi.org/project/gnome-dns-switcher/
Gnome appindicator (toolbar icon) tool to quickly switch between different DNS servers
- Easily available in your toolbox
- Config file to specify DNS servers Supports multiple connections and switching them separately
- Utility button to restart NetworkManager
๐ป Screenshots
Install dependencies
# Install pipx:
sudo apt install pipx
# Add pipx path to your .bashrc
pipx ensurepath
# Install dependencies to run this application
sudo apt install python3-dev libcairo2-dev libgirepository1.0-dev python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3-0.1
Install gnome-dns-switcher
pipx install gnome-dns-switcher
# Generate a default configuration
gnome-dns-switcher generate-config
# Modify the config to your needs. See config documentation below
edit ~/.config/gnome-dns-switcher.yml
Simply add &
after your command
gnome-dns-switcher &
gnome-dns-switcher --config /path/to/config.yml
# Sleep 10 seconds before starting to prevent starting up
# before network connections have been made
bash -c 'sleep 10 && gnome-dns-switcher --config ~/.config/gnome-dns-switcher.yml'
The config file allows you to specify which DNS servers to show and what devices are visible.
By default, gnome-dns-switcher looks for a config file at ~/.config/gnome-dns-switcher.yml
To generate and example configuration, you can run gnome-dns-switcher generate-config
servers: # DNS Server options to show
# DHCP is always shown as the first option
Quad9: 9.9.9.9
CloudFlare: [1.1.1.1, 1.0.0.1]
Google DNS:
- 8.8.8.8
- 8.8.4.4
devices: [] # Specify device names here if you want to hide certain devices (ip link show)
- The name is only used for displaying
- You can define one or more ips, as a yaml array or as a comma-seperated string
- optional, will display all non-bridge connections if not present or empty
- one or more devices to show in the switcher
- List all your devices by running
ip link show
in a terminal
- List all your devices by running
Set up virtualenv:
virtualenv venv
source venv/bin/activate
Install dependencies:
python setup.py install
pip install vext vext.gi
python -m gnome_dns_switcher