Name: roamr
Author: Sourabh Khot

ROAMR(1)WiFi Picker ManualROAMR(1)

         ██   ██████    █████    █████   ██   ██  ██████
      ██ ██   ██   ██  ██   ██  ██   ██  ███ ███  ██   ██
   ██ ██ ██   ██████   ██   ██  ███████  ██ █ ██  ██████
██ ██ ██ ██   ██  ██   ██   ██  ██   ██  ██   ██  ██  ██
██ ██ ██ ██   ██   ██   █████   ██   ██  ██   ██  ██   ██

find the best WiFi where you are — full bars ≠ good

NAME

roamr — read your saved WiFi networks, score them for real quality, and say which to use.

SYNOPSIS

roamr [--why] [--json] [--demo] roamr <current | list | watch>

DESCRIPTION

A network can show 100% signal and still be the worst one to be on — 2.4 GHz, an old WiFi standard, a crowded channel — and your OS stays parked on it, because it never re-checks quality once connected.

roamr weighs signal, band, congestion, WiFi standard and live latency across your saved networks and names the best one, with reasons. It is passive: it reads and advises, never touching your connection — you switch from your OS's WiFi menu.

EXAMPLE

$ roamr --why

→ Switch to Office-6E — clearly better here.

  Office-6E             ▀▀▀▀▁  86%  6GHz   ax    score  95
      - 6 GHz — fast, uncongested
      - channel is clear
  Office-5G             ▀▀▀▀▀  92%  5GHz   ax    score  93
      - strong signal (-54 dBm)
  Office-Guest          ▀▀▀▁▁  68%  5GHz   ac    score  81
▸ Office-2G             ▀▀▀▀▀ 100%  2.4GHz n     score  69
      - 2.4 GHz — slower, more interference
      - WiFi 4 — older, slower standard

You're on the 100%-signal network (▸) — and it ranks last. That gap is the whole point.

MENU BAR (macOS)

Prefer not to live in the terminal? A companion menu-bar app keeps the live ranked list and the "why" one click away — quality-coloured scores, signal bars, and an amber cue when a network is durably better.

◔ roamr  ▾   — sits in your macOS menu bar
──────────────────────────────────
→ Switch to Office-6E
  Office-6E   ▀▀▀▀▁   95
  Office-5G   ▀▀▀▀▀   93
▸ Office-2G   ▀▀▀▀▀   69   you're here

It reads roamr watch --json, so all the scoring stays in the CLI; like the CLI, it only advises and never switches for you. Built with make app (Swift, no Xcode required).

COMMANDS

roamr           recommend the best saved network here (default)
roamr current   diagnose the network you're on (latency/jitter)
roamr list      list saved networks and their scores
roamr watch     monitor; suggest a switch only when durably better
roamr speedtest measure real download throughput of the current network

flags:  --why explain scores   --json machine-readable   --demo no hardware

PLATFORMS

macOS      signed CoreWLAN helper (macwifi)    working
linux      nmcli (NetworkManager)              preview
windows    native WLAN API (wlanapi)           working

AUTHOR

Written by Sourabh Khot.

REPORTING BUGS

Issues and pull requests: github.com/sourabh-khot65/roamr/issues