1TINT2(1) General Commands Manual TINT2(1)
2
3
4
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
13 Features:
14
15 · Panel with taskbar, system tray, clock and launcher icons;
16
17 · Easy to customize: color/transparency on fonts, icons, borders
18 and backgrounds;
19
20 · Pager like capability: move tasks between workspaces (virtual
21 desktops), switch between workspaces;
22
23 · Multi-monitor capability: create one panel per monitor, show‐
24 ing only the tasks from the current monitor;
25
26 · Customizable mouse events.
27
28 Goals:
29
30 · Be unintrusive and light (in terms of memory, CPU and aes‐
31 thetic);
32
33 · Follow the freedesktop.org specifications;
34
35 · 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
46 -v, --version
47 Prints version information and exits.
48
49 -h, --help
50 Display this help and exits.
51
53 Table of contents
54 · Introduction ⟨#introduction⟩
55
56 · Backgrounds and borders ⟨#backgrounds-and-borders⟩
57
58 · Gradients ⟨#gradients⟩
59
60 · Panel ⟨#panel⟩
61
62 · Launcher ⟨#launcher⟩
63
64 · Taskbar/Pager ⟨#taskbar-pager⟩
65
66 · Taskbar buttons ⟨#taskbar-buttons⟩
67
68 · Mouse actions for taskbar buttons ⟨#mouse-actions-for-taskbar-
69 buttons⟩
70
71 · System tray ⟨#system-tray⟩
72
73 · Clock ⟨#clock⟩
74
75 · Tooltip ⟨#tooltip⟩
76
77 · Battery ⟨#battery⟩
78
79 · Executor ⟨#executor⟩
80
81 · Button ⟨#button⟩
82
83 · Separator ⟨#separator⟩
84
85 · Example configuration ⟨#example-configuration⟩
86
87 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
92 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
97 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
101 If you change the config file while tint2 is running, the command kil‐
102 lall -SIGUSR1 tint2 will force tint2 to reload it.
103
104 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
108 Backgrounds and borders
109 The tint2 config file starts with the options defining background ele‐
110 ments with borders:
111
112 · rounded = number_of_pixels : the corner radius
113
114 · border_width = integer : the border width in pixels
115
116 · 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
120 · background_color = color opacity
121
122 · color is specified in hex RGB, e.g. #ff0000 is red
123
124 · 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
129 · border_color = color opacity
130
131 · color is specified in hex RGB, e.g. #ff0000 is red
132
133 · opacity varies from (0 to 100), where 0 is fully transpar‐
134 ent, 100 is fully opaque
135
136 · background_color_hover = color opacity (default: same as back‐
137 ground_color) (since 0.12.3)
138
139 · color is specified in hex RGB, e.g. #ff0000 is red
140
141 · 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
146 · border_color_hover = color opacity (default: same as bor‐
147 der_color) (since 0.12.3)
148
149 · color is specified in hex RGB, e.g. #ff0000 is red
150
151 · opacity varies from (0 to 100), where 0 is fully transpar‐
152 ent, 100 is fully opaque
153
154 · background_color_pressed = color opacity (default: same as
155 background_color_hover) (since 0.12.3)
156
157 · color is specified in hex RGB, e.g. #ff0000 is red
158
159 · 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
164 · border_color_pressed = color opacity (default: same as bor‐
165 der_color_hover) (since 0.12.3)
166
167 · color is specified in hex RGB, e.g. #ff0000 is red
168
169 · opacity varies from (0 to 100), where 0 is fully transpar‐
170 ent, 100 is fully opaque
171
172 · 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
177 · 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
182 You can define as many backgrounds as you want. For example, the fol‐
183 lowing config defines two backgrounds:
184
185 rounded = 1
186 border_width = 0
187 background_color = #282828 100
188 border_color = #000000 0
189
190 rounded = 1
191 border_width = 0
192 background_color = #f6b655 90
193 border_color = #cccccc 40
194
195 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
200 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
207 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
211 Gradients
212 (Available since 0.13.0)
213
214 Backgrounds also allow specifying gradient layers that are drawn on top
215 of the solid color background.
216
217 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
221 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
225 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
230 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
234 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
240 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
246 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
252 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
256 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
263 # Gradient 2: radial glow
264 gradient = radial
265 start_color = #ffffff 20
266 end_color = #ffffff 0
267
268 # Gradient 3: elegant black
269 gradient = vertical
270 start_color = #444444 100
271 end_color = #222222 100
272
273 # Gradient 4: elegant black
274 gradient = horizontal
275 start_color = #111111 100
276 end_color = #222222 100
277
278 # 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
292 [...]
293
294 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
299 · L shows the Launcher
300
301 · T shows the Taskbar
302
303 · S shows the Systray (also called notification area)
304
305 · B shows the Battery status
306
307 · C shows the Clock
308
309 · 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
313 · E adds an executor plugin. You can specify more than one.
314 (since 0.12.4)
315
316 · P adds a push button. You can specify more than one. (since
317 0.14)
318
319 · : adds a separator. You can specify more than one. (since
320 0.13.0)
321
322 For example, panel_items = STC will show the systray, the
323 taskbar and the clock (from left to right).
324
325 · panel_monitor = monitor (all or primary or 1 or 2 or ...) :
326 Which monitor tint2 draws the panel on
327
328 · The first monitor is 1
329
330 · Use panel_monitor = all to get a separate panel per monitor
331
332 · 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
336 [](images/panel_padding.jpg)
337
338 · panel_position = vertical_position horizontal_position orien‐
339 tation
340
341 · vertical_position is one of: bottom, top, center
342
343 · horizontal_position is one of: left, right, center
344
345 · orientation is one of: horizontal, vertical
346
347 · panel_size = width height
348
349 · 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
354 · 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
363 · 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
370 # The panel's width is 94% the size of the monitor, the height is 30 pixels:
371 panel_size = 94% 30
372
373 · panel_shrink = boolean (0 or 1) : If set to 1, the panel will
374 shrink to a compact size dynamically. (since 0.13)
375
376 · 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
381 [](images/panelsizemargin.jpg)
382
383 · panel_padding = horizontal_padding vertical_padding spacing :
384 Please refer to the image below.
385
386 [](images/panel_padding.jpg)
387
388 · font_shadow = boolean (0 or 1)
389
390 · panel_background_id = integer : Which background to use for
391 the panel.
392
393 · 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
398 · 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
404 · 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
410 · 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
416 · follow_size means that the maximized windows always resize
417 to have a common edge with tint2.
418
419 · 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
423 · none means that the maximized windows use the full screen
424 size.
425
426 · panel_window_name = string : Defines the name of the panel's
427 window. Default: 'tint2'. (since 0.12)
428
429 · 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
433 · mouse_effects = boolean (0 or 1) : Whether to enable mouse
434 hover effects for clickable items. (since 0.12.3)
435
436 · 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
441 · 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
446 · autohide = boolean (0 or 1) : Whether to enable panel hiding
447 when the mouse cursor exists the panel.
448
449 · autohide_show_timeout = float : Show timeout in seconds after
450 the mouse cursor enters the panel. Use '.' as decimal separa‐
451 tor.
452
453 · autohide_hide_timeout = float : Hide timeout in seconds after
454 the mouse cursor exits the panel. Use '.' as decimal separa‐
455 tor.
456
457 · autohide_height = integer : panel height (width for vertical
458 panels) in hidden mode.
459
460 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
473 · 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
480 · launcher_background_id = integer : Defines which background to
481 use.
482
483 · launcher_icon_background_id = integer : Defines which back‐
484 ground to use for icons.
485
486 · launcher_padding = horizontal_padding vertical_padding spacing
487
488 · launcher_icon_size = integer : The launcher icon size, in pix‐
489 els.
490
491 · 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
497 · 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
501 · 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
505 · launcher_tooltip = boolean (0 or 1) : Whether to show tooltips
506 for the launcher icons.
507
508 · startup_notifications = boolean (0 or 1) : Whether to show
509 startup notifications when starting applications from the
510 launcher. (since 0.12)
511
512 Taskbar / Pager
513 · taskbar_mode = single_desktop/multi_desktop
514
515 · single_desktop : Shows a normal taskbar listing the tasks
516 running on the current virtual desktop (also known as
517 'workspace');
518
519 · multi_desktop : Pager like capability. Shows multiple
520 taskbars, one per virtual desktop, with which:
521
522 · You can drag-and-drop tasks between virtual desktops;
523
524 · You can switch between virtual desktops.
525
526 · 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
531 · 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
536 · taskbar_padding = horizontal_padding vertical_padding spacing
537
538 [](images/taskbar_padding.jpg)
539
540 · taskbar_background_id = integer : Which background to use
541
542 · taskbar_active_background_id = integer : Which background to
543 use for the taskbar of the current virtual desktop.
544
545 · taskbar_hide_inactive_tasks = boolean (0 or 1) : If enabled,
546 the taskbar shows only the active task. (since 0.12)
547
548 · 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
553 · 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
559 · 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
565 · taskbar_sort_order = none/title/center : Specifies the sort
566 order of the tasks on the taskbar. (since 0.12)
567
568 · none : No sorting. New tasks are simply appended at the end
569 of the taskbar when they appear.
570
571 · title : Sorts the tasks by title.
572
573 · application : Sorts the tasks by application name. (since
574 16.3)
575
576 · center : Sorts the tasks by their window centers.
577
578 · mru : Shows the most recently used tasks first. (since
579 0.12.4)
580
581 · lru : Shows the most recently used tasks last. (since
582 0.12.4)
583
584 · task_align = left/center/right : Specifies the alignment of
585 the tasks on the taskbar. Default: left.
586
587 · taskbar_name = boolean (0 or 1) : Whether to show the virtual
588 desktop name in the taskbar.
589
590 · taskbar_name_padding = padding : Padding for the virtual
591 desktop name.
592
593 · taskbar_name_background_id = integer : Which background to
594 use for the desktop name.
595
596 · taskbar_name_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] :
597 Font configuration for the desktop name.
598
599 · taskbar_name_font_color = color opacity (0 to 100) : Font
600 color for the desktop name.
601
602 · taskbar_name_active_background_id = integer : Which back‐
603 ground to use for the name of the current desktop.
604
605 · 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
611 · 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
616 · task_text = boolean (0 or 1) : Whether to display the task
617 text.
618
619 · task_centered = boolean (0 or 1) : Whether the task text is
620 centered.
621
622 · task_tooltip = boolean (0 or 1) : Whether to show tooltips for
623 tasks.
624
625 · task_thumbnail = boolean (0 or 1) : Whether to show thumbnail
626 tooltips for tasks. (since 16.0)
627
628 · task_thumbnail_size = width : Thumbnail size. (since 16.0)
629
630 · task_maximum_size = width height
631
632 · width is used with horizontal panels to limit the size of
633 the tasks. Use width = 0 to get full taskbar width.
634
635 · height is used with vertical panels.
636
637 · task_padding = horizontal_padding vertical_padding spacing
638
639 · urgent_nb_of_blink = integer : Number of blinks on 'get atten‐
640 tion' events.
641
642 [](images/task_padding.jpg)
643
644 · task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
645
646 · task_font_color = color opacity (0 to 100)
647
648 · 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
652 · task_background_id = integer : Which background to use for non
653 selected tasks
654
655 For the next 3 options STATUS can be active / iconified / urgent:
656 * task_STATUS_font_color = color opacity (0 to 100)
657
658 · 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
662 · task_STATUS_background_id = integer : Which background to use
663 for the task.
664
665 Mouse actions for taskbar buttons
666 The possible mouse events are: left, middle, right, scroll_up,
667 scroll_down.
668
669 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
673 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
679 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
690 System Tray
691 · systray_padding = horizontal_padding vertical_padding spacing
692
693 · systray_background_id = integer : Which background to use.
694
695 · 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
701 · systray_icon_size = max_icon_size : Set the maximum system
702 tray icon size to number. Set to 0 for automatic icon sizing.
703
704 · 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
708 · 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
712 · 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
717 Clock
718 · time1_format = %H:%M : The format used by the first line of
719 the clock.
720
721 · 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
725 · To hide the clock, comment time1_format and time2_format.
726
727 · time1_timezone = :US/Hawaii
728
729 · 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
737 · time1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
738
739 · time2_format = %A %d %B
740
741 · time2_timezone = :Europe/Berlin
742
743 · time2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
744
745 · clock_font_color = color opacity (0 to 100)
746
747 · clock_padding = horizontal_padding vertical_padding
748
749 · clock_background_id = integer : Which background to use
750
751 · clock_tooltip = %a, %d. %b %Y : Format for the clock's
752 tooltip.
753
754 · clock_tooltip_timezone = :UTC
755
756 · clock_lclick_command = text : Command to execute on left
757 click.
758
759 · clock_rclick_command = text : Command to execute on right
760 click.
761
762 · clock_mclick_command = text : Command to execute on middle
763 click. (since 0.12.1)
764
765 · clock_uwheel_command = text : Command to execute on wheel
766 scroll up. (since 0.12.1)
767
768 · clock_dwheel_command = text : Command to execute on wheel
769 scroll down. (since 0.12.1)
770
771 Tooltip
772 · tooltip_padding = horizontal_padding vertical_padding
773
774 · tooltip_show_timeout = float : Delay to show the tooltip in
775 seconds. Use . as decimal separator.
776
777 · tooltip_hide_timeout = float : Delay to hide the tooltip in
778 seconds. Use . as decimal separator.
779
780 · 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
784 · tooltip_font_color = color opacity (0 to 100)
785
786 · tooltip_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
787
788 Battery
789 · battery_hide = never/integer (0 to 100) : At what battery per‐
790 centage the battery item is hidden.
791
792 · battery_low_status = integer: At what battery percentage the
793 low command is executed.
794
795 · battery_low_cmd = xmessage 'tint2: Battery low!' : Command to
796 execute when the battery is low.
797
798 · battery_full_cmd = notify-send "battery full" : Command to
799 execute when the battery is full.
800
801 · bat1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
802
803 · bat2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]
804
805 · battery_font_color = color opacity (0 to 100)
806
807 · bat1_format = FORMAT_STRING : Format for battery line 1.
808 Default: %p. (since 1.0) Format specification:
809
810 · %s: State (charging, discharging, full, unknown).
811
812 · %m: Minutes left until completely charged/discharged (esti‐
813 mated).
814
815 · %h: Hours left until completely charged/discharged (esti‐
816 mated).
817
818 · %t: Time left. Shows "hrs:mins" when charging/discharging,
819 or "Ful\" when full.
820
821 · %p: Percentage. Includes the % sign.
822
823 · bat2_format = FORMAT_STRING : Format for battery line 2.
824 Default: %t. (since 1.0)
825
826 · battery_padding = horizontal_padding vertical_padding
827
828 · battery_background_id = integer : Which background to use for
829 the battery.
830
831 · battery_tooltip_enabled = boolean (0 or 1) : Enable/disable
832 battery tooltips. (since 0.12.3)
833
834 · battery_lclick_command = text : Command to execute on left
835 click. (since 0.12.1)
836
837 · battery_rclick_command = text : Command to execute on right
838 click. (since 0.12.1)
839
840 · battery_mclick_command = text : Command to execute on middle
841 click. (since 0.12.1)
842
843 · battery_uwheel_command = text : Command to execute on wheel
844 scroll up. (since 0.12.1)
845
846 · battery_dwheel_command = text : Command to execute on wheel
847 scroll down. (since 0.12.1)
848
849 · ac_connected_cmd = text : Command to execute when the power
850 adapter is plugged in. (since 0.12.3)
851
852 · ac_disconnected_cmd = text : Command to execute when the power
853 adapter is unplugged. (since 0.12.3)
854
855 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
860 · execp_command = text : Command to execute. (since 0.12.4)
861
862 · 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
866 · 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
873 · 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
877 · 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
882 · 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
887 · execp_icon_h = integer : See execp_icon_w. (since 0.12.4)
888
889 · 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
897 · execp_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
898 used to draw the text. (since 0.12.4)
899
900 · execp_font_color = color opacity : The font color. (since
901 0.12.4)
902
903 · 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
910 · execp_background_id = integer : Which background to use.
911 (since 0.12.4)
912
913 · execp_centered = boolean (0 or 1) : Whether to center the
914 text. (since 0.12.4)
915
916 · execp_padding = horizontal_padding vertical_padding spac‐
917 ing_between_icon_and_text (since 0.12.4)
918
919 · 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
923 · 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
927 · 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
931 · 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
935 · 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
939 Executor samples
940 Print the hostname
941 execp = new
942 execp_command = hostname
943 execp_interval = 0
944
945 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
950 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
964 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
970 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
977 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
984 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
990 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
997 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
1002 · button_icon = text : Name or path of icon (or empty). (since
1003 0.14)
1004
1005 · button_text = text : Text to display (or empty). (since 0.14)
1006
1007 · button_tooltip = text : The tooltip (or empty). (since 0.14)
1008
1009 · button_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
1010 used to draw the text. (since 0.14)
1011
1012 · button_font_color = color opacity : The font color. (since
1013 0.14)
1014
1015 · button_background_id = integer : Which background to use.
1016 (since 0.14)
1017
1018 · button_centered = boolean (0 or 1) : Whether to center the
1019 text. (since 0.14)
1020
1021 · button_padding = horizontal_padding vertical_padding spac‐
1022 ing_between_icon_and_text (since 0.14)
1023
1024 · 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
1028 · 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
1032 · 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
1036 · 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
1040 · 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
1044 · 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
1048 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
1053 · separator_background_id = integer : Which background to use.
1054 (since 0.13.0)
1055
1056 · separator_color = color opacity : The foreground color. (since
1057 0.13.0)
1058
1059 · separator_style = [empty | line | dots] : The separator style.
1060 (since 0.13.0)
1061
1062 · 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
1067 · separator_padding = side_padding cap_padding : The padding to
1068 add to the sides of the separator, in pixels. (since 0.13.0)
1069
1070 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
1077 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
1085 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. .
1088
1089
1090
109116.6.1 2018-08-05 TINT2(1)