# Tidbyt Unraid

Tidbyt Unraid is a self-contained, fully local Docker app that displays live Unraid server metrics on your Tidbyt device, querying the official Unraid GraphQL API (Unraid 7.2+) and pushing a rendered image to the. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3396/tidbyt-unraid

## Description

Tidbyt Unraid is a self-contained, fully local Docker app that displays live Unraid server metrics on your Tidbyt device, querying the official Unraid GraphQL API (Unraid 7.2+) and pushing a rendered image to the display over WiFi.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

33/100 (Low), based on 4 of 4 factors.
- Maintained: 54 (last commit 188 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/tidbyt-unraid-0tg4gyk1mpoyds?q=tidbyt-unraid

## Common questions

### How do I control how often the metrics refresh?

Set the UPDATE_INTERVAL environment variable in seconds. The container queries Unraid, renders the image, pushes it, then sleeps for that interval.

### How many metrics can I enable on the display?

Only the first four enabled metrics are displayed. The renderer uses a full screen, side-by-side, split, or 2x2 grid depending on the count.

### What image format and size does it push to the Tidbyt?

It builds a 64x32 WebP image with PIL. The image is sent to the Tidbyt via its HTTP API.

### Can I build the image locally instead of pulling it?

Yes, use docker build -t tidbyt-unraid:latest . in the repository. Then update the image name in docker-compose.yml to use the local build.

### Does the app need a cloud service to push updates?

No, it runs locally and pushes directly to the Tidbyt over WiFi. It fetches metrics from the Unraid GraphQL API and sends the rendered image to the device.

---
Source: Our Local Host (https://ourlocalhost.com/app/3396/tidbyt-unraid), the self-hosted and open-source app directory.
