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
44 default.
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
94 install. Running tint2 in the source directory without doing 'make
95 install' will not create the config file.)
96 You can also specify another file on the command line with the -c
98 option, e.g.: tint2 -c $HOME/tint2.conf. This can be used to run multi‐
99 ple 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
198 example:
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 =
223 INDEX, 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%
253 between 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
401 option, otherwise the mouse click is not forwarded to tint2
402 (in ~/.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
478 directories ($XDG_DATA_HOME/applications,
479 ~/.local/share/applications, $XDG_DATA_DIRS/applications,
480 /usr/local/share/applications, /usr/share/applications,
481 /opt/share/applications).
482 · launcher_apps_dir = path_to_directory : Specifies a path to a
484 directory from which the launcher is loading all .desktop
485 files (all subdirectories are explored recursively). Can be
486 used multiple times. The path may begin with ~, which is
487 expanded to the path of the user's home directory. (since
488 0.12)
489 · launcher_background_id = integer : Defines which background to
491 use.
492 · launcher_icon_background_id = integer : Defines which back‐
494 ground to use for icons.
495 · launcher_padding = horizontal_padding vertical_padding spacing
497 · launcher_icon_size = integer : The launcher icon size, in pix‐
499 els.
500 · launcher_icon_theme = name_of_theme : (Optional) Uses the
502 specified icon theme to display shortcut icons. Note that
503 tint2 will detect and use the icon theme of your desktop if
504 you have an XSETTINGS manager running (which you probably do),
505 unless launcher_icon_theme_override = 1.
506 · launcher_icon_theme_override = boolean (0 or 1) : Whether
508 launcher_icon_theme overrides the value obtained from the
509 XSETTINGS manager. (since 0.12)
510 · launcher_icon_asb = alpha (0 to 100) saturation (-100 to 100)
512 brightness (-100 to 100) : Adjusts the icon color and trans‐
513 parency.
514 · launcher_tooltip = boolean (0 or 1) : Whether to show tooltips
516 for the launcher icons.
517 · startup_notifications = boolean (0 or 1) : Whether to show
519 startup notifications when starting applications from the
520 launcher. (since 0.12)
521 Taskbar / Pager
523 · taskbar_mode = single_desktop/multi_desktop
524 · single_desktop : Shows a normal taskbar listing the tasks
526 running on the current virtual desktop (also known as
527 'workspace');
528 · multi_desktop : Pager like capability. Shows multiple
530 taskbars, one per virtual desktop, with which:
531 · You can drag-and-drop tasks between virtual desktops;
533 · You can switch between virtual desktops.
535 · taskbar_hide_if_empty = boolean (0 or 1) : If enabled, in
537 multi-desktop mode the taskbars corresponding to empty desk‐
538 tops different from the current desktop are hidden. (since
539 0.13)
540 · taskbar_distribute_size = boolean (0 or 1) : If enabled, in
542 multi-desktop mode distributes between taskbars the available
543 size proportionally to the number of tasks. Default: disabled.
544 (since 0.12)
545 · taskbar_padding = horizontal_padding vertical_padding spacing
547 [](images/taskbar_padding.jpg)
549 · taskbar_background_id = integer : Which background to use
551 · taskbar_active_background_id = integer : Which background to
553 use for the taskbar of the current virtual desktop.
554 · taskbar_hide_inactive_tasks = boolean (0 or 1) : If enabled,
556 the taskbar shows only the active task. (since 0.12)
557 · taskbar_hide_different_monitor = boolean (0 or 1) : If
559 enabled, the taskbar shows only the tasks from the current
560 monitor. Useful when running different tint2 instances on dif‐
561 ferent monitors, each one having its own config. (since 0.12)
562 · taskbar_hide_different_desktop = boolean (0 or 1) : If
564 enabled, the taskbar shows only the tasks from the current
565 desktop. Useful to make multi-desktop taskbars more compact,
566 but still allow desktop switching with mouse click. (since
567 1.0)
568 · taskbar_always_show_all_desktop_tasks = boolean (0 or 1) :
570 Has effect only if taskbar_mode = multi_desktop. If enabled,
571 tasks that appear on all desktops are shown on all taskbars.
572 Otherwise, they are shown only on the taskbar of the current
573 desktop. (since 0.12.4)
574 · taskbar_sort_order = none/title/center : Specifies the sort
576 order of the tasks on the taskbar. (since 0.12)
577 · none : No sorting. New tasks are simply appended at the end
579 of the taskbar when they appear.
580 · title : Sorts the tasks by title.
582 · application : Sorts the tasks by application name. (since
584 16.3)
585 · center : Sorts the tasks by their window centers.
587 · mru : Shows the most recently used tasks first. (since
589 0.12.4)
590 · lru : Shows the most recently used tasks last. (since
592 0.12.4)
593 · task_align = left/center/right : Specifies the alignment of
595 the tasks on the taskbar. Default: left.
596 · taskbar_name = boolean (0 or 1) : Whether to show the virtual
598 desktop name in the taskbar.
599 · taskbar_name_padding = padding : Padding for the virtual
601 desktop name.
602 · taskbar_name_background_id = integer : Which background to
604 use for the desktop name.
605 · taskbar_name_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] :
607 Font configuration for the desktop name.
608 · taskbar_name_font_color = color opacity (0 to 100) : Font
610 color for the desktop name.
611 · taskbar_name_active_background_id = integer : Which back‐
613 ground to use for the name of the current desktop.
614 · taskbar_name_active_font_color = color opacity (0 to 100) :
616 Font color for the name of the current desktop.
617
619 The following options configure the task buttons in the taskbar:
620 · task_icon = boolean (0 or 1) : Whether to display the task
622 icon. There is no explicit option to control the task icon
623 size; it depends on the vertical padding set with task_pad‐
624 ding.
625 · task_text = boolean (0 or 1) : Whether to display the task
627 text.
628 · task_centered = boolean (0 or 1) : Whether the task text is
630 centered.
631 · task_tooltip = boolean (0 or 1) : Whether to show tooltips for
633 tasks.
634 · task_thumbnail = boolean (0 or 1) : Whether to show thumbnail
636 tooltips for tasks. (since 16.0)
637 · task_thumbnail_size = width : Thumbnail size. (since 16.0)
639 · task_maximum_size = width height
641 · width is used with horizontal panels to limit the size of
643 the tasks. Use width = 0 to get full taskbar width.
644 · height is used with vertical panels.
646 · task_padding = horizontal_padding vertical_padding spacing
648 · urgent_nb_of_blink = integer : Number of blinks on 'get atten‐
650 tion' events.
651 [](images/task_padding.jpg)
653 · task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
655 · task_font_color = color opacity (0 to 100)
657 · task_icon_asb = alpha (0 to 100) saturation (-100 to 100)
659 brightness (-100 to 100) : Adjust the task icon's color and
660 transparency.
661 · task_background_id = integer : Which background to use for non
663 selected tasks
664 For the next 3 options STATUS can be active / iconified / urgent:
666 * task_STATUS_font_color = color opacity (0 to 100)
667 · task_STATUS_icon_asb = alpha (0 to 100) saturation (-100 to
669 100) brightness (-100 to 100) : Adjusts the task icon's color
670 and transparency.
671 · task_STATUS_background_id = integer : Which background to use
673 for the task.
674 Mouse actions for taskbar buttons
676 The possible mouse events are: left, middle, right, scroll_up,
677 scroll_down.
678 The possible mouse actions are: none, close, toggle, iconify, shade,
680 toggle_iconify, maximize_restore, desktop_left, desktop_right,
681 next_task, prev_task.
682 Use mouse_event = action to customize mouse actions. Example:
684 mouse_middle = none
685 mouse_right = close
686 mouse_scroll_up = toggle
687 mouse_scroll_down = iconify
688 The action semantics:
690 * none : If wm_menu = 1 is set, the mouse event is forwarded to
691 the window manager. Otherwise it is ignored. * close : close
692 the task * toggle : toggle the task * iconify : iconify (mini‐
693 mize) the task * toggle_iconify : toggle or iconify the task *
694 maximize_restore : maximized or minimized the task * shade :
695 shades (collapses) the task * desktop_left : send the task to
696 the desktop on the left * desktop_right : send the task to the
697 desktop on the right * next_task : send the focus to next task *
698 prev_task : send the focus to previous task
699 System Tray
701 · systray_padding = horizontal_padding vertical_padding spacing
702 · systray_background_id = integer : Which background to use.
704 · systray_sort = ascending/descending/left2right/right2left :
706 Specifies the sorting order for the icons in the systray: in
707 ascending/descending alphabetical order of the icon title, or
708 always add icons to the right/left (note that with left2right
709 or right2left the order can be different on panel restart).
710 · systray_icon_size = max_icon_size : Set the maximum system
712 tray icon size to number. Set to 0 for automatic icon sizing.
713 · systray_icon_asb = alpha (0 to 100) saturation (-100 to 100)
715 brightness (-100 to 100) : Adjust the systray icons color and
716 transparency.
717 · systray_monitor = integer (1, 2, ...) or primary : On which
719 monitor to draw the systray. The first monitor is 1. (since
720 0.12)
721 · systray_name_filter = string : Regular expression to identify
723 icon names to be hidden. For example, ^audacious$ will hide
724 icons with the exact name audacious, while aud will hide any
725 icons having aud in the name. (since 0.13.1)
726 Clock
728 · time1_format = %H:%M : The format used by the first line of
729 the clock.
730 · time1_format, time2_format and clock_tooltip use the 'strf‐
732 time' syntax. More info can be found here: ⟨http://www.man‐
733 pagez.com/man/3/strftime/⟩
734 · To hide the clock, comment time1_format and time2_format.
736 · time1_timezone = :US/Hawaii
738 · time1_timezone, time2_timezone and clock_tooltip_timezone
740 can be used to specify a timezone. If you do not specify a
741 value the system-wide timezone is used. The timezones can
742 usually be found in /usr/share/zoneinfo. If your timezones
743 are in a different directory, you need to specify the abso‐
744 lute path, e.g. time1_timezone = :/different/zone‐
745 info/dir/US/Hawaii Always prepend the timezone with a ':'
746 · time1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
748 · time2_format = %A %d %B
750 · time2_timezone = :Europe/Berlin
752 · time2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
754 · clock_font_color = color opacity (0 to 100)
756 · clock_padding = horizontal_padding vertical_padding
758 · clock_background_id = integer : Which background to use
760 · clock_tooltip = %a, %d. %b %Y : Format for the clock's
762 tooltip.
763 · clock_tooltip_timezone = :UTC
765 · clock_lclick_command = text : Command to execute on left
767 click.
768 · clock_rclick_command = text : Command to execute on right
770 click.
771 · clock_mclick_command = text : Command to execute on middle
773 click. (since 0.12.1)
774 · clock_uwheel_command = text : Command to execute on wheel
776 scroll up. (since 0.12.1)
777 · clock_dwheel_command = text : Command to execute on wheel
779 scroll down. (since 0.12.1)
780 Tooltip
782 · tooltip_padding = horizontal_padding vertical_padding
783 · tooltip_show_timeout = float : Delay to show the tooltip in
785 seconds. Use . as decimal separator.
786 · tooltip_hide_timeout = float : Delay to hide the tooltip in
788 seconds. Use . as decimal separator.
789 · tooltip_background_id = integer : Which background to use for
791 tooltips. Note that with fake transparency the alpha channel
792 and corner radius options are not respected.
793 · tooltip_font_color = color opacity (0 to 100)
795 · tooltip_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
797 Battery
799 · battery_hide = never/integer (0 to 100) : At what battery per‐
800 centage the battery item is hidden.
801 · battery_low_status = integer: At what battery percentage the
803 low command is executed.
804 · battery_low_cmd = xmessage 'tint2: Battery low!' : Command to
806 execute when the battery is low.
807 · battery_full_cmd = notify-send "battery full" : Command to
809 execute when the battery is full.
810 · bat1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
812 · bat2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
814 · battery_font_color = color opacity (0 to 100)
816 · bat1_format = FORMAT_STRING : Format for battery line 1.
818 Default: %p. (since 1.0) Format specification:
819 · %s: State (charging, discharging, full, unknown).
821 · %m: Minutes left until completely charged/discharged (esti‐
823 mated).
824 · %h: Hours left until completely charged/discharged (esti‐
826 mated).
827 · %t: Time left. Shows "hrs:mins" when charging/discharging,
829 or "Ful\" when full.
830 · %p: Percentage. Includes the % sign.
832 · %P: Percentage. Without the % sign.
834 · bat2_format = FORMAT_STRING : Format for battery line 2.
836 Default: %t. (since 1.0)
837 · battery_padding = horizontal_padding vertical_padding
839 · battery_background_id = integer : Which background to use for
841 the battery.
842 · battery_tooltip_enabled = boolean (0 or 1) : Enable/disable
844 battery tooltips. (since 0.12.3)
845 · battery_lclick_command = text : Command to execute on left
847 click. (since 0.12.1)
848 · battery_rclick_command = text : Command to execute on right
850 click. (since 0.12.1)
851 · battery_mclick_command = text : Command to execute on middle
853 click. (since 0.12.1)
854 · battery_uwheel_command = text : Command to execute on wheel
856 scroll up. (since 0.12.1)
857 · battery_dwheel_command = text : Command to execute on wheel
859 scroll down. (since 0.12.1)
860 · ac_connected_cmd = text : Command to execute when the power
862 adapter is plugged in. (since 0.12.3)
863 · ac_disconnected_cmd = text : Command to execute when the power
865 adapter is unplugged. (since 0.12.3)
866 Executor
868 · execp = new : Begins the configuration of a new executor plug‐
869 in. Multiple such plugins are supported; just use multiple Es
870 in panel_items. (since 0.12.4)
871 · execp_command = text : Command to execute. (since 0.12.4)
873 · execp_interval = integer : The command is executed again after
875 execp_interval seconds from the moment it exits. If zero, the
876 command is executed only once. (since 0.12.4)
877 · execp_continuous = integer : If non-zero, the last execp_con‐
879 tinuous lines from the output of the command are displayed,
880 every execp_continuous lines; this is useful for showing the
881 output of commands that run indefinitely, such as ping
882 127.0.0.1. If zero, the output of the command is displayed
883 after it finishes executing. (since 0.12.4)
884 · execp_has_icon = boolean (0 or 1) : If execp_has_icon = 1, the
886 first line printed by the command is interpreted as a path to
887 an image file. (since 0.12.4)
888 · execp_cache_icon = boolean (0 or 1) : If execp_cache_icon = 0,
890 the image is reloaded each time the command is executed (use‐
891 ful if the image file is changed on disk by the program exe‐
892 cuted by execp_command). (since 0.12.4)
893 · execp_icon_w = integer : You can use execp_icon_w and
895 execp_icon_h to resize the image. If one of them is zero/miss‐
896 ing, the image is rescaled proportionally. If both of them are
897 zero/missing, the image is not rescaled. (since 0.12.4)
898 · execp_icon_h = integer : See execp_icon_w. (since 0.12.4)
900 · execp_tooltip = text : The tooltip. If left empty, no tooltip
902 is displayed. If missing, the standard error of the command is
903 shown as a tooltip (an ANSI clear screen sequence can reset
904 the contents, bash: printf '\e[2J', C: printf("\x1b[2J");). If
905 the standard error is empty, the tooltip will show information
906 about the time when the command was last executed. (since
907 0.12.4)
908 · execp_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
910 used to draw the text. (since 0.12.4)
911 · execp_font_color = color opacity : The font color. (since
913 0.12.4)
914 · execp_markup = boolean (0 or 1) : If non-zero, the output of
916 the command is treated as Pango markup, which allows rich text
917 formatting. The format is documented here ⟨https://devel‐
918 oper.gnome.org/pygtk/stable/pango-markup-language.html⟩. Note
919 that using this with commands that print data downloaded from
920 the Internet is a possible security risk. (since 0.12.4)
921 · execp_background_id = integer : Which background to use.
923 (since 0.12.4)
924 · execp_centered = boolean (0 or 1) : Whether to center the
926 text. (since 0.12.4)
927 · execp_padding = horizontal_padding vertical_padding spac‐
929 ing_between_icon_and_text (since 0.12.4)
930 · execp_lclick_command = text : Command to execute on left
932 click. If not defined, execp_command is executed immediately,
933 unless it is currently running. (since 0.12.4)
934 · execp_mclick_command = text : Command to execute on right
936 click. If not defined, execp_command is executed immediately,
937 unless it is currently running. (since 0.12.4)
938 · execp_rclick_command = text : Command to execute on middle
940 click. If not defined, execp_command is executed immediately,
941 unless it is currently running. (since 0.12.4)
942 · execp_uwheel_command = text : Command to execute on wheel
944 scroll up. If not defined, execp_command is executed immedi‐
945 ately, unless it is currently running. (since 0.12.4)
946 · execp_dwheel_command = text : Command to execute on wheel
948 scroll down. If not defined, execp_command is executed imme‐
949 diately, unless it is currently running. (since 0.12.4)
950 Executor samples
952 Print the hostname
953 execp = new
954 execp_command = hostname
955 execp_interval = 0
956 Print disk usage for the root partition every 10 seconds
958 execp = new
959 execp_command = df -h | awk '/\/$/ { print $6 ": " $2 " " $5}'
960 execp_interval = 10
961 Button with icon and rich text, executes command when clicked
963 execp = new
964 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>'
965 execp_has_icon = 1
966 execp_interval = 0
967 execp_centered = 1
968 execp_font = sans 9
969 execp_markup = 1
970 execp_font_color = #aaffaa 100
971 execp_padding = 2 0
972 execp_tooltip = I will tell you a secret...
973 execp_lclick_command = zenity --info "--text=$(uname -sr)"
974 execp_background_id = 2
975 Desktop pager with text
977 execp = new
978 execp_command = xprop -root -spy | awk '/^_NET_CURRENT_DESKTOP/ { print "Workspace " ($3 + 1) ; fflush(); }'
979 execp_interval = 1
980 execp_continuous = 1
981 Desktop pager with icon
983 execp_command = xprop -root -spy | awk -v home="$HOME" '/^_NET_CURRENT_DESKTOP/ { print home "/.config/myPager/" ($3 + 1) ".png\n" ; fflush(); }'
984 execp_interval = 1
985 execp_has_icon = 1
986 execp_cache_icon = 1
987 execp_continuous = 2
988 Round-trip time to the gateway, refreshed every second
990 execp = new
991 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(); } '
992 execp_continuous = 0
993 execp_interval = 1
994 execp_markup = 1
995 Memory usage
997 execp = new
998 execp_command = free | awk '/^-/ { printf "Mem: '$(free -h | awk '/^Mem:/ { print $2 }')' %.0f%%\n", 100*$3/($3+$4); fflush(stdout) }'
999 execp_interval = 5
1000 execp_continuous = 0
1001 Network load
1003 # Note the use of "stdbuf -oL" to force the program to flush the output line by line.
1004 execp = new
1005 execp_command = stdbuf -oL bwm-ng -o csv -t 1000 | awk -F ';' '/total/ { printf "Net: %.0f Mb/s\n", ($5*8/1.0e6) }; fflush(stdout)'
1006 execp_continuous = 1
1007 execp_interval = 1
1008 Button
1010 · button = new : Begins the configuration of a new button. Mul‐
1011 tiple such plugins are supported; just use multiple Ps in
1012 panel_items. (since 0.14)
1013 · button_icon = text : Name or path of icon (or empty). (since
1015 0.14)
1016 · button_text = text : Text to display (or empty). (since 0.14)
1018 · button_tooltip = text : The tooltip (or empty). (since 0.14)
1020 · button_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
1022 used to draw the text. (since 0.14)
1023 · button_font_color = color opacity : The font color. (since
1025 0.14)
1026 · button_background_id = integer : Which background to use.
1028 (since 0.14)
1029 · button_centered = boolean (0 or 1) : Whether to center the
1031 text. (since 0.14)
1032 · button_padding = horizontal_padding vertical_padding spac‐
1034 ing_between_icon_and_text (since 0.14)
1035 · button_max_icon_size = integer : Sets a limit to the icon
1037 size. Otherwise, the icon will expand to the edges. (since
1038 0.14)
1039 · button_lclick_command = text : Command to execute on left
1041 click. If not defined, execp_command is executed immediately,
1042 unless it is currently running. (since 0.14)
1043 · button_mclick_command = text : Command to execute on right
1045 click. If not defined, execp_command is executed immediately,
1046 unless it is currently running. (since 0.14)
1047 · button_rclick_command = text : Command to execute on middle
1049 click. If not defined, execp_command is executed immediately,
1050 unless it is currently running. (since 0.14)
1051 · button_uwheel_command = text : Command to execute on wheel
1053 scroll up. If not defined, execp_command is executed immedi‐
1054 ately, unless it is currently running. (since 0.14)
1055 · button_dwheel_command = text : Command to execute on wheel
1057 scroll down. If not defined, execp_command is executed imme‐
1058 diately, unless it is currently running. (since 0.14)
1059 Separator
1061 · separator = new : Begins the configuration of a new separator.
1062 Multiple such plugins are supported; just use multiple :s in
1063 panel_items. (since 0.13.0)
1064 · separator_background_id = integer : Which background to use.
1066 (since 0.13.0)
1067 · separator_color = color opacity : The foreground color. (since
1069 0.13.0)
1070 · separator_style = [empty | line | dots] : The separator style.
1072 (since 0.13.0)
1073 · separator_size = integer : The thickness of the separator.
1075 Does not include the border and padding. For example, if the
1076 style is line, this is the line thickness; if the style is
1077 dots, this is the dot's diameter. (since 0.13.0)
1078 · separator_padding = side_padding cap_padding : The padding to
1080 add to the sides of the separator, in pixels. (since 0.13.0)
1081 Example configuration
1083 See /etc/xdg/tint2/tint2rc.
1084
1086 tint2 was written by Thierry Lorthiois ⟨lorthiois@bbsoft.fr⟩. It is
1087 based on ttm, originally written by Pål Staurland ⟨staura@gmail.com⟩.
1088 This manual page was originally written by Daniel Moerner ⟨dmo‐
1090 erner@gmail.com⟩, for the Debian project (but may be used by others).
1091 It was adopted from the tint2 docs.
1092
1094 The main website ⟨https://gitlab.com/o9000/tint2⟩ and the wiki page at
1095 ⟨https://gitlab.com/o9000/tint2/wikis/home⟩.
1096 This documentation is also provided in HTML and Markdown format in the
1098 system's default location for documentation files, usually
1099 /usr/share/doc/tint2 or /usr/local/share/doc/tint2. . .
110016.7 2019-07-14 TINT2(1)