Mozilla VPN
Bar widget for Omarchy Quattro that toggles
Mozilla VPN and selects a city
target through the mozillavpn CLI.
Requirements
- Mozilla VPN installed with
mozillavpnonPATH - An authenticated Mozilla account (
mozillavpn statusshould showUser status: authenticated) - Omarchy Quattro /
omarchy-shell
This plugin shells out to mozillavpn (status, servers, select,
activate, deactivate, ui) and, only when choosing a first-time default
city, to curl https://ipinfo.io/json while the VPN is disconnected. Privacy
toggles update dnsProviderFlags in ~/.config/mozilla/vpn.moz (the same
settings the Mozilla VPN app uses). It does not require root or sudo.
Install
omarchy plugin add https://github.com/davydotcom/omarchy-mozilla-vpn-plugin.git --enable
To place it on the bar explicitly:
omarchy plugin enable io.github.davydotcom.mozilla-vpn --section right --after omarchy.network
Usage
- Left click: open the panel
- Right click: toggle VPN on/off
- Middle click: refresh status
- Panel switch: toggle VPN
- Privacy: block ads, trackers, and malware (Mozilla DNS filters). If the VPN is connected, it reconnects so the change applies
- City list: select a city and connect (remembers recent cities)
- First run with no saved city: while disconnected, picks the nearest Mozilla VPN city from your public IP location
- Keyboard:
ttoggles,/focuses search, arrows move, Enter activates, Escape closes
Trust mozillavpn status / the moz0 interface if the Mozilla GUI looks
stale after a CLI connect.
Remove
omarchy plugin remove io.github.davydotcom.mozilla-vpn
License
MIT. See LICENSE.