What is truenasstate?

TrueStats is a lightweight macOS app that lives in the menu bar and lets you monitor a TrueNAS SCALE server at a glance. TrueNAS SCALE is a popular open source network attached storage system used at home or in small businesses to manage disks, data pools, and self hosted applications. Instead of opening a browser and logging into the NAS web interface, TrueStats sits quietly in your Mac's status bar and shows a count of active alerts, so you always know if something needs attention. Clicking the menu bar icon opens a popover dashboard showing system information, the health of your storage pools, any active alerts, and a list of your installed apps, each with live CPU and memory usage. The data updates in real time using the TrueNAS WebSocket API, with a snapshot refresh every 30 seconds. You can also trigger app upgrades and check for system updates directly from the menu without opening a browser. Credentials are stored securely in the macOS Keychain rather than in plain configuration files, and the endpoint URL is kept in the app's local settings. If your TrueNAS server uses a self signed certificate, the README walks through exporting that certificate from your browser and marking it as trusted in macOS Keychain Access, since otherwise the app's connection will fail with a certificate error. The app requires macOS 14.0 or later and a TrueNAS SCALE server reachable over HTTPS with an API key tied to a specific user account. It is built in Swift with SwiftUI for the popover views, and it runs purely as a status bar agent with no Dock icon or main window. You would use this tool if you run a TrueNAS SCALE server at home or in a small office and want a low friction way to keep an eye on your storage health and installed apps from your Mac without switching windows. The project is released under the Apache License 2.0.