(Widget) Update Check

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 .widget-container.paired {}
.update-check-widget .label {}
.update-check-widget .icon {}

State Classes

When both Windows Update and Winget containers are visible, each container gets the paired class. This is intended for styling the inner gap between the two buttons without affecting the outer margins.

Example to keep 4px outer margin and 4px inner gap:

.update-check-widget .widget-container.winget,
.update-check-widget .widget-container.windows {
  margin: 4px;
}

.update-check-widget .widget-container.winget.paired { margin-right: 2px; }
.update-check-widget .widget-container.windows.paired { margin-left: 2px; }

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;
    border-radius: 8px;
    border: 2px solid #f38ba8;
}
.update-check-widget .widget-container.winget.paired {
    margin-right: 1px;
}
.update-check-widget .widget-container.windows.paired {
    margin-left: 1px;
}
.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;
}