feat(mullvad): add Mullvad VPN plugin by OCSPG · Pull Request #795 · noctalia-dev/legacy-v4-plugins

OCSPG · 2026-04-30T09:51:37Z

Summary

Adds a mullvad plugin that provides a bar widget, panel and settings UI for controlling Mullvad VPN through the mullvad CLI on Linux. Goal: replace the official Mullvad GUI on machines that already run Noctalia.

Features

Bar widget with state-driven shield icon (connected / connecting / disconnected / lockdown / error)
Left-click opens panel, right-click context menu
Panel: state header, current relay subtitle (with multihop / IP-version / lockdown / auto-connect / LAN-blocked badges), connect/disconnect button, account-expiry banner
Quick toggles: lockdown mode, auto-connect, LAN sharing
Search-first relay picker (~700 relays parsed from mullvad relay list)
Advanced section: multihop on/off + entry country, IP version
IPC handlers at plugin:mullvad: toggle, connect, disconnect, reconnect, togglePanel, refresh, status, setLocation, setLockdown
i18n: English + German

Tested on: Noctalia Shell 4.7.6, mullvad-cli 2026.1, Arch Linux. Toggling, relay selection, multihop, lockdown/auto-connect/LAN switches all round-trip with the CLI.

Disclosure

This plugin was written entirely by an LLM (Claude). I (the author of the fork, @OCSPG) don't have prior QML experience, so I'd really appreciate a structural review of the QML side - especially anything that's idiomatic for Noctalia plugins but I might have missed. I followed AGENTS.md and modeled the structure on tailscale, arch-updater and privacy-indicator, but a second pair of eyes would be good.

Happy to iterate on review feedback.

Test plan

Notes

README recommends mullvad-vpn-daemon over the full mullvad-vpn package since the plugin replaces the GUI.
Out of scope for this initial drop (flagged for future PRs): split tunneling, custom WireGuard relays, anti-censorship modes, beta program toggle, factory reset, DNS editing UI. Confirmation modal on disconnect-with-lockdown was also dropped because there's no NConfirmDialog widget yet.

🤖 Generated with Claude Code

@OCSPG

Bar widget + panel + settings to control Mullvad VPN through the `mullvad` CLI. Replaces the official Mullvad GUI on Linux desktops. Features: - Bar widget: state-driven shield icon (green=connected, yellow= connecting, red=lockdown blocking traffic, grey=disconnected) - Click opens panel (configurable: toggle vs panel) - Right-click context menu (Connect/Disconnect, Open panel, Settings) - Tooltip via TooltipService showing relay + IP when connected - Panel header: state, current relay constraint, connect/disconnect button, account-expiry banner when fewer than N days remain - Quick toggles (round-trip with the CLI): - Lockdown mode (kill switch) - Auto-connect - LAN sharing - Search-first relay picker (~700 relays). Country rows by default, expand on search. Click a row to set the relay constraint and optionally connect immediately. - Advanced (collapsed): multihop on/off + entry country, IP version - Settings UI exposes 10 knobs (refresh interval, click action, click-connects, lockdown confirm, expiry warning days, etc.) - IPC handlers at `plugin:mullvad`: toggle / connect / disconnect / reconnect / togglePanel / refresh / status / setLocation / setLockdown - i18n: English + German Disclosure: This plugin was written entirely by an LLM (Claude). The maintainer of the fork (@OCSPG) does not have prior QML experience, so structural review of the QML is appreciated. The plugin was tested manually on Noctalia Shell 4.7.6 with mullvad-cli 2026.1; toggling, relay selection, multihop, and quick toggles all round-trip with the CLI. Recommended install is the daemon-only package (mullvad-vpn-daemon) since the plugin replaces the GUI.

spiros132

Some feedback about the PR! :D

spiros132 · 2026-05-10T19:46:43Z

+		"Bar",
+		"Network",
+		"Panel",
+		"VPN"


There isn't any VPN tag, so please do not include that one since it doesn't exist.

spiros132 · 2026-05-10T19:49:56Z

+							} else {
+								parts.push(root.pluginApi?.tr("action.auto-select"))
+							}
+							var tr = root.pluginApi ? root.pluginApi.tr.bind(root.pluginApi) : function (k) { return k }


Do not use this. Just use the regular root.pluginApi?.tr("key")

spiros132 · 2026-05-10T19:51:05Z

+							}
+							var tr = root.pluginApi ? root.pluginApi.tr.bind(root.pluginApi) : function (k) { return k }
+							if (_mh) parts.push(_mhe ? tr("badges.multihop-via").replace("{country}", root._countryName(_mhe)) : tr("badges.multihop"))
+							if (_iv !== "any") parts.push(tr("badges.ip-version").replace("{version}", _iv))


Do not use replace, prefer to use translation interpolations. For example root.pluginApi?.tr("key", { foo: "bar" })

spiros132 · 2026-05-10T19:54:32Z

+				}
+			}
+
+			ListView {


Do prefer to use the noctalia widgets instead of the qml ones to keep it consistent with the rest of the shell. For example instead of ListView prefer to use NListView.

spiros132 · 2026-05-10T19:57:11Z

+	property bool relayClickConnects: _resolve("relayClickConnects", true)
+	property bool confirmDisconnectInLockdown: _resolve("confirmDisconnectInLockdown", true)
+	property var favoriteCountries: _resolve("favoriteCountries", [])
+	property int expiryWarningDays: _resolve("expiryWarningDays", 7)


I don't believe all of this boilerplate is needed. Instead prefer to use the already there reactivity of qml. For example:

readonly property var cfg: pluginApi?.pluginSettings ?? ({}) readonly property var defaults: pluginApi?.manifest?.metadata?.defaultSettings ?? ({}) readonly property string foo: cfg.foo ?? defaults.foo ?? "bar"

spiros132 · 2026-05-10T19:57:42Z

+		return fallback
+	}
+
+	onSettingsVersionChanged: {


As the comment before, I don't believe all of the _resolve functionality is needed.

spiros132 · 2026-05-10T20:00:19Z

+	property var currentLocation: null      // { country, city, hostname, ipv4, ipv6, mullvad_exit_ip }
+	property var visibleLocation: null      // populated when disconnected
+	property bool isRefreshing: false
+	property string lastToggleAction: ""


I might be wrong, but where is this lastToggleAction used?

OCSPG · 2026-05-11T10:14:53Z

Addressed the review feedback in d2d0a59c:

removed the invalid VPN tag
simplified settings bindings and removed unused lastToggleAction
replaced manual translation .replace(...) calls with interpolations
switched the relay list to NListView

Validated with jq and qmllint, restarted Noctalia locally, and confirmed the plugin still works.

spiros132 · 2026-05-11T17:19:13Z

Addressed the review feedback in d2d0a59c:
* removed the invalid `VPN` tag

* simplified settings bindings and removed unused `lastToggleAction`

* replaced manual translation `.replace(...)` calls with interpolations

* switched the relay list to `NListView`
Validated with jq and qmllint, restarted Noctalia locally, and confirmed the plugin still works.

Alright, when you feel ready that this PR is ready for review / merging in, press the ready for review to remove the PR from draft "mode".

spiros132 · 2026-05-25T23:10:11Z

Looks good to me, thank you for the PR! :D

This comment was marked as resolved.

Sign in to view

OCSPG force-pushed the add-mullvad-plugin branch from 0ff58c4 to 98de276 Compare April 30, 2026 09:59

spiros132 reviewed May 10, 2026

View reviewed changes

spiros132 marked this pull request as draft May 10, 2026 20:22

fix(mullvad): address review feedback

d2d0a59

OCSPG marked this pull request as ready for review May 24, 2026 00:27

spiros132 merged commit 8a347a2 into noctalia-dev:main May 25, 2026
2 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(mullvad): add Mullvad VPN plugin#795

feat(mullvad): add Mullvad VPN plugin#795
spiros132 merged 2 commits into
noctalia-dev:mainfrom
OCSPG:add-mullvad-plugin

OCSPG commented Apr 30, 2026

Uh oh!

This comment was marked as resolved.

spiros132 left a comment

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

spiros132 May 10, 2026

Uh oh!

OCSPG commented May 11, 2026

Uh oh!

spiros132 commented May 11, 2026

Uh oh!

spiros132 commented May 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

OCSPG commented Apr 30, 2026

Summary

Disclosure

Test plan

Notes

Uh oh!

This comment was marked as resolved.

spiros132 left a comment

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

spiros132 May 10, 2026

Choose a reason for hiding this comment

Uh oh!

OCSPG commented May 11, 2026

Uh oh!

spiros132 commented May 11, 2026

Uh oh!

spiros132 commented May 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants