Lanarchy arrive sur le Marketplace Omarchy
Lanarchy arrive sur le Marketplace Omarchy
Source: Donnie (@dkfiander) — post du 20 septembre 2026
Happy to announce that my plugin was finally accepted by the Omarchy Marketplace. Check out Lanarchy — https://plugins.omarchy.org/plugin.html?id=donnie.homelab-mesh
Lanarchy (donnie.homelab-mesh)
Homelab status in the Omarchy bar — who is up, what sits behind Caddy, and what just appeared on the LAN.
No typing IPs. Search the network, add boxes from UniFi / mDNS, keep .lan names as reverse-proxy hosts. Map reads left to right; Flow shows measured rates, not decoration.
- Auteur : Donnie Fiander
- Version : 0.4.3
- Licence : MIT
- Catégorie : Widgets (bar widget)
- Tags : bar, quickshell, system
- Statut : Disponible, vérifié par le marketplace (baseline passée)
- Dépôt : https://github.com/DonnieFi/OmarPlugs
- Page marketplace : https://plugins.omarchy.org/plugin.html?id=donnie.homelab-mesh
L’idée
Un lab n’est pas une simple liste d’IP. Il y a de vraies machines (et VMs), une porte d’entrée Caddy (ou Traefik) et une pile de noms *.lan qui résolvent tous vers le même proxy.
Lanarchy garde tout ça clair :
| Type | Exemple | Rôle |
|---|---|---|
| machine | yanagiba @ .92, homeassistant @ .178 | SSH / ICMP / télémétrie |
| host | ha.lan, git.lan | Noms de services, souvent via reverse proxy |
| proxy | URL de santé Caddy | Check HTTP 2xx/3xx ou TCP |
Installation
omarchy plugin add https://github.com/DonnieFi/OmarPlugs.git --enable
omarchy bar move donnie.homelab-mesh --section right
omarchy-shell lanarchy open
# ou
omarchy-shell shell summon donnie.homelab-mesh
Ce que fait « Search network »
Rebuild snapshot.discover[] à partir de trois sources fusionnées :
| Source | Signification | Classification |
|---|---|---|
| UniFi | Clients filaires depuis le Cloud Gateway / UDM | Privilégie machine (supprime les MAC tails, les phones / caméras / TV / Chromecast) |
| mDNS | avahi-browse (_ssh, _home-assistant, …) | machine ou host selon le type de service |
| ARP | ip neigh avec une MAC | host en repli |
- L’inventaire connu (ids, dns, labels, ip/mac statiques) est filtré.
- UniFi l’emporte sur mDNS/neigh pour le même appareil ; les machines s’affichent en premier.
- Sans secrets UniFi, Search fonctionne toujours avec mDNS + ARP, avec des noms plus faibles.
Alerte nouveau périphérique
Lanarchy se souvient de chaque MAC vu. Un appareil qui apparaît plus tard est annoncé une fois et listé dans un tiroir NEW ON YOUR NETWORK, avec adopt et ignore.
| Règle | Pourquoi |
|---|---|
| Le premier run enregistre une baseline silencieusement | Tout est nouveau la première fois qu’on regarde |
| Un appareil doit être vu deux fois | Une entrée ARP ponctuelle n’est pas une arrivée |
| Annoncé exactement une fois | Répéter, c’est harceler, pas alerter |
| N’importe quel appareil adopté ou ignoré est retiré | Un appareil traité n’est plus une nouveauté |
Configuration
Réglage du widget bar (aussi dans shell.json) :
| Clé | Défaut | Notes |
|---|---|---|
refreshIntervalSec | 15 | 5–120 |
L’état runtime vit sous ~/.local/state/lanarchy/ (ou $XDG_STATE_HOME/lanarchy). Il n’est jamais écrit dans l’arbre d’installation du plugin — sinon le panneau se recharge en hot-reload à chaque probe.