keithah/openwrt-starwatch

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.