1TINT2(1) General Commands Manual TINT2(1)
2
6 tint2 - lightweight panel/taskbar
7
9 tint2 is a simple panel/taskbar made for modern X window managers. It
10 was specifically made for Openbox but it should also work with other
11 window managers (GNOME, KDE, XFCE etc.).
12 Features:
14 • Panel with taskbar, system tray, clock and launcher icons;
16 • Easy to customize: color/transparency on fonts, icons, borders
18 and backgrounds;
19 • Pager like capability: move tasks between workspaces (virtual
21 desktops), switch between workspaces;
22 • Multi-monitor capability: create one panel per monitor, show‐
24 ing only the tasks from the current monitor;
25 • Customizable mouse events.
27 Goals:
29 • Be unintrusive and light (in terms of memory, CPU and aes‐
31 thetic);
32 • Follow the freedesktop.org specifications;
34 • Make certain workflows, such as multi-desktop and multi-moni‐
36 tor, easy to use.
37
39 tint2 [OPTION...]
40
42 -c path_to_config_file
43 Specifies which configuration file to use instead of the de‐
44 fault.
45 -v, --version
47 Prints version information and exits.
48 -h, --help
50 Display this help and exits.
51
53 Table of contents
54 • Introduction ⟨#introduction⟩
55 • Backgrounds and borders ⟨#backgrounds-and-borders⟩
57 • Gradients ⟨#gradients⟩
59 • Panel ⟨#panel⟩
61 • Launcher ⟨#launcher⟩
63 • Taskbar/Pager ⟨#taskbar-pager⟩
65 • Taskbar buttons ⟨#taskbar-buttons⟩
67 • Mouse actions for taskbar buttons ⟨#mouse-actions-for-taskbar-
69 buttons⟩
70 • System tray ⟨#system-tray⟩
72 • Clock ⟨#clock⟩
74 • Tooltip ⟨#tooltip⟩
76 • Battery ⟨#battery⟩
78 • Executor ⟨#executor⟩
80 • Button ⟨#button⟩
82 • Separator ⟨#separator⟩
84 • Example configuration ⟨#example-configuration⟩
86 Introduction
88 These are instructions for configuring tint2 directly by editing its
89 config file. You may also use instead the graphical interface
90 tint2conf.
91 The first time you run tint2, it will create the config file in
93 $HOME/.config/tint2/tint2rc (This applies if you have done a clean in‐
94 stall. Running tint2 in the source directory without doing 'make in‐
95 stall' will not create the config file.)
96 You can also specify another file on the command line with the -c op‐
98 tion, e.g.: tint2 -c $HOME/tint2.conf. This can be used to run multiple
99 instances of tint2 that use different settings.
100 If you change the config file while tint2 is running, the command kil‐
102 lall -SIGUSR1 tint2 will force tint2 to reload it.
103 All the configuration options supported in the config file are listed
105 below. Try to respect as much as possible the order of the options as
106 given below.
107 Backgrounds and borders
109 The tint2 config file starts with the options defining background ele‐
110 ments with borders:
111 • rounded = number_of_pixels : the corner radius
113 • border_width = integer : the border width in pixels
115 • border_sides = LRTB : the sides to draw the border on (left,
117 right, top, bottom). If not specified, all sides are used.
118 (since 0.12.12)
119 • background_color = color opacity
121 • color is specified in hex RGB, e.g. #ff0000 is red
123 • opacity varies from (0 to 100), where 0 is fully transpar‐
125 ent, 100 is fully opaque. Note that for a transparent panel
126 you need to enable a desktop compositor (such as compton or
127 compiz).
128 • border_color = color opacity
130 • color is specified in hex RGB, e.g. #ff0000 is red
132 • opacity varies from (0 to 100), where 0 is fully transpar‐
134 ent, 100 is fully opaque
135 • background_color_hover = color opacity (default: same as back‐
137 ground_color) (since 0.12.3)
138 • color is specified in hex RGB, e.g. #ff0000 is red
140 • opacity varies from (0 to 100), where 0 is fully transpar‐
142 ent, 100 is fully opaque. Note that for a transparent panel
143 you need to enable a desktop compositor (such as compton or
144 compiz)
145 • border_color_hover = color opacity (default: same as bor‐
147 der_color) (since 0.12.3)
148 • color is specified in hex RGB, e.g. #ff0000 is red
150 • opacity varies from (0 to 100), where 0 is fully transpar‐
152 ent, 100 is fully opaque
153 • background_color_pressed = color opacity (default: same as
155 background_color_hover) (since 0.12.3)
156 • color is specified in hex RGB, e.g. #ff0000 is red
158 • opacity varies from (0 to 100), where 0 is fully transpar‐
160 ent, 100 is fully opaque. Note that for a transparent panel
161 you need to enable a desktop compositor (such as compton or
162 compiz)
163 • border_color_pressed = color opacity (default: same as bor‐
165 der_color_hover) (since 0.12.3)
166 • color is specified in hex RGB, e.g. #ff0000 is red
168 • opacity varies from (0 to 100), where 0 is fully transpar‐
170 ent, 100 is fully opaque
171 • border_content_tint_weight = integer : Mixes the border color
173 with the content color (for tasks, this is the average color
174 of the window icon). Values must be between 0 (no mixing) and
175 100 (fully replaces the color). (since 16.0)
176 • background_content_tint_weight = integer : Mixes the back‐
178 ground color with the content color (for tasks, this is the
179 average color of the window icon). Values must be between 0
180 (no mixing) and 100 (fully replaces the color). (since 16.0)
181 You can define as many backgrounds as you want. For example, the fol‐
183 lowing config defines two backgrounds:
184 rounded = 1
186 border_width = 0
187 background_color = #282828 100
188 border_color = #000000 0
189 rounded = 1
191 border_width = 0
192 background_color = #f6b655 90
193 border_color = #cccccc 40
194 tint2 automatically identifies each background with a number starting
196 from 1 (1, 2, ...). Afterwards, you can apply a background to objects
197 (panel, taskbar, task, clock, systray) using the background id, for ex‐
198 ample:
199 panel_background_id = 1
201 taskbar_background_id = 0
202 task_background_id = 0
203 task_active_background_id = 2
204 systray_background_id = 0
205 clock_background_id = 0
206 Identifier 0 refers to a special background which is fully transparent,
208 identifier 1 applies the first background defined in the config file
209 etc.
210 Gradients
212 (Available since 0.13.0)
213 Backgrounds also allow specifying gradient layers that are drawn on top
215 of the solid color background.
216 First the user must define one or more gradients in the config file,
218 each starting with gradient = TYPE. These must be added before back‐
219 grounds.
220 Then gradients can be added by index to backgrounds, using the gradi‐
222 ent_id = INDEX, gradient_id_hover = INDEX and gradient_id_pressed = IN‐
223 DEX, where INDEX is the gradient index, starting from 1.
224 Gradient types
226 Gradients vary the color between fixed control points: * vertical gra‐
227 dients: top-to-bottom; * horizontal gradients: left-to-right; * radial
228 gradients: center-to-corners.
229 The user must specify the start and end colors, and can optionally add
231 extra color stops in between using the color_stop option, as explained
232 below.
233 Vertical gradient, with color varying from the top edge to the bottom edge,
235 two colors
236 gradient = vertical
237 start_color = #rrggbb opacity
238 end_color = #rrggbb opacity
239 Horizontal gradient, with color varying from the left edge to the right
241 edge, two colors
242 gradient = horizontal
243 start_color = #rrggbb opacity
244 end_color = #rrggbb opacity
245 Radial gradient, with color varying from the center to the corner, two col‐
247 ors:
248 gradient = radial
249 start_color = #rrggbb opacity
250 end_color = #rrggbb opacity
251 Adding extra color stops (0% and 100% remain fixed, more colors at x% be‐
253 tween the start and end control points)
254 color_stop = percentage #rrggbb opacity
255 Gradient examples
257 # Gradient 1: thin film effect
258 gradient = horizontal
259 start_color = #111122 30
260 end_color = #112211 30
261 color_stop = 60 #221111 30
262 # Gradient 2: radial glow
264 gradient = radial
265 start_color = #ffffff 20
266 end_color = #ffffff 0
267 # Gradient 3: elegant black
269 gradient = vertical
270 start_color = #444444 100
271 end_color = #222222 100
272 # Gradient 4: elegant black
274 gradient = horizontal
275 start_color = #111111 100
276 end_color = #222222 100
277 # Background 1: Active desktop name
279 rounded = 2
280 border_width = 1
281 border_sides = TBLR
282 background_color = #555555 10
283 border_color = #ffffff 60
284 background_color_hover = #555555 10
285 border_color_hover = #ffffff 60
286 background_color_pressed = #555555 10
287 border_color_pressed = #ffffff 60
288 gradient_id = 3
289 gradient_id_hover = 4
290 gradient_id_pressed = 2
291 [...]
293 Panel
295 • panel_items = LTSBC defines the items tint2 will show and the
296 order of those items. Each letter refers to an item, defined
297 as:
298 • L shows the Launcher
300 • T shows the Taskbar
302 • S shows the Systray (also called notification area)
304 • B shows the Battery status
306 • C shows the Clock
308 • F adds an extensible spacer (freespace). You can specify
310 more than one. Has no effect if T is also present. (since
311 0.12)
312 • E adds an executor plugin. You can specify more than one.
314 (since 0.12.4)
315 • P adds a push button. You can specify more than one. (since
317 0.14)
318 • : adds a separator. You can specify more than one. (since
320 0.13.0)
321 For example, panel_items = STC will show the systray, the
323 taskbar and the clock (from left to right).
324 • panel_monitor = monitor (all or primary or 1 or 2 or ...) :
326 Which monitor tint2 draws the panel on
327 • The first monitor is 1
329 • Use panel_monitor = all to get a separate panel per monitor
331 • primary_monitor_first = boolean (0 or 1) : Place the primary
333 monitor before all the other monitors in the list. (since
334 0.12.4; removed in 1.0, use primary instead)
335 [](images/panel_padding.jpg)
337 • panel_position = vertical_position horizontal_position orien‐
339 tation
340 • vertical_position is one of: bottom, top, center
342 • horizontal_position is one of: left, right, center
344 • orientation is one of: horizontal, vertical
346 • panel_size = width height
348 • width and height can be specified without units (e.g. 123)
350 as pixels, or followed by % as percentages of the monitor
351 size (e.g. 50%). Use 100% for full monitor width/height.
352 Example:
353 • scale_relative_to_dpi = integer : If set to a non-zero value,
355 HiDPI scaling is enabled. Each panel is visible on a different
356 monitor. Thus each panel has a specific scaling factor. The
357 scaling factor is computed as the ratio between the monitor
358 DPI (obtained from the dimensions in pixels and millimeters
359 from RandR) and a configured reference DPI - this is the DPI
360 for which exising user configs looked normal, for backward
361 compatibility.
362 • scale_relative_to_screen_height = integer : Similar to
364 scale_relative_to_dpi, except the scaling factor is computed
365 as the ratio between the monitor height and scale_rela‐
366 tive_to_screen_height. The effect is cumulative with
367 scale_relative_to_dpi, i.e. if both options are present, the
368 factors are multiplied.
369 # The panel's width is 94% the size of the monitor, the height is 30 pixels:
371 panel_size = 94% 30
372 • panel_shrink = boolean (0 or 1) : If set to 1, the panel will
374 shrink to a compact size dynamically. (since 0.13)
375 • panel_margin = horizontal_margin vertical_margin : The margins
377 define the distance between the panel and the horizontal/ver‐
378 tical monitor edge. Use 0 to obtain a panel with the same size
379 as the edge of the monitor (no margin).
380 [](images/panelsizemargin.jpg)
382 • panel_padding = horizontal_padding vertical_padding spacing :
384 Please refer to the image below.
385 [](images/panel_padding.jpg)
387 • font_shadow = boolean (0 or 1)
389 • panel_background_id = integer : Which background to use for
391 the panel.
392 • wm_menu = boolean (0 or 1) : Defines if tint2 forwards unhan‐
394 dled mouse events to your window manager. Useful for window
395 managers such as openbox, which display the start menu if you
396 right click on the desktop.
397 • panel_dock = boolean (0 or 1) : Defines if tint2 is placed
399 into the window manager's dock. For the openbox window manager
400 it is advised to also use a modifier for the moveButton op‐
401 tion, otherwise the mouse click is not forwarded to tint2 (in
402 ~/.config/openbox/rc.xml).
403 • panel_pivot_struts = boolean (0 or 1) : Defines if tint2 lies
405 to the window manager about its orientation (horizontal vs
406 vertical) when requesting reserved space with STRUTs (see
407 strut_policy below). On some window managers, this allows
408 placing a panel in the middle of the virtual screen, e.g. on
409 the bottom edge of the top monitor in a vertical dual-monitor
410 setup.
411 • panel_layer = bottom/normal/top : Places tint2 into the bot‐
413 tom/normal/top layer. This is helpful for specifying if the
414 panel can be covered by other windows or not. The default is
415 the bottom layer, but with real transparency normal or top
416 layer may be a nice alternative.
417 • strut_policy = follow_size/minimum/none : STRUTs are used by
419 the window manager to decide the size of maximized windows.
420 Note: on multi-monitor (Xinerama) setups, the panel generally
421 must be placed at the edge (not in the middle) of the virtual
422 screen for this to work correctly (though on some window man‐
423 agers, setting panel_pivot_struts may work around this limita‐
424 tion).
425 • follow_size means that the maximized windows always resize
427 to have a common edge with tint2.
428 • minimum means that the maximized windows always expand to
430 have a common edge with the hidden panel. This is useful if
431 the autohide option is enabled.
432 • none means that the maximized windows use the full screen
434 size.
435 • panel_window_name = string : Defines the name of the panel's
437 window. Default: 'tint2'. (since 0.12)
438 • disable_transparency = boolean (0 or 1) : Whether to disable
440 transparency instead of detecting if it is supported. Useful
441 on broken graphics stacks. (since 0.12)
442 • mouse_effects = boolean (0 or 1) : Whether to enable mouse
444 hover effects for clickable items. (since 0.12.3)
445 • mouse_hover_icon_asb = alpha (0 to 100) saturation (-100 to
447 100) brightness (-100 to 100) : Adjusts the icon color and
448 transparency on mouse hover (works only when mouse_effects =
449 1).` (since 0.12.3)
450 • mouse_pressed_icon_asb = alpha (0 to 100) saturation (-100 to
452 100) brightness (-100 to 100) : Adjusts the icon color and
453 transparency on mouse press (works only when mouse_effects =
454 1).` (since 0.12.3)
455 • autohide = boolean (0 or 1) : Whether to enable panel hiding
457 when the mouse cursor exists the panel.
458 • autohide_show_timeout = float : Show timeout in seconds after
460 the mouse cursor enters the panel. Use '.' as decimal separa‐
461 tor.
462 • autohide_hide_timeout = float : Hide timeout in seconds after
464 the mouse cursor exits the panel. Use '.' as decimal separa‐
465 tor.
466 • autohide_height = integer : panel height (width for vertical
468 panels) in hidden mode.
469 Launcher
471 • launcher_item_app = path_to_application : Each
472 launcher_item_app must be a file path to a .desktop file fol‐
473 lowing the freedesktop.org specification ⟨http://stan‐
474 dards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-
475 latest.html⟩. The paths may begin with ~, which is expanded to
476 the path of the user's home directory. If only a file name is
477 specified, the file is search in the standard application di‐
478 rectories ($XDG_DATA_HOME/applications, ~/.local/share/appli‐
479 cations, $XDG_DATA_DIRS/applications, /usr/local/share/appli‐
480 cations, /usr/share/applications, /opt/share/applications).
481 • launcher_apps_dir = path_to_directory : Specifies a path to a
483 directory from which the launcher is loading all .desktop
484 files (all subdirectories are explored recursively). Can be
485 used multiple times. The path may begin with ~, which is ex‐
486 panded to the path of the user's home directory. (since 0.12)
487 • launcher_background_id = integer : Defines which background to
489 use.
490 • launcher_icon_background_id = integer : Defines which back‐
492 ground to use for icons.
493 • launcher_padding = horizontal_padding vertical_padding spacing
495 • launcher_icon_size = integer : The launcher icon size, in pix‐
497 els.
498 • launcher_icon_theme = name_of_theme : (Optional) Uses the
500 specified icon theme to display shortcut icons. Note that
501 tint2 will detect and use the icon theme of your desktop if
502 you have an XSETTINGS manager running (which you probably do),
503 unless launcher_icon_theme_override = 1.
504 • launcher_icon_theme_override = boolean (0 or 1) : Whether
506 launcher_icon_theme overrides the value obtained from the
507 XSETTINGS manager. (since 0.12)
508 • launcher_icon_asb = alpha (0 to 100) saturation (-100 to 100)
510 brightness (-100 to 100) : Adjusts the icon color and trans‐
511 parency.
512 • launcher_tooltip = boolean (0 or 1) : Whether to show tooltips
514 for the launcher icons.
515 • startup_notifications = boolean (0 or 1) : Whether to show
517 startup notifications when starting applications from the
518 launcher. (since 0.12)
519 Taskbar / Pager
521 • taskbar_mode = single_desktop/multi_desktop
522 • single_desktop : Shows a normal taskbar listing the tasks
524 running on the current virtual desktop (also known as
525 'workspace');
526 • multi_desktop : Pager like capability. Shows multiple
528 taskbars, one per virtual desktop, with which:
529 • You can drag-and-drop tasks between virtual desktops;
531 • You can switch between virtual desktops.
533 • taskbar_hide_if_empty = boolean (0 or 1) : If enabled, in
535 multi-desktop mode the taskbars corresponding to empty desk‐
536 tops different from the current desktop are hidden. (since
537 0.13)
538 • taskbar_distribute_size = boolean (0 or 1) : If enabled, in
540 multi-desktop mode distributes between taskbars the available
541 size proportionally to the number of tasks. Default: disabled.
542 (since 0.12)
543 • taskbar_padding = horizontal_padding vertical_padding spacing
545 [](images/taskbar_padding.jpg)
547 • taskbar_background_id = integer : Which background to use
549 • taskbar_active_background_id = integer : Which background to
551 use for the taskbar of the current virtual desktop.
552 • taskbar_hide_inactive_tasks = boolean (0 or 1) : If enabled,
554 the taskbar shows only the active task. (since 0.12)
555 • taskbar_hide_different_monitor = boolean (0 or 1) : If en‐
557 abled, the taskbar shows only the tasks from the current moni‐
558 tor. Useful when running different tint2 instances on differ‐
559 ent monitors, each one having its own config. (since 0.12)
560 • taskbar_hide_different_desktop = boolean (0 or 1) : If en‐
562 abled, the taskbar shows only the tasks from the current desk‐
563 top. Useful to make multi-desktop taskbars more compact, but
564 still allow desktop switching with mouse click. (since 1.0)
565 • taskbar_always_show_all_desktop_tasks = boolean (0 or 1) :
567 Has effect only if taskbar_mode = multi_desktop. If enabled,
568 tasks that appear on all desktops are shown on all taskbars.
569 Otherwise, they are shown only on the taskbar of the current
570 desktop. (since 0.12.4)
571 • taskbar_sort_order = none/title/center : Specifies the sort
573 order of the tasks on the taskbar. (since 0.12)
574 • none : No sorting. New tasks are simply appended at the end
576 of the taskbar when they appear.
577 • title : Sorts the tasks by title.
579 • application : Sorts the tasks by application name. (since
581 16.3)
582 • center : Sorts the tasks by their window centers.
584 • mru : Shows the most recently used tasks first. (since
586 0.12.4)
587 • lru : Shows the most recently used tasks last. (since
589 0.12.4)
590 • task_align = left/center/right : Specifies the alignment of
592 the tasks on the taskbar. Default: left.
593 • taskbar_name = boolean (0 or 1) : Whether to show the virtual
595 desktop name in the taskbar.
596 • taskbar_name_padding = padding : Padding for the virtual
598 desktop name.
599 • taskbar_name_background_id = integer : Which background to
601 use for the desktop name.
602 • taskbar_name_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] :
604 Font configuration for the desktop name.
605 • taskbar_name_font_color = color opacity (0 to 100) : Font
607 color for the desktop name.
608 • taskbar_name_active_background_id = integer : Which back‐
610 ground to use for the name of the current desktop.
611 • taskbar_name_active_font_color = color opacity (0 to 100) :
613 Font color for the name of the current desktop.
614
616 The following options configure the task buttons in the taskbar:
617 • task_icon = boolean (0 or 1) : Whether to display the task
619 icon. There is no explicit option to control the task icon
620 size; it depends on the vertical padding set with task_pad‐
621 ding.
622 • task_text = boolean (0 or 1) : Whether to display the task
624 text.
625 • task_centered = boolean (0 or 1) : Whether the task text is
627 centered.
628 • task_tooltip = boolean (0 or 1) : Whether to show tooltips for
630 tasks.
631 • task_thumbnail = boolean (0 or 1) : Whether to show thumbnail
633 tooltips for tasks. (since 16.0)
634 • task_thumbnail_size = width : Thumbnail size. (since 16.0)
636 • task_maximum_size = width height
638 • width is used with horizontal panels to limit the size of
640 the tasks. Use width = 0 to get full taskbar width.
641 • height is used with vertical panels.
643 • task_padding = horizontal_padding vertical_padding spacing
645 • urgent_nb_of_blink = integer : Number of blinks on 'get atten‐
647 tion' events.
648 [](images/task_padding.jpg)
650 • task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
652 • task_font_color = color opacity (0 to 100)
654 • task_icon_asb = alpha (0 to 100) saturation (-100 to 100)
656 brightness (-100 to 100) : Adjust the task icon's color and
657 transparency.
658 • task_background_id = integer : Which background to use for non
660 selected tasks
661 For the next 3 options STATUS can be active / iconified / urgent:
663 * task_STATUS_font_color = color opacity (0 to 100)
664 • task_STATUS_icon_asb = alpha (0 to 100) saturation (-100 to
666 100) brightness (-100 to 100) : Adjusts the task icon's color
667 and transparency.
668 • task_STATUS_background_id = integer : Which background to use
670 for the task.
671 Mouse actions for taskbar buttons
673 The possible mouse events are: left, middle, right, scroll_up,
674 scroll_down.
675 The possible mouse actions are: none, close, toggle, iconify, shade,
677 toggle_iconify, maximize_restore, desktop_left, desktop_right,
678 next_task, prev_task.
679 Use mouse_event = action to customize mouse actions. Example:
681 mouse_middle = none
682 mouse_right = close
683 mouse_scroll_up = toggle
684 mouse_scroll_down = iconify
685 The action semantics:
687 * none : If wm_menu = 1 is set, the mouse event is forwarded to
688 the window manager. Otherwise it is ignored. * close : close
689 the task * toggle : toggle the task * iconify : iconify (mini‐
690 mize) the task * toggle_iconify : toggle or iconify the task *
691 maximize_restore : maximized or minimized the task * shade :
692 shades (collapses) the task * desktop_left : send the task to
693 the desktop on the left * desktop_right : send the task to the
694 desktop on the right * next_task : send the focus to next task *
695 prev_task : send the focus to previous task
696 System Tray
698 • systray_padding = horizontal_padding vertical_padding spacing
699 • systray_background_id = integer : Which background to use.
701 • systray_sort = ascending/descending/left2right/right2left :
703 Specifies the sorting order for the icons in the systray: in
704 ascending/descending alphabetical order of the icon title, or
705 always add icons to the right/left (note that with left2right
706 or right2left the order can be different on panel restart).
707 • systray_icon_size = max_icon_size : Set the maximum system
709 tray icon size to number. Set to 0 for automatic icon sizing.
710 • systray_icon_asb = alpha (0 to 100) saturation (-100 to 100)
712 brightness (-100 to 100) : Adjust the systray icons color and
713 transparency.
714 • systray_monitor = integer (1, 2, ...) or primary : On which
716 monitor to draw the systray. The first monitor is 1. (since
717 0.12)
718 • systray_name_filter = string : Regular expression to identify
720 icon names to be hidden. For example, ^audacious$ will hide
721 icons with the exact name audacious, while aud will hide any
722 icons having aud in the name. (since 0.13.1)
723 Clock
725 • time1_format = %H:%M : The format used by the first line of
726 the clock.
727 • time1_format, time2_format and clock_tooltip use the 'strf‐
729 time' syntax. More info can be found here: ⟨http://www.man‐
730 pagez.com/man/3/strftime/⟩
731 • To hide the clock, comment time1_format and time2_format.
733 • time1_timezone = :US/Hawaii
735 • time1_timezone, time2_timezone and clock_tooltip_timezone
737 can be used to specify a timezone. If you do not specify a
738 value the system-wide timezone is used. The timezones can
739 usually be found in /usr/share/zoneinfo. If your timezones
740 are in a different directory, you need to specify the abso‐
741 lute path, e.g. time1_timezone = :/different/zone‐
742 info/dir/US/Hawaii Always prepend the timezone with a ':'
743 • time1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
745 • time2_format = %A %d %B
747 • time2_timezone = :Europe/Berlin
749 • time2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
751 • clock_font_color = color opacity (0 to 100)
753 • clock_padding = horizontal_padding vertical_padding
755 • clock_background_id = integer : Which background to use
757 • clock_tooltip = %a, %d. %b %Y : Format for the clock's
759 tooltip.
760 • clock_tooltip_timezone = :UTC
762 • clock_lclick_command = text : Command to execute on left
764 click.
765 • clock_rclick_command = text : Command to execute on right
767 click.
768 • clock_mclick_command = text : Command to execute on middle
770 click. (since 0.12.1)
771 • clock_uwheel_command = text : Command to execute on wheel
773 scroll up. (since 0.12.1)
774 • clock_dwheel_command = text : Command to execute on wheel
776 scroll down. (since 0.12.1)
777 Tooltip
779 • tooltip_padding = horizontal_padding vertical_padding
780 • tooltip_show_timeout = float : Delay to show the tooltip in
782 seconds. Use . as decimal separator.
783 • tooltip_hide_timeout = float : Delay to hide the tooltip in
785 seconds. Use . as decimal separator.
786 • tooltip_background_id = integer : Which background to use for
788 tooltips. Note that with fake transparency the alpha channel
789 and corner radius options are not respected.
790 • tooltip_font_color = color opacity (0 to 100)
792 • tooltip_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
794 Battery
796 • battery_hide = never/integer (0 to 100) : At what battery per‐
797 centage the battery item is hidden.
798 • battery_low_status = integer: At what battery percentage the
800 low command is executed.
801 • battery_low_cmd = xmessage 'tint2: Battery low!' : Command to
803 execute when the battery is low.
804 • battery_full_cmd = notify-send "battery full" : Command to ex‐
806 ecute when the battery is full.
807 • bat1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
809 • bat2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
811 • battery_font_color = color opacity (0 to 100)
813 • bat1_format = FORMAT_STRING : Format for battery line 1. De‐
815 fault: %p. (since 1.0) Format specification:
816 • %s: State (charging, discharging, full, unknown).
818 • %m: Minutes left until completely charged/discharged (esti‐
820 mated).
821 • %h: Hours left until completely charged/discharged (esti‐
823 mated).
824 • %t: Time left. Shows "hrs:mins" when charging/discharging,
826 or "Ful\" when full.
827 • %p: Percentage. Includes the % sign.
829 • %P: Percentage. Without the % sign.
831 • bat2_format = FORMAT_STRING : Format for battery line 2. De‐
833 fault: %t. (since 1.0)
834 • battery_padding = horizontal_padding vertical_padding
836 • battery_background_id = integer : Which background to use for
838 the battery.
839 • battery_tooltip_enabled = boolean (0 or 1) : Enable/disable
841 battery tooltips. (since 0.12.3)
842 • battery_lclick_command = text : Command to execute on left
844 click. (since 0.12.1)
845 • battery_rclick_command = text : Command to execute on right
847 click. (since 0.12.1)
848 • battery_mclick_command = text : Command to execute on middle
850 click. (since 0.12.1)
851 • battery_uwheel_command = text : Command to execute on wheel
853 scroll up. (since 0.12.1)
854 • battery_dwheel_command = text : Command to execute on wheel
856 scroll down. (since 0.12.1)
857 • ac_connected_cmd = text : Command to execute when the power
859 adapter is plugged in. (since 0.12.3)
860 • ac_disconnected_cmd = text : Command to execute when the power
862 adapter is unplugged. (since 0.12.3)
863 Executor
865 • execp = new : Begins the configuration of a new executor
866 plugin. Multiple such plugins are supported; just use multiple
867 Es in panel_items. (since 0.12.4)
868 • execp_command = text : Command to execute. (since 0.12.4)
870 • execp_interval = integer : The command is executed again after
872 execp_interval seconds from the moment it exits. If zero, the
873 command is executed only once. (since 0.12.4)
874 • execp_continuous = integer : If non-zero, the last execp_con‐
876 tinuous lines from the output of the command are displayed,
877 every execp_continuous lines; this is useful for showing the
878 output of commands that run indefinitely, such as ping
879 127.0.0.1. If zero, the output of the command is displayed af‐
880 ter it finishes executing. (since 0.12.4)
881 • execp_has_icon = boolean (0 or 1) : If execp_has_icon = 1, the
883 first line printed by the command is interpreted as a path to
884 an image file. (since 0.12.4)
885 • execp_cache_icon = boolean (0 or 1) : If execp_cache_icon = 0,
887 the image is reloaded each time the command is executed (use‐
888 ful if the image file is changed on disk by the program exe‐
889 cuted by execp_command). (since 0.12.4)
890 • execp_icon_w = integer : You can use execp_icon_w and ex‐
892 ecp_icon_h to resize the image. If one of them is zero/miss‐
893 ing, the image is rescaled proportionally. If both of them are
894 zero/missing, the image is not rescaled. (since 0.12.4)
895 • execp_icon_h = integer : See execp_icon_w. (since 0.12.4)
897 • execp_tooltip = text : The tooltip. If left empty, no tooltip
899 is displayed. If missing, the standard error of the command is
900 shown as a tooltip (an ANSI clear screen sequence can reset
901 the contents, bash: printf '\e[2J', C: printf("\x1b[2J");). If
902 the standard error is empty, the tooltip will show information
903 about the time when the command was last executed. (since
904 0.12.4)
905 • execp_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
907 used to draw the text. (since 0.12.4)
908 • execp_font_color = color opacity : The font color. (since
910 0.12.4)
911 • execp_markup = boolean (0 or 1) : If non-zero, the output of
913 the command is treated as Pango markup, which allows rich text
914 formatting. The format is documented here ⟨https://devel‐
915 oper.gnome.org/pygtk/stable/pango-markup-language.html⟩. Note
916 that using this with commands that print data downloaded from
917 the Internet is a possible security risk. (since 0.12.4)
918 • execp_background_id = integer : Which background to use.
920 (since 0.12.4)
921 • execp_centered = boolean (0 or 1) : Whether to center the
923 text. (since 0.12.4)
924 • execp_padding = horizontal_padding vertical_padding spac‐
926 ing_between_icon_and_text (since 0.12.4)
927 • execp_monitor = integer (1, 2, ...), primary or all : On
929 which monitor to draw the executor. The first monitor is 1.
930 (since 17.0)
931 • execp_lclick_command = text : Command to execute on left
933 click. If not defined, execp_command is executed immediately,
934 unless it is currently running. (since 0.12.4)
935 • execp_mclick_command = text : Command to execute on right
937 click. If not defined, execp_command is executed immediately,
938 unless it is currently running. (since 0.12.4)
939 • execp_rclick_command = text : Command to execute on middle
941 click. If not defined, execp_command is executed immediately,
942 unless it is currently running. (since 0.12.4)
943 • execp_uwheel_command = text : Command to execute on wheel
945 scroll up. If not defined, execp_command is executed immedi‐
946 ately, unless it is currently running. (since 0.12.4)
947 • execp_dwheel_command = text : Command to execute on wheel
949 scroll down. If not defined, execp_command is executed imme‐
950 diately, unless it is currently running. (since 0.12.4)
951 Executor samples
953 Print the hostname
954 execp = new
955 execp_command = hostname
956 execp_interval = 0
957 Print disk usage for the root partition every 10 seconds
959 execp = new
960 execp_command = df -h | awk '/\/$/ { print $6 ": " $2 " " $5}'
961 execp_interval = 10
962 Button with icon and rich text, executes command when clicked
964 execp = new
965 execp_command = echo /usr/share/icons/elementary-xfce/emblems/24/emblem-colors-blue.png; echo '<span foreground="#7f7">Click</span> <span foreground="#77f">me</span> <span foreground="#f77">pls</span>'
966 execp_has_icon = 1
967 execp_interval = 0
968 execp_centered = 1
969 execp_font = sans 9
970 execp_markup = 1
971 execp_font_color = #aaffaa 100
972 execp_padding = 2 0
973 execp_tooltip = I will tell you a secret...
974 execp_lclick_command = zenity --info "--text=$(uname -sr)"
975 execp_background_id = 2
976 Desktop pager with text
978 execp = new
979 execp_command = xprop -root -spy | awk '/^_NET_CURRENT_DESKTOP/ { print "Workspace " ($3 + 1) ; fflush(); }'
980 execp_interval = 1
981 execp_continuous = 1
982 Desktop pager with icon
984 execp_command = xprop -root -spy | awk -v home="$HOME" '/^_NET_CURRENT_DESKTOP/ { print home "/.config/myPager/" ($3 + 1) ".png\n" ; fflush(); }'
985 execp_interval = 1
986 execp_has_icon = 1
987 execp_cache_icon = 1
988 execp_continuous = 2
989 Round-trip time to the gateway, refreshed every second
991 execp = new
992 execp_command = ping -i 1 -c 1 -W 1 -O -D -n $(ip route | grep default | grep via | grep -o '[0-9]*\.[0-9]*\.[0-9]*\.[0-9]*') | awk '/no/ { print "<span foreground=\"#faa\">timeout</span>"; fflush(); }; /time=/ { gsub(/time=/, "", $8); printf "<span foreground=\"#7af\">%3.0f %s</span>\n", $8, $9; fflush(); } '
993 execp_continuous = 0
994 execp_interval = 1
995 execp_markup = 1
996 Memory usage
998 # Note the use of "stdbuf -oL" to force the program to flush the output line by line.
999 execp = new
1000 execp_command = free -b -s1 | stdbuf -oL awk '/^Mem:/ { printf "Mem: %s %.0f%%\n", $2, 100 * ($2 - $7) / $2 }' | stdbuf -oL numfmt --to=iec-i --field=2 -d' '
1001 execp_interval = 1
1002 execp_continuous = 1
1003 Network load
1005 execp = new
1006 execp_command = stdbuf -oL bwm-ng -o csv -t 1000 | stdbuf -oL awk -F ';' '/total/ { printf "Net: %.0f Mb/s\n", ($5*8/1.0e6) }'
1007 execp_continuous = 1
1008 execp_interval = 1
1009 Button
1011 • button = new : Begins the configuration of a new button. Mul‐
1012 tiple such plugins are supported; just use multiple Ps in
1013 panel_items. (since 0.14)
1014 • button_icon = text : Name or path of icon (or empty). (since
1016 0.14)
1017 • button_text = text : Text to display (or empty). (since 0.14)
1019 • button_tooltip = text : The tooltip (or empty). (since 0.14)
1021 • button_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
1023 used to draw the text. (since 0.14)
1024 • button_font_color = color opacity : The font color. (since
1026 0.14)
1027 • button_background_id = integer : Which background to use.
1029 (since 0.14)
1030 • button_centered = boolean (0 or 1) : Whether to center the
1032 text. (since 0.14)
1033 • button_padding = horizontal_padding vertical_padding spac‐
1035 ing_between_icon_and_text (since 0.14)
1036 • button_max_icon_size = integer : Sets a limit to the icon
1038 size. Otherwise, the icon will expand to the edges. (since
1039 0.14)
1040 • button_lclick_command = text : Command to execute on left
1042 click. If not defined, execp_command is executed immediately,
1043 unless it is currently running. (since 0.14)
1044 • button_mclick_command = text : Command to execute on right
1046 click. If not defined, execp_command is executed immediately,
1047 unless it is currently running. (since 0.14)
1048 • button_rclick_command = text : Command to execute on middle
1050 click. If not defined, execp_command is executed immediately,
1051 unless it is currently running. (since 0.14)
1052 • button_uwheel_command = text : Command to execute on wheel
1054 scroll up. If not defined, execp_command is executed immedi‐
1055 ately, unless it is currently running. (since 0.14)
1056 • button_dwheel_command = text : Command to execute on wheel
1058 scroll down. If not defined, execp_command is executed imme‐
1059 diately, unless it is currently running. (since 0.14)
1060 Separator
1062 • separator = new : Begins the configuration of a new separator.
1063 Multiple such plugins are supported; just use multiple :s in
1064 panel_items. (since 0.13.0)
1065 • separator_background_id = integer : Which background to use.
1067 (since 0.13.0)
1068 • separator_color = color opacity : The foreground color. (since
1070 0.13.0)
1071 • separator_style = [empty | line | dots] : The separator style.
1073 (since 0.13.0)
1074 • separator_size = integer : The thickness of the separator.
1076 Does not include the border and padding. For example, if the
1077 style is line, this is the line thickness; if the style is
1078 dots, this is the dot's diameter. (since 0.13.0)
1079 • separator_padding = side_padding cap_padding : The padding to
1081 add to the sides of the separator, in pixels. (since 0.13.0)
1082 Example configuration
1084 See /etc/xdg/tint2/tint2rc.
1085
1087 tint2 was written by Thierry Lorthiois ⟨lorthiois@bbsoft.fr⟩. It is
1088 based on ttm, originally written by Pål Staurland ⟨staura@gmail.com⟩.
1089 This manual page was originally written by Daniel Moerner ⟨dmo‐
1091 erner@gmail.com⟩, for the Debian project (but may be used by others).
1092 It was adopted from the tint2 docs.
1093
1095 The main website ⟨https://gitlab.com/o9000/tint2⟩ and the wiki page at
1096 ⟨https://gitlab.com/o9000/tint2/wikis/home⟩.
1097 This documentation is also provided in HTML and Markdown format in the
1099 system's default location for documentation files, usually
1100 /usr/share/doc/tint2 or /usr/local/share/doc/tint2. . .
110117.0.2 2021-12-04 TINT2(1)