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_layer = bottom/normal/top : Places tint2 into the bot‐
405 tom/normal/top layer. This is helpful for specifying if the
406 panel can be covered by other windows or not. The default is
407 the bottom layer, but with real transparency normal or top
408 layer may be a nice alternative.
409 · strut_policy = follow_size/minimum/none : STRUTs are used by
411 the window manager to decide the size of maximized windows.
412 Note: on multi-monitor (Xinerama) setups, the panel must be
413 placed at the edge (not in the middle) of the virtual screen
414 for this to work correctly.
415 · follow_size means that the maximized windows always resize
417 to have a common edge with tint2.
418 · minimum means that the maximized windows always expand to
420 have a common edge with the hidden panel. This is useful if
421 the autohide option is enabled.
422 · none means that the maximized windows use the full screen
424 size.
425 · panel_window_name = string : Defines the name of the panel's
427 window. Default: 'tint2'. (since 0.12)
428 · disable_transparency = boolean (0 or 1) : Whether to disable
430 transparency instead of detecting if it is supported. Useful
431 on broken graphics stacks. (since 0.12)
432 · mouse_effects = boolean (0 or 1) : Whether to enable mouse
434 hover effects for clickable items. (since 0.12.3)
435 · mouse_hover_icon_asb = alpha (0 to 100) saturation (-100 to
437 100) brightness (-100 to 100) : Adjusts the icon color and
438 transparency on mouse hover (works only when mouse_effects =
439 1).` (since 0.12.3)
440 · mouse_pressed_icon_asb = alpha (0 to 100) saturation (-100 to
442 100) brightness (-100 to 100) : Adjusts the icon color and
443 transparency on mouse press (works only when mouse_effects =
444 1).` (since 0.12.3)
445 · autohide = boolean (0 or 1) : Whether to enable panel hiding
447 when the mouse cursor exists the panel.
448 · autohide_show_timeout = float : Show timeout in seconds after
450 the mouse cursor enters the panel. Use '.' as decimal separa‐
451 tor.
452 · autohide_hide_timeout = float : Hide timeout in seconds after
454 the mouse cursor exits the panel. Use '.' as decimal separa‐
455 tor.
456 · autohide_height = integer : panel height (width for vertical
458 panels) in hidden mode.
459 Launcher
461 · launcher_item_app = path_to_application : Each
462 launcher_item_app must be a file path to a .desktop file fol‐
463 lowing the freedesktop.org specification ⟨http://stan‐
464 dards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-
465 latest.html⟩. The paths may begin with ~, which is expanded to
466 the path of the user's home directory. If only a file name is
467 specified, the file is search in the standard application
468 directories ($XDG_DATA_HOME/applications,
469 ~/.local/share/applications, $XDG_DATA_DIRS/applications,
470 /usr/local/share/applications, /usr/share/applications,
471 /opt/share/applications).
472 · launcher_apps_dir = path_to_directory : Specifies a path to a
474 directory from which the launcher is loading all .desktop
475 files (all subdirectories are explored recursively). Can be
476 used multiple times. The path may begin with ~, which is
477 expanded to the path of the user's home directory. (since
478 0.12)
479 · launcher_background_id = integer : Defines which background to
481 use.
482 · launcher_icon_background_id = integer : Defines which back‐
484 ground to use for icons.
485 · launcher_padding = horizontal_padding vertical_padding spacing
487 · launcher_icon_size = integer : The launcher icon size, in pix‐
489 els.
490 · launcher_icon_theme = name_of_theme : (Optional) Uses the
492 specified icon theme to display shortcut icons. Note that
493 tint2 will detect and use the icon theme of your desktop if
494 you have an XSETTINGS manager running (which you probably do),
495 unless launcher_icon_theme_override = 1.
496 · launcher_icon_theme_override = boolean (0 or 1) : Whether
498 launcher_icon_theme overrides the value obtained from the
499 XSETTINGS manager. (since 0.12)
500 · launcher_icon_asb = alpha (0 to 100) saturation (-100 to 100)
502 brightness (-100 to 100) : Adjusts the icon color and trans‐
503 parency.
504 · launcher_tooltip = boolean (0 or 1) : Whether to show tooltips
506 for the launcher icons.
507 · startup_notifications = boolean (0 or 1) : Whether to show
509 startup notifications when starting applications from the
510 launcher. (since 0.12)
511 Taskbar / Pager
513 · taskbar_mode = single_desktop/multi_desktop
514 · single_desktop : Shows a normal taskbar listing the tasks
516 running on the current virtual desktop (also known as
517 'workspace');
518 · multi_desktop : Pager like capability. Shows multiple
520 taskbars, one per virtual desktop, with which:
521 · You can drag-and-drop tasks between virtual desktops;
523 · You can switch between virtual desktops.
525 · taskbar_hide_if_empty = boolean (0 or 1) : If enabled, in
527 multi-desktop mode the taskbars corresponding to empty desk‐
528 tops different from the current desktop are hidden. (since
529 0.13)
530 · taskbar_distribute_size = boolean (0 or 1) : If enabled, in
532 multi-desktop mode distributes between taskbars the available
533 size proportionally to the number of tasks. Default: disabled.
534 (since 0.12)
535 · taskbar_padding = horizontal_padding vertical_padding spacing
537 [](images/taskbar_padding.jpg)
539 · taskbar_background_id = integer : Which background to use
541 · taskbar_active_background_id = integer : Which background to
543 use for the taskbar of the current virtual desktop.
544 · taskbar_hide_inactive_tasks = boolean (0 or 1) : If enabled,
546 the taskbar shows only the active task. (since 0.12)
547 · taskbar_hide_different_monitor = boolean (0 or 1) : If
549 enabled, the taskbar shows only the tasks from the current
550 monitor. Useful when running different tint2 instances on dif‐
551 ferent monitors, each one having its own config. (since 0.12)
552 · taskbar_hide_different_desktop = boolean (0 or 1) : If
554 enabled, the taskbar shows only the tasks from the current
555 desktop. Useful to make multi-desktop taskbars more compact,
556 but still allow desktop switching with mouse click. (since
557 1.0)
558 · taskbar_always_show_all_desktop_tasks = boolean (0 or 1) :
560 Has effect only if taskbar_mode = multi_desktop. If enabled,
561 tasks that appear on all desktops are shown on all taskbars.
562 Otherwise, they are shown only on the taskbar of the current
563 desktop. (since 0.12.4)
564 · taskbar_sort_order = none/title/center : Specifies the sort
566 order of the tasks on the taskbar. (since 0.12)
567 · none : No sorting. New tasks are simply appended at the end
569 of the taskbar when they appear.
570 · title : Sorts the tasks by title.
572 · application : Sorts the tasks by application name. (since
574 16.3)
575 · center : Sorts the tasks by their window centers.
577 · mru : Shows the most recently used tasks first. (since
579 0.12.4)
580 · lru : Shows the most recently used tasks last. (since
582 0.12.4)
583 · task_align = left/center/right : Specifies the alignment of
585 the tasks on the taskbar. Default: left.
586 · taskbar_name = boolean (0 or 1) : Whether to show the virtual
588 desktop name in the taskbar.
589 · taskbar_name_padding = padding : Padding for the virtual
591 desktop name.
592 · taskbar_name_background_id = integer : Which background to
594 use for the desktop name.
595 · taskbar_name_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] :
597 Font configuration for the desktop name.
598 · taskbar_name_font_color = color opacity (0 to 100) : Font
600 color for the desktop name.
601 · taskbar_name_active_background_id = integer : Which back‐
603 ground to use for the name of the current desktop.
604 · taskbar_name_active_font_color = color opacity (0 to 100) :
606 Font color for the name of the current desktop.
607
609 The following options configure the task buttons in the taskbar:
610 · task_icon = boolean (0 or 1) : Whether to display the task
612 icon. There is no explicit option to control the task icon
613 size; it depends on the vertical padding set with task_pad‐
614 ding.
615 · task_text = boolean (0 or 1) : Whether to display the task
617 text.
618 · task_centered = boolean (0 or 1) : Whether the task text is
620 centered.
621 · task_tooltip = boolean (0 or 1) : Whether to show tooltips for
623 tasks.
624 · task_thumbnail = boolean (0 or 1) : Whether to show thumbnail
626 tooltips for tasks. (since 16.0)
627 · task_thumbnail_size = width : Thumbnail size. (since 16.0)
629 · task_maximum_size = width height
631 · width is used with horizontal panels to limit the size of
633 the tasks. Use width = 0 to get full taskbar width.
634 · height is used with vertical panels.
636 · task_padding = horizontal_padding vertical_padding spacing
638 · urgent_nb_of_blink = integer : Number of blinks on 'get atten‐
640 tion' events.
641 [](images/task_padding.jpg)
643 · task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
645 · task_font_color = color opacity (0 to 100)
647 · task_icon_asb = alpha (0 to 100) saturation (-100 to 100)
649 brightness (-100 to 100) : Adjust the task icon's color and
650 transparency.
651 · task_background_id = integer : Which background to use for non
653 selected tasks
654 For the next 3 options STATUS can be active / iconified / urgent:
656 * task_STATUS_font_color = color opacity (0 to 100)
657 · task_STATUS_icon_asb = alpha (0 to 100) saturation (-100 to
659 100) brightness (-100 to 100) : Adjusts the task icon's color
660 and transparency.
661 · task_STATUS_background_id = integer : Which background to use
663 for the task.
664 Mouse actions for taskbar buttons
666 The possible mouse events are: left, middle, right, scroll_up,
667 scroll_down.
668 The possible mouse actions are: none, close, toggle, iconify, shade,
670 toggle_iconify, maximize_restore, desktop_left, desktop_right,
671 next_task, prev_task.
672 Use mouse_event = action to customize mouse actions. Example:
674 mouse_middle = none
675 mouse_right = close
676 mouse_scroll_up = toggle
677 mouse_scroll_down = iconify
678 The action semantics:
680 * none : If wm_menu = 1 is set, the mouse event is forwarded to
681 the window manager. Otherwise it is ignored. * close : close
682 the task * toggle : toggle the task * iconify : iconify (mini‐
683 mize) the task * toggle_iconify : toggle or iconify the task *
684 maximize_restore : maximized or minimized the task * shade :
685 shades (collapses) the task * desktop_left : send the task to
686 the desktop on the left * desktop_right : send the task to the
687 desktop on the right * next_task : send the focus to next task *
688 prev_task : send the focus to previous task
689 System Tray
691 · systray_padding = horizontal_padding vertical_padding spacing
692 · systray_background_id = integer : Which background to use.
694 · systray_sort = ascending/descending/left2right/right2left :
696 Specifies the sorting order for the icons in the systray: in
697 ascending/descending alphabetical order of the icon title, or
698 always add icons to the right/left (note that with left2right
699 or right2left the order can be different on panel restart).
700 · systray_icon_size = max_icon_size : Set the maximum system
702 tray icon size to number. Set to 0 for automatic icon sizing.
703 · systray_icon_asb = alpha (0 to 100) saturation (-100 to 100)
705 brightness (-100 to 100) : Adjust the systray icons color and
706 transparency.
707 · systray_monitor = integer (1, 2, ...) or primary : On which
709 monitor to draw the systray. The first monitor is 1. (since
710 0.12)
711 · systray_name_filter = string : Regular expression to identify
713 icon names to be hidden. For example, ^audacious$ will hide
714 icons with the exact name audacious, while aud will hide any
715 icons having aud in the name. (since 0.13.1)
716 Clock
718 · time1_format = %H:%M : The format used by the first line of
719 the clock.
720 · time1_format, time2_format and clock_tooltip use the 'strf‐
722 time' syntax. More info can be found here: ⟨http://www.man‐
723 pagez.com/man/3/strftime/⟩
724 · To hide the clock, comment time1_format and time2_format.
726 · time1_timezone = :US/Hawaii
728 · time1_timezone, time2_timezone and clock_tooltip_timezone
730 can be used to specify a timezone. If you do not specify a
731 value the system-wide timezone is used. The timezones can
732 usually be found in /usr/share/zoneinfo. If your timezones
733 are in a different directory, you need to specify the abso‐
734 lute path, e.g. time1_timezone = :/different/zone‐
735 info/dir/US/Hawaii Always prepend the timezone with a ':'
736 · time1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
738 · time2_format = %A %d %B
740 · time2_timezone = :Europe/Berlin
742 · time2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
744 · clock_font_color = color opacity (0 to 100)
746 · clock_padding = horizontal_padding vertical_padding
748 · clock_background_id = integer : Which background to use
750 · clock_tooltip = %a, %d. %b %Y : Format for the clock's
752 tooltip.
753 · clock_tooltip_timezone = :UTC
755 · clock_lclick_command = text : Command to execute on left
757 click.
758 · clock_rclick_command = text : Command to execute on right
760 click.
761 · clock_mclick_command = text : Command to execute on middle
763 click. (since 0.12.1)
764 · clock_uwheel_command = text : Command to execute on wheel
766 scroll up. (since 0.12.1)
767 · clock_dwheel_command = text : Command to execute on wheel
769 scroll down. (since 0.12.1)
770 Tooltip
772 · tooltip_padding = horizontal_padding vertical_padding
773 · tooltip_show_timeout = float : Delay to show the tooltip in
775 seconds. Use . as decimal separator.
776 · tooltip_hide_timeout = float : Delay to hide the tooltip in
778 seconds. Use . as decimal separator.
779 · tooltip_background_id = integer : Which background to use for
781 tooltips. Note that with fake transparency the alpha channel
782 and corner radius options are not respected.
783 · tooltip_font_color = color opacity (0 to 100)
785 · tooltip_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
787 Battery
789 · battery_hide = never/integer (0 to 100) : At what battery per‐
790 centage the battery item is hidden.
791 · battery_low_status = integer: At what battery percentage the
793 low command is executed.
794 · battery_low_cmd = xmessage 'tint2: Battery low!' : Command to
796 execute when the battery is low.
797 · battery_full_cmd = notify-send "battery full" : Command to
799 execute when the battery is full.
800 · bat1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
802 · bat2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
804 · battery_font_color = color opacity (0 to 100)
806 · bat1_format = FORMAT_STRING : Format for battery line 1.
808 Default: %p. (since 1.0) Format specification:
809 · %s: State (charging, discharging, full, unknown).
811 · %m: Minutes left until completely charged/discharged (esti‐
813 mated).
814 · %h: Hours left until completely charged/discharged (esti‐
816 mated).
817 · %t: Time left. Shows "hrs:mins" when charging/discharging,
819 or "Ful\" when full.
820 · %p: Percentage. Includes the % sign.
822 · bat2_format = FORMAT_STRING : Format for battery line 2.
824 Default: %t. (since 1.0)
825 · battery_padding = horizontal_padding vertical_padding
827 · battery_background_id = integer : Which background to use for
829 the battery.
830 · battery_tooltip_enabled = boolean (0 or 1) : Enable/disable
832 battery tooltips. (since 0.12.3)
833 · battery_lclick_command = text : Command to execute on left
835 click. (since 0.12.1)
836 · battery_rclick_command = text : Command to execute on right
838 click. (since 0.12.1)
839 · battery_mclick_command = text : Command to execute on middle
841 click. (since 0.12.1)
842 · battery_uwheel_command = text : Command to execute on wheel
844 scroll up. (since 0.12.1)
845 · battery_dwheel_command = text : Command to execute on wheel
847 scroll down. (since 0.12.1)
848 · ac_connected_cmd = text : Command to execute when the power
850 adapter is plugged in. (since 0.12.3)
851 · ac_disconnected_cmd = text : Command to execute when the power
853 adapter is unplugged. (since 0.12.3)
854 Executor
856 · execp = new : Begins the configuration of a new executor plug‐
857 in. Multiple such plugins are supported; just use multiple Es
858 in panel_items. (since 0.12.4)
859 · execp_command = text : Command to execute. (since 0.12.4)
861 · execp_interval = integer : The command is executed again after
863 execp_interval seconds from the moment it exits. If zero, the
864 command is executed only once. (since 0.12.4)
865 · execp_continuous = integer : If non-zero, the last execp_con‐
867 tinuous lines from the output of the command are displayed,
868 every execp_continuous lines; this is useful for showing the
869 output of commands that run indefinitely, such as ping
870 127.0.0.1. If zero, the output of the command is displayed
871 after it finishes executing. (since 0.12.4)
872 · execp_has_icon = boolean (0 or 1) : If execp_has_icon = 1, the
874 first line printed by the command is interpreted as a path to
875 an image file. (since 0.12.4)
876 · execp_cache_icon = boolean (0 or 1) : If execp_cache_icon = 0,
878 the image is reloaded each time the command is executed (use‐
879 ful if the image file is changed on disk by the program exe‐
880 cuted by execp_command). (since 0.12.4)
881 · execp_icon_w = integer : You can use execp_icon_w and
883 execp_icon_h to resize the image. If one of them is zero/miss‐
884 ing, the image is rescaled proportionally. If both of them are
885 zero/missing, the image is not rescaled. (since 0.12.4)
886 · execp_icon_h = integer : See execp_icon_w. (since 0.12.4)
888 · execp_tooltip = text : The tooltip. If left empty, no tooltip
890 is displayed. If missing, the standard error of the command is
891 shown as a tooltip (an ANSI clear screen sequence can reset
892 the contents, bash: printf '\e[2J', C: printf("\x1b[2J");). If
893 the standard error is empty, the tooltip will show information
894 about the time when the command was last executed. (since
895 0.12.4)
896 · execp_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
898 used to draw the text. (since 0.12.4)
899 · execp_font_color = color opacity : The font color. (since
901 0.12.4)
902 · execp_markup = boolean (0 or 1) : If non-zero, the output of
904 the command is treated as Pango markup, which allows rich text
905 formatting. The format is documented here ⟨https://devel‐
906 oper.gnome.org/pygtk/stable/pango-markup-language.html⟩. Note
907 that using this with commands that print data downloaded from
908 the Internet is a possible security risk. (since 0.12.4)
909 · execp_background_id = integer : Which background to use.
911 (since 0.12.4)
912 · execp_centered = boolean (0 or 1) : Whether to center the
914 text. (since 0.12.4)
915 · execp_padding = horizontal_padding vertical_padding spac‐
917 ing_between_icon_and_text (since 0.12.4)
918 · execp_lclick_command = text : Command to execute on left
920 click. If not defined, execp_command is executed immediately,
921 unless it is currently running. (since 0.12.4)
922 · execp_mclick_command = text : Command to execute on right
924 click. If not defined, execp_command is executed immediately,
925 unless it is currently running. (since 0.12.4)
926 · execp_rclick_command = text : Command to execute on middle
928 click. If not defined, execp_command is executed immediately,
929 unless it is currently running. (since 0.12.4)
930 · execp_uwheel_command = text : Command to execute on wheel
932 scroll up. If not defined, execp_command is executed immedi‐
933 ately, unless it is currently running. (since 0.12.4)
934 · execp_dwheel_command = text : Command to execute on wheel
936 scroll down. If not defined, execp_command is executed imme‐
937 diately, unless it is currently running. (since 0.12.4)
938 Executor samples
940 Print the hostname
941 execp = new
942 execp_command = hostname
943 execp_interval = 0
944 Print disk usage for the root partition every 10 seconds
946 execp = new
947 execp_command = df -h | awk '/\/$/ { print $6 ": " $2 " " $5}'
948 execp_interval = 10
949 Button with icon and rich text, executes command when clicked
951 execp = new
952 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>'
953 execp_has_icon = 1
954 execp_interval = 0
955 execp_centered = 1
956 execp_font = sans 9
957 execp_markup = 1
958 execp_font_color = #aaffaa 100
959 execp_padding = 2 0
960 execp_tooltip = I will tell you a secret...
961 execp_lclick_command = zenity --info "--text=$(uname -sr)"
962 execp_background_id = 2
963 Desktop pager with text
965 execp = new
966 execp_command = xprop -root -spy | awk '/^_NET_CURRENT_DESKTOP/ { print "Workspace " ($3 + 1) ; fflush(); }'
967 execp_interval = 1
968 execp_continuous = 1
969 Desktop pager with icon
971 execp_command = xprop -root -spy | awk -v home="$HOME" '/^_NET_CURRENT_DESKTOP/ { print home "/.config/myPager/" ($3 + 1) ".png\n" ; fflush(); }'
972 execp_interval = 1
973 execp_has_icon = 1
974 execp_cache_icon = 1
975 execp_continuous = 2
976 Round-trip time to the gateway, refreshed every second
978 execp = new
979 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(); } '
980 execp_continuous = 0
981 execp_interval = 1
982 execp_markup = 1
983 Memory usage
985 execp = new
986 execp_command = free | awk '/^-/ { printf "Mem: '$(free -h | awk '/^Mem:/ { print $2 }')' %.0f%%\n", 100*$3/($3+$4); fflush(stdout) }'
987 execp_interval = 5
988 execp_continuous = 0
989 Network load
991 # Note the use of "stdbuf -oL" to force the program to flush the output line by line.
992 execp = new
993 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)'
994 execp_continuous = 1
995 execp_interval = 1
996 Button
998 · button = new : Begins the configuration of a new button. Mul‐
999 tiple such plugins are supported; just use multiple Ps in
1000 panel_items. (since 0.14)
1001 · button_icon = text : Name or path of icon (or empty). (since
1003 0.14)
1004 · button_text = text : Text to display (or empty). (since 0.14)
1006 · button_tooltip = text : The tooltip (or empty). (since 0.14)
1008 · button_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
1010 used to draw the text. (since 0.14)
1011 · button_font_color = color opacity : The font color. (since
1013 0.14)
1014 · button_background_id = integer : Which background to use.
1016 (since 0.14)
1017 · button_centered = boolean (0 or 1) : Whether to center the
1019 text. (since 0.14)
1020 · button_padding = horizontal_padding vertical_padding spac‐
1022 ing_between_icon_and_text (since 0.14)
1023 · button_max_icon_size = integer : Sets a limit to the icon
1025 size. Otherwise, the icon will expand to the edges. (since
1026 0.14)
1027 · button_lclick_command = text : Command to execute on left
1029 click. If not defined, execp_command is executed immediately,
1030 unless it is currently running. (since 0.14)
1031 · button_mclick_command = text : Command to execute on right
1033 click. If not defined, execp_command is executed immediately,
1034 unless it is currently running. (since 0.14)
1035 · button_rclick_command = text : Command to execute on middle
1037 click. If not defined, execp_command is executed immediately,
1038 unless it is currently running. (since 0.14)
1039 · button_uwheel_command = text : Command to execute on wheel
1041 scroll up. If not defined, execp_command is executed immedi‐
1042 ately, unless it is currently running. (since 0.14)
1043 · button_dwheel_command = text : Command to execute on wheel
1045 scroll down. If not defined, execp_command is executed imme‐
1046 diately, unless it is currently running. (since 0.14)
1047 Separator
1049 · separator = new : Begins the configuration of a new separator.
1050 Multiple such plugins are supported; just use multiple :s in
1051 panel_items. (since 0.13.0)
1052 · separator_background_id = integer : Which background to use.
1054 (since 0.13.0)
1055 · separator_color = color opacity : The foreground color. (since
1057 0.13.0)
1058 · separator_style = [empty | line | dots] : The separator style.
1060 (since 0.13.0)
1061 · separator_size = integer : The thickness of the separator.
1063 Does not include the border and padding. For example, if the
1064 style is line, this is the line thickness; if the style is
1065 dots, this is the dot's diameter. (since 0.13.0)
1066 · separator_padding = side_padding cap_padding : The padding to
1068 add to the sides of the separator, in pixels. (since 0.13.0)
1069 Example configuration
1071 See /etc/xdg/tint2/tint2rc.
1072
1074 tint2 was written by Thierry Lorthiois ⟨lorthiois@bbsoft.fr⟩. It is
1075 based on ttm, originally written by Pål Staurland ⟨staura@gmail.com⟩.
1076 This manual page was originally written by Daniel Moerner ⟨dmo‐
1078 erner@gmail.com⟩, for the Debian project (but may be used by others).
1079 It was adopted from the tint2 docs.
1080
1082 The main website ⟨https://gitlab.com/o9000/tint2⟩ and the wiki page at
1083 ⟨https://gitlab.com/o9000/tint2/wikis/home⟩.
1084 This documentation is also provided in HTML and Markdown format in the
1086 system's default location for documentation files, usually
1087 /usr/share/doc/tint2 or /usr/local/share/doc/tint2. .
108816.6.1 2018-08-05 TINT2(1)