Omahub
← All plugins
D

Network Routes

by Denis Marques

Manage Wi-Fi and Ethernet profiles and their persistent static routes.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
eafa622
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
eafa622
Reviewed
1 month ago

The plugin manages NetworkManager profiles and static routes through a bundled bash helper invoked with explicit argument arrays, and no shell injection, obfuscation, hidden persistence, or destructive install-time behavior was found. The deterministic scan found nothing, and the independent review agrees there is no malicious code. The only risk is the intended, user-initiated ability to change persistent network configuration.

  • The helper performs privileged NetworkManager modifications, but only in response to explicit UI actions and with input validation; values are passed as argv rather than evaluated by a shell.
  • Routes added through the plugin persist in NetworkManager profiles after the plugin is removed, which is clearly documented in the README and is an expected side effect of the plugin's purpose.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/denisdmarques/omarchy-network-routes --enable
System #bar #quickshell #system

Network Routes for Omarchy

Widget da barra do Omarchy para gerenciar perfis Wi-Fi e Ethernet do NetworkManager e suas rotas estáticas persistentes.

Recursos

  • Lista perfis Wi-Fi e cabeados, priorizando os que estão ativos
  • Conecta e desconecta perfis existentes
  • Lista separadamente rotas IPv4 e IPv6 de cada perfil
  • Adiciona rotas com destino CIDR, gateway opcional e métrica opcional
  • Remove rotas com confirmação
  • Reaplica as rotas sem precisar desconectar uma conexão ativa
  • Identifica perfis pelo UUID, evitando ambiguidades entre conexões com o mesmo nome
  • Modo de privacidade para ocultar nomes e rotas durante capturas ou compartilhamento de tela

Screenshots

Gerenciamento de perfis e rotas estáticas

Seleção de rotas IPv6

As rotas são gravadas diretamente em ipv4.routes ou ipv6.routes do perfil do NetworkManager. Portanto, continuam associadas àquele Wi-Fi ou perfil cabeado e são restauradas nas conexões futuras.

Requisitos

  • Omarchy 4 ou mais recente
  • NetworkManager e nmcli
  • Agente Polkit do Omarchy ativo para autorizar alterações quando necessário

Instalação

Instale e habilite diretamente do GitHub:

omarchy plugin add https://github.com/denisdmarques/omarchy-network-routes.git --enable

Para testar diretamente a cópia local:

mkdir -p ~/.config/omarchy/plugins
ln -s "$PWD" ~/.config/omarchy/plugins/io.github.denisdmarques.network-routes
omarchy-shell shell rescanPlugins
omarchy plugin enable io.github.denisdmarques.network-routes
omarchy bar move io.github.denisdmarques.network-routes --section right

Remoção

Remova o plugin e sua entrada da barra com:

omarchy plugin remove io.github.denisdmarques.network-routes

O comando remove apenas os arquivos do plugin. As rotas já gravadas nos perfis do NetworkManager permanecem configuradas até serem removidas pelo próprio NetworkManager.

Uso

  1. Clique no ícone de rotas na barra.
  2. Selecione um perfil Wi-Fi ou cabeado.
  3. Escolha IPv4 ou IPv6.
  4. Informe o destino em CIDR; gateway e métrica são opcionais.
  5. Clique em Adicionar rota.
  6. Se a conexão já estiver ativa, clique em Aplicar agora.

Exemplos:

Família Destino Gateway Métrica
IPv4 10.20.0.0/16 192.168.1.1 100
IPv4 172.16.30.8/32 vazio 50
IPv6 fd00:20::/64 fe80::1 100

O widget não cria novos perfis Wi-Fi nem solicita senhas: essa parte permanece com o painel nativo omarchy.network. Ele gerencia os perfis já salvos e as rotas específicas de cada um.

Configuração

O intervalo de atualização pode ser alterado pela barra:

omarchy bar set io.github.denisdmarques.network-routes refreshIntervalSec 10

Para ocultar temporariamente nomes de perfis e detalhes de rotas durante uma captura ou compartilhamento de tela:

omarchy bar set io.github.denisdmarques.network-routes privacyMode true --json

Restaure a exibição normal com:

omarchy bar set io.github.denisdmarques.network-routes privacyMode false --json

Desenvolvimento

O helper pode ser usado separadamente:

./network-routes list
./network-routes routes UUID 4
./network-routes add UUID 4 10.20.0.0/16 192.168.1.1 100
./network-routes delete UUID 4 "10.20.0.0/16 192.168.1.1 100"
./network-routes apply UUID

Licença

MIT. Consulte LICENSE.