(Widget) Dnd

Do Not Disturb Widget Configuration

A widget that allows you to monitor and toggle Windows Focus Assist (Do Not Disturb) directly from your status bar. Works natively on Windows 10 and Windows 11 via the undocumented QuietHoursSettings COM API.

Option	Type	Default	Description
label	str	"{icon}"	The primary text shown on the widget.
label_alt	str	"{icon} {status}"	The alternate text shown after calling the toggle_label callback.
class_name	str	""	A custom CSS class added to the widget container.
tooltip	bool	true	Whether to show the status tooltip on hover.
default_active_mode	str	"priority"	The mode that will be activated when toggling from "disabled". Valid options: "priority" or "alarms".
callbacks	dict	on_left: toggle_status on_right: cycle_status	Custom mouse actions mapped to widget functions.
icons	dict	disabled: "\uf0f3" priority: "\uf186" alarms: "\uf1f6"	A dictionary mapping statuses to font/icon strings.

Label Placeholders

The label and label_alt options support the following placeholders:

Placeholder	Output Example	Description
{icon}	\uf0f3	The icon corresponding to the current state.
{status}	disabled, priority, or alarms	The string identifier of the current state.

Example Configuration

dnd:
  type: "yasb.dnd.DndWidget"
  options:
    label: "{icon}"
    label_alt: "{icon} {status}"
    default_active_mode: "priority"
    callbacks:
      on_left: "toggle_status"
      on_right: "cycle_status"
    icons:
      disabled: "\uf0f3" # If you are looking for Segoe Fluent Icons, Windows 11 uses \uf285 for all states
      priority: "\uf186" 
      alarms: "\uf1f6" 

Description of Options

• label: The primary text shown on the widget. You can use placeholders like {icon} and {status}.
• label_alt: The alternate text shown after calling the toggle_label callback.
• class_name: Additional CSS class name for the widget container. This allows for custom styling.
• tooltip: Whether to show the tooltip on hover.
• default_active_mode: The mode that will be activated when toggling from "disabled" for the first time. Valid options are "priority" or "alarms". On Windows 11, priority is the default one.
• callbacks: A dictionary specifying the callbacks for mouse events. Available callbacks:
  • toggle_label: Toggles between label and label_alt.
  • toggle_status: Toggles between "disabled" and the most recent active restricted mode ("priority" or "alarms").
  • cycle_status: Cycles the mode sequentially: disabled -> priority -> alarms -> disabled.
• icons: A dictionary mapping statuses to font/icon strings. It contains:
  • disabled: Icon displayed when Do Not Disturb is disabled.
  • priority: Icon displayed when "Priority Only" is active.
  • alarms: Icon displayed when "Alarms Only" is active.

Note: On Windows 11, the native Do Not Disturb toggle button in the taskbar only switches between disabled (Off) and priority (On). The alarms state is typically only activated via Windows Settings or by using the cycle_status callback in this widget.

Style

.dnd-widget {}
.dnd-widget .widget-container {}
.dnd-widget .widget-container .label {}
.dnd-widget .widget-container .label.alt {}
.dnd-widget .widget-container .icon {}
/* Status classes */
.dnd-widget .widget-container .label.status-disabled {}
.dnd-widget .widget-container .label.status-priority {}
.dnd-widget .widget-container .label.status-alarms {}
.dnd-widget .widget-container .icon.status-disabled {}
.dnd-widget .widget-container .icon.status-priority {}
.dnd-widget .widget-container .icon.status-alarms {}

Example Style

.dnd-widget {
    padding: 0 8px;
}

.dnd-widget .icon {
    font-size: 14px;
    margin-right: 6px;
}

.dnd-widget .label {
    font-size: 13px;
    color: #e0e0e0;
}

/* Disabled - Green */
.dnd-widget .icon.status-disabled {
    color: #a6e3a1; 
}
.dnd-widget .label.status-disabled {
    color: #a6e3a1; 
}

/* Priority Only - Yellow */
.dnd-widget .icon.status-priority {
    color: #f9e2af; 
}
.dnd-widget .label.status-priority {
    color: #f9e2af; 
}

/* Alarms Only - Red */
.dnd-widget .icon.status-alarms {
    color: #f38ba8; 
}
.dnd-widget .label.status-alarms {
    color: #f38ba8; 
}