tint3rc - Configuration file for the tint3 panel
A tint3 configuration file describes the look and the behaviour of the tint3 panel.
A tint3 configuration file consists of a series of directives and key/value pairs, one pair on each line. Keys can contain alphanumeric characters and underscores ("_"), but cannot start with an underscore. Values can contain any character and are terminated by a newline. Keys and values are separated by a single equals sign ("="), optionally surrounded by whitespace.
As the configuration file is unstructured, some entries take the special meaning of a section marker. These are explicitly noted below.
Imports the contents of another tint3 configuration file into the one currently being evaluated.
If the file cannot be loaded, an error will be logged and the entry will be skipped.
The given path name can be relative (to the logical path of the config file currently being evaluated), absolute, and it supports shell-like expansion.
Determines whether font shadows are enabled.
Instructs the window manager on how to handle maximized windows.
Determines the rounding, in pixels, of this background.
This entry is a section marker that determines the beginning of a new background. Backgrounds are given an incremental id number that can be used to refer to them, starting with 1 (background 0 is preallocated and defaults to be fully transparent).
Width, in pixels, of this border.
Color of this background in the normal state.
Color of this background in the mouse hover state.
Color of this background in the mouse pressed state.
Sides on which the border should be drawn. Can be any combination of:
If not given, defaults to all sides.
Color of this background's border in the normal state.
Color of this background's border in the mouse hover state.
Color of this background's border in the mouse pressed state.
Id of this background's gradient in the normal state.
Id of this background's gradient in the mouse hover state.
Id of this background's gradient in the mouse pressed state.
Determines the type of gradient to use. It can be vertical (top to bottom), horizontal (left to right), or radial (centre to outer edges).
This entry is a section marker that determines the beginning of a new gradient. Gradients are given an incremental id number that can be used to refer to them, starting with 1 (background 0 is preallocated and defaults to be fully transparent).
Starting color of this gradient.
Ending color of this gradient.
Additional color stop for this gradient. The first integer of this value indicates the percentage where to add the color stop, and it must be in the open range (0; 100); i.e., negative values or values above 100 are not allowed, as well as 0 and 100, to avoid conflicting with start_color and end_color.
Indicates the monitor on which the panel should be displayed. This value can be given as a positive integer representing the index of the monitor (starting from 1), or as a string representing the monitor name, or as the special string value of all which makes tint3 display the panel on all available monitors.
This option requires XRANDR. If the extension is not enabled at compile time or unavailable at run time, or if the given monitor name or index can't be found, tint3 will default to displaying the panel on all available monitors.
Size of the panel.
The first integer indicates the width of the panel. This value is considered to be given in pixels, unless it is followed by %, in which case it's considered a percentage of the current screen width.
The second integer indicates the height of the panel. This value is considered to be given in pixels, unless it is followed by %, in which case it's considered a percentage of the current screen height.
Chooses the items to show in the panel, and their ordering. This value is a string where each character represents an item to display.
Margin, in pixels, of the panel. The first integer represents the margin on the X axis. The second, if given, represents the margin on the Y axis.
Padding, in pixels, of the panel.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Position and alignment of the panel.
The first value indicates the vertical alignment of the panel and can be either top, bottom or center. Defaults to center.
The second value indicates the horizontal alignment of the panel and can be either left, right or center. Defaults to center.
The third value indicates the position of the panel and can be either horizontal or vertical. Defaults to horizontal.
Id of the background used by the panel.
Determines whether unhandled clicks should be forwarded to the window manager.
Determines whether the panel window should be placed in the window manager's dock.
Maximum number of blinks allowed for windows with the urgent hint.
Chooses whether the panel should behave like a normal window, or placed always on top of other windows, or always at the bottom.
Determines whether the battery indicator is enabled. This is a legacy entry, superseded by panel_items. If that option is present, this one is ignored.
Battery percentage to consider "low".
Command to run when the battery reaches the "low" level.
Pango font descriptor to use for the first line of the battery indicator.
Pango font descriptor to use for the second line of the battery indicator.
Color to use for the battery font.
Padding, in pixels, of the battery.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Id of the background used by the battery.
Battery fullness percentage after which to hide the indicator. Defaults to 101% if not given, meaning the indicator will always be shown.
Format string to use for the first line of the clock applet. See strftime(3) for accepted conversion specifications.
This entry is a section marker that determines the presence of a clock applet in legacy configurations. It is ignored for this purpose if panel_items is present.
Format string to use for the second line of the clock applet. See strftime(3) for accepted conversion specifications.
Pango font descriptor to use for the first line of the clock applet.
Name of the timezone to use for the first line of the clock applet.
Name of the timezone to use for the second line of the clock applet.
Pango font descriptor to use for the second line of the clock applet.
Color to use for the clock font.
Padding, in pixels, of the clock applet.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Id of the background used by the clock applet.
Format string to use for the clock applet tooltip. See strftime(3) for accepted conversion specifications.
Name of the timezone to use for the second line of the clock tooltip.
Command to execute when the clock applet is left clicked.
Command to execute when the clock applet is right clicked.
Determines whether the taskbar should be shown on a single desktop or on all desktops.
Padding, in pixels, of the taskbar.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Id of the background used by the taskbar.
Id of the background used by the active taskbar.
Determines whether the taskbar name should be displayed.
Padding, in pixels, of the taskbar name.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Id of the background used by the taskbar name.
Id of the background used by the active taskbar name. Defaults to taskbar_name_background_id.
Pango font descriptor to use for the taskbar name.
Color to use for the taskbar name font.
Color to use for the active taskbar name font.
Determines whether the task name should be displayed.
Determines whether the task icon should be displayed.
Determines whether the task icon and/or text should be centered.
Sets the maximum task area width to the given integer and the maximum task area height to its default of 30. Legacy entry, superseded by task_maximum_size.
Sets the maximum task area width to the first given integer and the maximum task area height to the second given integer (or its default of 30, if missing).
Padding, in pixels, of the task area.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Color to use for the task font.
Color to use for the active task font.
Color to use for the iconified task font.
Color to use for the urgent task font.
Relative alpha, saturation and brightness adjustments for the task icon, expressed as percentages.
Relative alpha, saturation and brightness adjustments for the active task icon, expressed as percentages.
Relative alpha, saturation and brightness adjustments for the iconified task icon, expressed as percentages.
Relative alpha, saturation and brightness adjustments for the urgent task icon, expressed as percentages.
Id of the background used by the task area.
Id of the background used by the active task area.
Id of the background used by the iconified task area.
Id of the background used by the urgent task area.
Determines whether the task tooltip is enabled. Legacy entry, superseded by task_tooltip.
Determines whether the task tooltip is enabled.
Determines whether the systray is enabled. This is a legacy entry, superseded by panel_items. If that option is present, this one is ignored.
Padding, in pixels, of the system tray area.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
This entry is a section marker that determines the presence of a system tray area in legacy configurations. It is ignored for this purpose if panel_items is present.
Id of the background used by the system tray area.
Determines how the system tray icons should be sorted.
Size, in pixels, of system tray icons.
Relative alpha, saturation and brightness adjustments for the system tray icons, expressed as percentages.
Padding, in pixels, of the launchers area.
The first integer represents the internal padding on the X axis (and the spacing between children areas, if a third integer is not given).
The second integer represents the internal padding on the Y axis.
The third integer represents the spacing on the X axis between children areas, overriding the value given by the first integer.
Id of the background used by the launchers area.
Size, in pixels, of the launcher icons.
Path to a .desktop file to add to the launcher area. This must be conforming to the Desktop Entry Specification from freedesktop.org.
The path given here supports shell-like expansion. As an example, home-relative paths for the current user can be be specified in any of the following formats:
Name of the icon theme to use when looking up for icons used by the .desktop files to be loaded. If an XSETTINGS manager is running, tint3 will ignore this setting and load the icon name from there.
Relative alpha, saturation and brightness adjustments for the launcher icons, expressed as percentages.
Determines whether the launcher tooltip is enabled.
Time, in seconds, after which tooltips are shown.
Time, in seconds, after which tooltips are hidden.
Padding, in pixels, of the tooltip area.
The first integer represents the internal padding on the X axis.
The second integer represents the internal padding on the Y axis.
Id of the background used by the tooltip area.
Color to use for the tooltip font.
Pango font descriptor to use for tooltips.
Determines how to handle a click of the middle mouse button or the mouse wheel. See FORMAT OF VALUES for a description of the accepted values.
Determines how to handle a click of the right mouse button. See FORMAT OF VALUES for a description of the accepted values.
Determines how to handle a mouse wheel up event. See FORMAT OF VALUES for a description of the accepted values.
Determines how to handle a mouse wheel down event. See FORMAT OF VALUES for a description of the accepted values.
Determines whether icon effects on mouse events are enabled.
Relative alpha, saturation and brightness adjustments for launcher and taskbar icons on a mouse hover event, expressed as percentages.
Relative alpha, saturation and brightness adjustments for launcher and taskbar icons on a mouse down event, expressed as percentages.
Determines whether panel autohide is enabled.
Time, in seconds, after which the panel is shown.
Time, in seconds, after which the panel is hidden.
Height, in pixel, of the panel in its hidden state. This entry has a lower bound of 1.
Either a string value or a numerical value.
If a string: "true", "yes" or "on" mean true; "false", "no" or "off" mean false.
If a number: 0 means false, non-zero means true.
RGBA color value. It's specified as a CSS-like hex color string, followed by an integer representing the opacity. As an example:
background_color = #ff0000 25creates a red background with 25% opacity. A short hex value is also accepted. As an example:
background_color = #f00 25is identical to the previous example.
String indicating the action to perform for the given mouse event. It can be one of the following:
tint3(1), strftime(3)