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.