User Guide

Router login

See what your router knows

Network Weather can talk to your router to pull in extra info: how many devices are connected, what their names are, WAN status, port mappings. This is optional, but a logged-in router gives a much fuller picture.

What you get without logging in

Even with no credentials, the app already detects your gateway through several layers:

  • MAC vendor lookup identifies the brand (Ubiquiti, Netgear, ASUS, TP-Link, Linksys, Eero, etc.).
  • Reverse DNS of the gateway IP often returns a model hint (e.g., RT-AX1800S.local, UDM-Pro.local).
  • HTTP/HTTPS fingerprinting reads the router's web UI title, HTTP Server header, and TLS certificate to pin down the model.
  • SSDP/UPnP discovery asks the gateway directly for its manufacturer, model, serial, and firmware.
  • UPnP IGD queries the WAN IP, connection status, link speed, and any active port mappings.

All of that runs without authentication on most consumer routers. You don't have to do anything.

What logging in adds

For supported vendors, signing in unlocks the rest:

  • Connected device counts and names
  • AP names on mesh systems (e.g., "Living Room AP")
  • Per-port stats and link speeds
  • Switch port assignments
  • WAN-side connection details the router can see but UPnP doesn't expose

Which routers support login

Brand What you get
UniFi Full client list, AP/switch port info, MFA-aware login

Other vendors (TP-Link, ASUS, Netgear, Eero, Linksys, MikroTik) are on the Windows roadmap. Even without login, basic identification and UPnP-derived data still work for those brands.

If your router isn't supported for credentialed login, the app shows whatever the unauthenticated layers picked up.

How to log in (UniFi today)

  1. Open the Network Weather window and click the Settings tab.
  2. Find the gateway login section (or click the Gateway segment on the Status tab and choose Set credentials).
  3. Enter your local UniFi admin username and password — not your Ubiquiti cloud account, unless you've enabled local access using cloud credentials.
  4. If your account has MFA enabled, you'll be prompted for the second factor.
  5. Click Save.

Your credentials are stored locally and encrypted with the Windows Data Protection API (DPAPI) — they're tied to your Windows user account and never leave your PC. They live in %LOCALAPPDATA%\NetworkWeather\credentials.ini (encrypted; not human-readable).

Changing or removing credentials

Open the gateway login dialog and clear both fields, then save. The encrypted entry is removed from credentials.ini.

Troubleshooting

"Login failed" with the right password. Some routers only allow one admin session at a time. Close the router's web UI in your browser and retry.

Router shows as "Unknown Gateway". Make sure you're on your home network, not on a VPN or phone hotspot. Some ISP-provided routers use unusual configurations that the app can't fully integrate with. Monitoring still works; you just won't get the extra router-side details.

UniFi MFA loops. If your UniFi controller asks for MFA on every login, that's expected — the app prompts for the OTP each time. Generated tokens aren't cached for security.