Configuration Options

Global Options

sbPanels [panel-list]
Default: sbPanel
A space-separated list of the prefixes of all the panels which are created on startup. See Panels.
sbUseDefaultConfig [bool]
Default: true
Determines whether the builtin default configuration is loaded. This includes placement of panels and the layout hierarchy, so if this option is disabled, you must define the position of panels and the entire layout hierarchy yourself.
sbKeepEmptyDesktops [bool]
sbKeepEmptyFocusedDesktop [bool]
Default: false
Whether desktops with no tasks on them should be kept around (true) or deleted (false), depending on whether the desk in question is focused or not.
sbMinDesktops [int]
Default: 0
The minimum number of virtual desktops. If there aren't more desktops than this, deleting desktops is disallowed, and bang commands which would delete desktops do nothing instead. Regardless of this setting, there must be at least one desktop per monitor. Desktops are created on startup to meet the minimum.
sbMaxDesktops [int]
Default: 0
The maximum number of virtual desktops. If set to 0, there is no limit. When there are this many desktops, creating new desktops is disallowed, and bang commands which would create desktops do nothing instead.
sbAutoGather [bool]
Default: false
If true, Screenbar will gather (merge all desks) on startup. If false, it will attempt to preserve information about what desks tasks were on across a recycle.
sbRescueOffScreenWindows [bool]
Default: true
If a window ends up completely off-screen for some reason, this controls whether Screenbar will move it back. This may cause problems for poorly written apps which move windows off-screen as a way to hide them, but also works around apps which may start themselves off-screen if they remember last closing when on a hidden virtual desktop.
sbPollInterval [int]
Default: 500
How often Screenbar should refresh the list of windows/tasks. If set to 0, polling is disabled; this is not recommended as it will cause the creation of new windows to go unnoticed.
sbHoverTrackingInterval [int]
Default: 125
How often Screenbar should check which window the mouse cursor is over. This is used for a highlight effect with the 'windowhovered' branch condition.
sbSwitchOnFocus [bool]
Default: true
If set, then focusing a window (with alt-tab or any other method) will switch desktop if that window is on a desktop which isn't visible.
sbAltTabMonitor [monitor]
Default: cursor
Controls which monitor is used to display a window when it's on a hidden desktop and you alt-tab to it.
sbTrackProcesses [bool]
Default: false
If set, Screenbar will monitor the CPU and memory usage of running processes. Enabling this option enables the .cpu and .mem options for label elements.
sbUseVWMPrefixedBangs [bool]
Default: true
If set, Screenbar will register bang commands starting with !vwm in addition to the normal bang commands starting with !sb. This is provided for compatibility with user configs, which may include hotkeys for commands like !vwmRight.
sbAnimationUpdateInterval [int]
Default: 50
How long (in milliseconds) between frames of animation.
sbForegroundSnapshotInterval [int]
Default: 2000
sbBackgroundSnapshotInterval [int]
Default: 10000
The intervals at which tasks will have screenshots taken, in milliseconds, if a snapshot layout element is visible. See the section on snapshot elements in the layout chapter.
sbClosedWindowMemoryDuration [int]
Default: 3000
How long after a task closes to remember its icon and window title. This acts is an upper bound on the length of any window-closing animations on the taskbar.
sbTrace [bool]
Default: false
If set, outputs debug information to a file named screenbar.log. For development purposes only.

Default Theme Options

These options are not used by Screenbar directly, but are conditions for branch elements in the default configuration's layout. If you are not using the default configuration, then these options have no effect.

sbShowMinimaps [bool]
Default: false
If set, each desktop will be shown with a minimap that shows the position of windows on it.
sbGroupMinimaps [bool]
Default: false
If set, and sbShowMinimaps is also set, groups all minimaps together on the taskbar, rather than putting each one next to a different desktop.
sbShowTitles [bool]
Default: true
If set, each task will have its title shown.