YASBDocs

Applications Widget Options#

A simple launcher that puts shortcut buttons for your favorite apps and tools right on the bar. You can launch any command or program with a click, set up custom icons (using text symbols or local images), and customize the hover tooltips.

Option Type Default Description
label string Required The label for the applications widget.
class_name string "" The CSS class name for styling the widget. Optional.
image_icon_size int 14 The size of the icon in pixels if the icon is an image.
app_list list Required Application list with command.
tooltip bool True Enable or disable tooltips for application names.

Example Configuration#

apps:
  type: "yasb.applications.ApplicationsWidget"
  options:
    label: "{data}"
    app_list:
      - {icon: "\uf0a2", launch: "notification_center", name: "Notification Center"} # launch notification center
      - {icon: "\ueb51", launch: "quick_settings"} # launch quick settings
      - {icon: "\uf422", launch: "search"} # launch search
      - {icon: "\uf489", launch: "wt", name: "Windows Terminal"} # launch terminal
      - {icon: "C:\\Users\\marko\\icons\\vscode.png", launch: "C:\\Users\\Username\\AppData\\Local\\Programs\\Microsoft VS Code\\Code.exe"} # open vscode
      - {icon: "\udb81\udc4d",launch: "\"C:\\Program Files\\Mozilla Firefox\\firefox.exe\" -new-tab www.reddit.com"} # open reddit in new tab in firefox
      - {icon: "\udb81\udc4d",launch: "\"C:\\Program Files\\Mozilla Firefox\\firefox.exe\" -new-window www.reddit.com"} # open reddit in new window in firefox
      - {icon: "\udb81\udc4d",launch: "\"C:\\Program Files\\Mozilla Firefox\\firefox.exe\" -private-window www.reddit.com"} # open reddit in private window in firefox

Description of Options#

  • label: The label for the applications widget.
  • class_name: The CSS class name for styling the widget. Optional.
  • image_icon_size: The size of the icon in pixels if the icon is an image.
  • app_list: A list of applications to display in the widget. Each application is a dictionary with the following keys:
  • icon: (Required) The icon for the application. This can be a Unicode character (e.g., \uf0a2), an image path (e.g., C:\\path\\to\\icon.png), or an icon name that can be resolved by the system.
  • launch: (Required) The command to launch the application. This can include arguments and should be properly quoted if necessary.
  • name: (Optional, default None) The name of the application to display as a tooltip when hovering over the icon.
  • tooltip: A boolean to enable or disable tooltips for application names.

Note

If you use image as icon, you need to provide the full path to the image. Recommended to use small images.

Example Style#

.apps-widget {}
.apps-widget .widget-container {}
.apps-widget .widget-container .label { /*icons*/ }