gitwtfhub

wtf is openwrt-starwatch?

keithah/openwrt-starwatch — explained in plain English

Analysis updated 2026-05-18

6GoAudience · ops devopsComplexity · 4/5Setup · moderate

TL;DR

A self-hosted dashboard that monitors a Starlink dish from an OpenWrt or GL.iNet router, working fully offline with no cloud account needed.

Mindmap

mindmap
  root((Starwatch))
    What it does
      Monitors Starlink dish
      Tracks WAN telemetry
      Raises alerts
    Tech stack
      Go daemon
      LuCI plugin
      GL.iNet plugin
    Use cases
      Local dashboard
      Offline monitoring
      Route management
    Audience
      OpenWrt users
      GL.iNet owners
      Router admins

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor a Starlink dish's connection health directly from your home router without any cloud service.

REASON 2

Get alerts when the dish loses connection or something goes wrong with WAN telemetry.

REASON 3

View live and historical dish telemetry from a phone or laptop on the local network.

REASON 4

Set up automatic dish routing on a GL.iNet or OpenWrt router without extra configuration.

What's in the stack?

GoOpenWrtLuCIGL.iNet SDKgRPC

How it stacks up

keithah/openwrt-starwatchbeastmastergrinder/turbopuffer-engine-opensourceca-x/nowledge-mem-snap
Stars666
LanguageGoGoGo
Setup difficultymoderatemoderatemoderate
Complexity4/55/53/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Only supports one router architecture through the public feed, other setups require building packages yourself.

Wtf does this do

Starwatch is a tool that lets you keep an eye on a Starlink satellite dish from a home router, without needing any cloud account or outside internet connection to work. It is built for routers running OpenWrt or GL.iNet firmware, and it runs as a small program written in Go that talks directly to the Starlink dish over its local network connection. Once installed, Starwatch reads data from the dish and combines it with information about the router's internet connection, then keeps a history of that data over time. It can check for problems and raise alerts when something looks wrong. All of this is shown through a web based dashboard built into the daemon itself, which you can open directly in a browser or reach through menus inside LuCI, the OpenWrt web interface, or the GL.iNet admin panel. Access to the dashboard requires a token, so only people who can already log into the router can view it. Installation is done over SSH with a single command that downloads and installs the needed packages, and the installer checks which router hardware it will run on, currently supporting one type of processor architecture. The project also includes instructions for building the packages from source, which produces three separate install files: the main daemon, a LuCI plugin, and a GL.iNet plugin, each packaged in a format chosen specifically because some routers reject the more common package format. The README also documents how updates and networking are handled, including how a route to the dish is set up automatically so that traffic to it goes through the correct connection, and how this can be turned off if another program already manages that route. There are also details on how new versions of the software feed are published and signed so that people upgrading can trust what they are installing. Overall this is a specialized, technical project aimed at people who already run OpenWrt or GL.iNet routers and own a Starlink dish, rather than something written for a general audience.

Yoink these prompts

Prompt 1
Walk me through installing Starwatch on my GL.iNet router using the one line SSH installer.
Prompt 2
Explain how Starwatch's token authentication protects the dashboard on my OpenWrt router.
Prompt 3
Help me build the Starwatch opkg packages from source for a different router architecture.
Prompt 4
Show me how Starwatch decides which route to use for reaching my Starlink dish.

Frequently asked questions

wtf is openwrt-starwatch?

A self-hosted dashboard that monitors a Starlink dish from an OpenWrt or GL.iNet router, working fully offline with no cloud account needed.

What language is openwrt-starwatch written in?

Mainly Go. The stack also includes Go, OpenWrt, LuCI.

How hard is openwrt-starwatch to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is openwrt-starwatch for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.