Omarchy Bar Widget · v1.0.1 · MIT

Your tailnet’s HTTPS services, one glance away.

A native Quickshell widget for the Omarchy bar. Automatically discovers your Tailscale Services on port 443, probes live HTTPS reachability and latency, and opens any service in one click or keystroke.

Tailscale Services
2 of 3 reachable
Simulate:
Install & enable on Omarchy
omarchy plugin add https://github.com/digitalbase/omarchy-tailscale-services --enable

All reachable

Every discovered HTTPS service responded with HTTP 100–499 and valid TLS.

Partial availability

Some services are up while one or more failed to respond or have no active host.

Offline or error

No services responded, Tailscale is disconnected, or discovery hit an error.

Capabilities

Built for fast, private tailnet workflows

No browser bookmarks to keep in sync and no dashboards to keep pinned. Every HTTPS service your tailnet advertises shows up right where you already look.

01 / DISCOVERY

Automatic tailnet discovery

Reads local Tailscale capability advertisements directly from tailscale status --json. Any Tailscale Service advertising tcp:443 appears automatically—no hardcoded URLs, OAuth apps, or API keys.

02 / PROBING

Concurrent HTTPS health & latency

Probes up to 8 services in parallel with curl using strict TLS verification, 2s connect and 5s total timeouts. Reports HTTP status codes and round-trip latency in milliseconds.

03 / ROUTING

Active host route inference

Matches each service’s advertised IP addresses against peer PrimaryRoutes—including routes hosted by your local machine—so you know which server is currently answering.

04 / KEYBOARD

Keyboard-native Quickshell panel

Built on Omarchy’s KeyboardPanel. Move with arrow keys, hit Enter to launch via xdg-open, press R to refresh, or right-click the bar icon for an instant background re-probe.

05 / AUTOMATION

Hyprland & Quickshell IPC ready

Exposes open, close, toggle, and refresh IPC actions under io.github.digitalbase.tailscale-services so you can bind your tailnet service drawer to any Hyprland shortcut.

06 / HARDENED

Bounded memory & clean reaping

Enforces strict size caps before JSON parsing (4 MiB status input, 256 KiB panel output) with a 10s deadline that cleanly kills and reaps hung subprocesses.

Interaction

Zero-friction mouse & keyboard controls

Designed to feel indistinguishable from Omarchy’s built-in shell panels.

Left-click bar icon Open or close the Tailscale Services drawer
Right-click bar icon Trigger an immediate background re-probe
↑ ↓ Move selection across discovered services
Enter Open the selected service URL via xdg-open
R Refresh service discovery and HTTPS probes
Esc Dismiss the panel
What appears in the list

This widget specifically lists Tailscale Services advertised on tcp:443 and visible to your signed-in Tailscale user.

  • Tailscale Services with tcp:443 in local capability maps
  • Active host inference via peer PrimaryRoutes (including local device)
  • Quick link to login.tailscale.com/admin/services via the Admin button
  • Ordinary per-device Tailscale Serve endpoints or arbitrary non-443 ports
  • Services hidden by your tailnet ACL / access policy

Note: Reachability checks verify TLS and HTTP responsiveness (100–499)—not deep application health. If discovery fails, the panel keeps the last known list visible alongside an error banner.

Setup

Up and running in 30 seconds

Requires Omarchy Quattro with its Quickshell plugin system, plus a signed-in Tailscale client with MagicDNS enabled.

STEP 01

Ensure dependencies

Needs Python 3, curl, Tailscale, and xdg-utils. Install anything missing via Omarchy.

omarchy pkg add python curl tailscale xdg-utils
STEP 02

Add & enable the plugin

Installs cleanly into ~/.config/omarchy/plugins/ and places the widget on the right side of your bar.

omarchy plugin add https://github.com/digitalbase/omarchy-tailscale-services --enable
STEP 03

Tune refresh interval (optional)

Polls every 60s by default (and on open if stale >15s). Add refreshSeconds (min 15) to its entry in ~/.config/omarchy/shell.json.

{ "id": "io.github.digitalbase.tailscale-services", "refreshSeconds": 120 }
Lifecycle commands
Update
omarchy plugin update io.github.digitalbase.tailscale-services
Disable
omarchy plugin disable io.github.digitalbase.tailscale-services
Remove cleanly
omarchy plugin remove io.github.digitalbase.tailscale-services

Privacy & Hardening

Zero credentials. Zero state on disk.

Tailnet metadata is sensitive. The plugin is engineered to stay strictly in memory and never leak private hostnames or CLI output.

No API keys or OAuth clients

Everything comes from your active local Tailscale session. Removing the plugin leaves behind no daemon, config file, or stored secret.

Hardened curl probes

Probes pass --disable, --noproxy "*", and --proto =https—ignoring ~/.curlrc and proxy variables, verifying TLS certificates, sending no credentials, and never following redirects.

Redacted error handling

Raw Tailscale status JSON and CLI stderr are never echoed into the panel UI, and the helper runs unprivileged under your normal user account.

Technical specification
Plugin ID
io.github.digitalbase.tailscale-services
Widget kind
bar-widget (default: right section)
Discovery source
tailscale status --json (CapMap)
Port filter
tcp:443 HTTPS Tailscale Services
Concurrency
Up to 8 parallel HTTPS GET / probes
Timeouts
2s connect · 5s total · 10s status deadline
Reachable codes
HTTP 100–499 (incl. login prompts)
Unreachable
HTTP 500–599, TLS error, or timeout
Refresh cadence
Every 60s (configurable, min 15s)
Capacity limits
128 services · 1,024 peers · 256 KiB output
License
MIT (community plugin)