Skip to content

Add Network Toolkit plugin - #528

Open
brightestautumn wants to merge 17 commits into
noctalia-dev:mainfrom
brightestautumn:network-toolkit-plugin
Open

Add Network Toolkit plugin #528
brightestautumn wants to merge 17 commits into
noctalia-dev:mainfrom
brightestautumn:network-toolkit-plugin

Conversation

@brightestautumn

Copy link
Copy Markdown
Contributor

Plugin

  • Id: autumn/network-toolkit
  • New plugin
  • Update to an existing plugin (version bumped in plugin.toml)

What it does

A unified control panel and bar widget to manage Wi-Fi, Ethernet, Hotspot, Bluetooth, and DNS in one place.
What it includes:

  • Live Wi-Fi scanning, password connect dialogs, saved network handling, and network details.
  • Concurrent Wi-Fi station + AP hotspot creation via scripts/hotspot_helper.sh (creates <interface>-ap using iw so you can host a hotspot while staying connected to your Wi-Fi network).
  • Native BlueZ D-Bus agent via scripts/bluetooth_helper (handles PIN/passkey pairing requests directly on the D-Bus system bus for reliable desktop pairing popups).
  • Persistent DNS switcher (Cloudflare, Google, Quad9, AdGuard, custom) that stays on through network switches and reboots.
  • QR code generation to share Wi-Fi and Hotspot connections.
  • Bar widget with configurable display modes and a quick-toggle shortcut.

External dependencies

  • networkmanager (nmcli) — Wi-Fi scanning, connection handling, hotspot setup, and DNS configuration.
  • bluez / bluez-utils (bluetoothctl) — Bluetooth adapter power, device pairing, trust, and discovery.
  • iproute2 (ip) — Interface addressing and neighbor client detection.
  • iw — Virtual AP interface creation and wireless client enumeration.
  • qrencode — Generates QR codes for Wi-Fi and Hotspot sharing.

Testing

  • Tested on Niri
  • Tested on Hyprland
  • Tested on Sway
  • Tested on another compositor:
  • Noctalia version tested against: 5.0.0 beta.9
  • Plugin API level: 10

Screenshots / Videos

IMG_20260829_231403

Checklist

Ready-for-review requirement: Every box in this section must be checked. If any statement is not true, keep the
pull request as Draft. An explanation does not replace a required check.

  • The directory name matches the part of id after the / in plugin.toml exactly.
  • It ships plugin.toml, README.md, thumbnail.webp, and translations/en.json.
  • README.md follows the
    README template, documents
    every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
  • I created thumbnail.webp with the thumbnail generator.
  • version follows semver and is bumped in this PR; plugin_api is the oldest API level this plugin requires.
  • Every non-English translation in this PR uses a locale supported by Noctalia core, and I can read, write, and
    understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
  • I did not edit catalog.toml; CI generates it.
  • This PR touches exactly one plugin directory.

Code review attestation

Plugins run as trusted, unsandboxed Luau in the user's session. Confirm:
Ready-for-review requirement: Every attestation below must be checked.

  • The code is readable and not obfuscated, minified, or generated.
  • It does not download and execute remote code.
  • Every network call, filesystem write, and spawned process is something the description above accounts for.
  • I have the right to publish this code under the license declared in plugin.toml.

@brightestautumn brightestautumn changed the title feat: add new Network Toolkit plugin Add Network Toolkit plugin Aug 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant