Skip to content

Replace Impala with nettui for network controls#5040

Open
skibidiandulka wants to merge 3 commits intobasecamp:devfrom
skibidiandulka:fix/network-click-no-wifi
Open

Replace Impala with nettui for network controls#5040
skibidiandulka wants to merge 3 commits intobasecamp:devfrom
skibidiandulka:fix/network-click-no-wifi

Conversation

@skibidiandulka
Copy link

@skibidiandulka skibidiandulka commented Mar 16, 2026

This PR replaces Impala with nettui as Omarchy's network TUI.

Why

Omarchy currently routes its top-bar network action to a Wi-Fi-only TUI.
nettui keeps the same iwd-first approach, but extends it into a single network TUI for both Wi-Fi and Ethernet.

This project is heavily inspired by Impala and intentionally stays close to Impala's interaction model and backend philosophy.
It is not meant to replace that model with something foreign. If anything, nettui is much closer to an Impala-derived network TUI than to a clean-sheet rewrite: the same general Wi-Fi workflow, extended with integrated Ethernet support and Omarchy-specific polish.

What changed

  • replaced impala with nettui in install/omarchy-base.packages
  • updated omarchy-launch-wifi to launch nettui
  • renamed the Omarchy UI entry from Wifi to Network
  • renamed the keybinding label from Wifi controls to Network controls
  • added a dedicated Hyprland floating size for org.omarchy.nettui
  • enabled systemd-networkd.service in the network setup path
  • added a migration that installs nettui and removes impala
  • documented the single network click path in docs/network-click-behavior.md

Why this is a better fit for Omarchy

  • one TUI for Wi-Fi and Ethernet
  • better match for Omarchy's single network entry point
  • stays very close to the Impala-style iwd workflow
  • avoids splitting network management across separate tools

Important note

This PR requires nettui to be published in pkgs.omarchy.org before merge.
Without that package source, replacing impala in the Omarchy installer would break the official install path.

Nettui is available at: https://github.com/skibidiandulka/nettui/

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 76d587e75f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +3 to +4
if omarchy-cmd-missing nettui; then
omarchy-pkg-add nettui

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Enable systemd-networkd during nettui migration

This migration only installs nettui and removes impala, but it never enables systemd-networkd, even though the same commit adds sudo systemctl enable systemd-networkd.service for fresh installs in install/config/hardware/network.sh. Upgraded systems do not execute installer scripts, so users who update in place can end up with nettui installed but the required network backend still disabled, which breaks or severely limits the new network-control flow (especially Ethernet management).

Useful? React with 👍 / 👎.

@skibidiandulka
Copy link
Author

@codex review

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 75fb1db81b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines +11 to +12
if omarchy-cmd-present impala; then
omarchy-pkg-drop impala

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Gate Impala removal on successful nettui install

This migration removes impala even when omarchy-pkg-add nettui fails, because the add step's status is never used to guard the later drop path. In upgrade scenarios where nettui cannot be installed (e.g., repo lag or transient pacman failure), users lose their only network TUI and bin/omarchy-migrate will still mark this migration complete if subsequent commands succeed, so it will not be retried automatically.

Useful? React with 👍 / 👎.

@skibidiandulka skibidiandulka marked this pull request as draft March 16, 2026 21:56
@skibidiandulka
Copy link
Author

@codex review

@chatgpt-codex-connector
Copy link

Codex Review: Didn't find any major issues. Hooray!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@skibidiandulka skibidiandulka marked this pull request as ready for review March 16, 2026 22:22
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