Keep your disk space on your Home Screen

Short answer: send your free disk space to WidgetDash with one HTTP request, then add the WidgetDash widget to your iPhone Home Screen or Lock Screen. It updates every time you push a new value, and it is free for up to 5 numbers.

A full disk takes down services in the most boring and avoidable way. A cron job running df can read free space and percentage used, then push both. The widget gives you a quiet runway indicator so you top up storage on your schedule, not at 3am.

Push it with one request

A source is created automatically the first time you push to it, so there is no setup step. Send your free disk space like this:

curl -X PUT https://api.widgetdash.app/api/v1/data/disk_space \
  -H "Authorization: Bearer YOUR_WRITE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "display_name": "Disk Space",
    "icon": "internaldrive.fill",
    "category": "DevOps",
    "metrics": [
      { "label": "Free", "value": "42 GB" },
      { "label": "Used", "value": "78%" }
    ]
  }'

• The value is a plain string, so format it however reads best: "$8,420", "99.98%", "+58".
• icon is an SF Symbol name. Here we use internaldrive.fill.
• Push to the same source_key again any time and the widget updates in place.

Add it to your iPhone

1. Sign up free and copy your WRITE key from the dashboard.
2. Install the WidgetDash iOS app (free on the App Store) and connect with the dashboard QR code or your READ key.
3. Long-press the Home Screen, tap +, search WidgetDash, pick a size, then choose this source.

Small Lock Screen widgets are supported too, so your free disk space can sit right under the clock.

Questions

Related widgets

See all WidgetDash use cases · How to see any number on your iPhone