Update Check Widget

This widget checks for available updates using Windows Update and Winget.

[!IMPORTANT]
Winget must be installed and configured to use this widget, otherwise it will not work.

Options

Windows Update Options

Option Type Default Description
enabled boolean false Enable Windows Update checking.
label string '{count}' Format string for the widget label. {count} shows update count.
tooltip boolean true Whether to show the tooltip on hover.
interval integer 1440 Check interval in minutes (30 to 10080).
exclude list [] List of updates to exclude from checking.

Winget Update Options

Option Type Default Description
enabled boolean False Enable Winget package update checking.
label string '{count}' Format string for the widget label. {count} shows update count.
tooltip boolean True Whether to show the tooltip on hover.
interval integer 240 Check interval in minutes (10 to 10080).
exclude list [] List of packages to exclude from checking.

Widget Shadow Options

Option Type Default Description
container_shadow dict None Container shadow options.
label_shadow dict None Label shadow options.

Click Handlers

  • Left-clicking the Winget widget will open the Winget package manager in PowerShell or pwsh.
  • Left-clicking the Windows Update widget will open the Windows Update settings.
  • Right-clicking the Winget widget will run check for updates.
  • Right-clicking the Windows Update widget will run check for updates.

Example Configuration

update_check:
  type: "yasb.update_check.UpdateCheckWidget"
  options:
    windows_update:
      enabled: true
      label: "<span>\uf0ab</span> {count}"
      interval: 240
      exclude: []
    winget_update:
      enabled: true
      label: "<span>\uf0ab</span> {count}"
      interval: 60
      exclude: []
    label_shadow:
      enabled: true
      color: "black"
      radius: 3
      offset: [ 1, 1 ]

Available Styles

.update-check-widget {}
.update-check-widget .widget-container {}
.update-check-widget .widget-container.winget {}
.update-check-widget .widget-container.windows {}
.update-check-widget .label {}
.update-check-widget .icon {}

Example

.update-check-widget {
    padding: 0 6px 0 6px;
}
.update-check-widget .icon {
    font-size: 14px;
}
.update-check-widget .widget-container.winget,
.update-check-widget .widget-container.windows {
    background: #eba0ac;
    margin: 6px 2px 6px 2px;
    border-radius: 8px;
    border: 2px solid #f38ba8;
}
.update-check-widget .widget-container.windows {
    background: #b4befe;
    margin: 6px 2px 6px 2px;
    border-radius: 8px;
    border: 2px solid #89b4fa;
}
.update-check-widget .widget-container.winget .icon,
.update-check-widget .widget-container.windows .icon {
    color: #1e1e2e;
    margin: 0 1px 0 6px;
}
.update-check-widget .widget-container.winget .label,
.update-check-widget .widget-container.windows .label {
    margin: 0 6px 0 1px;
    color: #1e1e2e;
    font-weight: 900;
    font-size: 14px;
}