---

name: homepage-widgets description: Configure widgets.yaml for Homepage dashboard - information widgets (resources, search, datetime, weather) and service widget types license: MIT compatibility: opencode metadata: project: homepage type: yaml-config

Homepage widgets.yaml Configuration

Reference for information widgets and service widget types.

Structure

widgets.yaml displays information widgets at page top:

Copy---
- resources:
    cpu: true
    memory: true

- search:
    provider: google

Resources Widget

Copy- resources:
    label: System
    cpu: true
    memory: true
    disk: /
    cputemp: true
    tempmin: 0
    tempmax: 100
    uptime: true
    network: true
    refresh: 3000
    expanded: true
    units: metric # or imperial
    diskUnits: bytes # or bbytes

Multiple Disks

Copy- resources:
    label: Storage
    disk:
      - /mnt/storage
      - /mnt/backup
      - /mnt/media

Resource Groups

Copy- resources:
    label: System
    cpu: true
    memory: true

- resources:
    label: Storage
    disk: /mnt/data

Search Widget

Copy- search:
    provider: google # duckduckgo, bing, baidu, brave, custom
    focus: true
    showSearchSuggestions: true
    target: _blank

Custom Provider

Copy- search:
    provider: custom
    url: https://www.ecosia.org/search?q=
    suggestionUrl: https://ac.ecosia.org/autocomplete?type=list&q=
    showSearchSuggestions: true

Multiple Providers

Copy- search:
    provider: [brave, google, duckduckgo]

DateTime Widget

Copy- datetime:
    text_size: xl # 4xl, 3xl, 2xl, xl, md, sm, xs
    locale: en
    format:
      timeStyle: short
      dateStyle: short
      hour12: true

Format Examples

Copy# 13:37
format:
    timeStyle: short
    hourCycle: h23

# 1:37 PM
format:
    timeStyle: short
    hour12: true

# 1/23/22, 1:37 PM
format:
    dateStyle: short
    timeStyle: short
    hour12: true

Weather Widgets

OpenWeatherMap

Copy- openweathermap:
    provider: openweathermap # or apiKey directly
    latitude: 36.66
    longitude: -117.51
    cache: 5

Open-Meteo (No API key)

Copy- openmeteo:
    label: Weather
    latitude: 36.66
    longitude: -117.51
    cache: 5

Service Widget Types

Common widgets for services.yaml:

Media

Automation

Downloads

Requests

Infrastructure

Monitoring

Finance

Custom

CustomAPI Widget

Copy- MyService:
    widget:
      type: customapi
      url: http://api.service/stats
      headers:
        Authorization: Bearer {{HOMEPAGE_VAR_TOKEN}}
      mappings:
        - field: data.users
          label: Users
          format: number
        - field: data.status
          label: Status

Widget with Fields

Limit displayed fields:

Copy- Sonarr:
    widget:
      type: sonarr
      url: http://sonarr.host
      key: { { HOMEPAGE_VAR_SONARR_API_KEY } }
      fields: ["wanted", "queued"]
      enableQueue: true

Complete widgets.yaml Example

Copy---
- resources:
    label: System
    cpu: true
    memory: true
    cputemp: true
    uptime: true

- resources:
    label: Storage
    expanded: true
    disk:
      - /
      - /mnt/data

- search:
    provider: duckduckgo
    focus: true

- datetime:
    text_size: xl
    format:
      timeStyle: short
      dateStyle: short

- openmeteo:
    label: Weather
    latitude: 53.5461
    longitude: -113.4938