Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
TINT2(1)		    General Commands Manual		      TINT2(1)

NAME
       tint2 - lightweight panel/taskbar

DESCRIPTION
       tint2  is a simple panel/taskbar	made for modern	X window managers.  It
       was specifically	made for Openbox but it	should also  work  with	 other
       window managers (GNOME, KDE, XFCE etc.).

       Features:

	      	Panel with taskbar, system tray, clock and launcher icons;

	      	Easy to	customize: color/transparency on fonts,	icons, borders
		and backgrounds;

	      	Pager  like capability:	move tasks between workspaces (virtual
		desktops), switch between workspaces;

	      	Multi-monitor capability: create one panel per monitor,	 show-
		ing only the tasks from	the current monitor;

	      	Customizable mouse events.

       Goals:

	      	Be  unintrusive	 and  light  (in terms of memory, CPU and aes-
		thetic);

	      	Follow the freedesktop.org specifications;

	      	Make certain workflows,	such as	multi-desktop and  multi-moni-
		tor, easy to use.

SYNOPSIS
       tint2 [OPTION...]

OPTIONS
       -c path_to_config_file
	      Specifies	 which	configuration  file  to	use instead of the de-
	      fault.

       -v, --version
	      Prints version information and exits.

       -h, --help
	      Display this help	and exits.

CONFIGURATION
   Table of contents
	      	Introduction <#introduction>

	      	Backgrounds and	borders	<#backgrounds-and-borders>

	      	Gradients <#gradients>

	      	Panel <#panel>

	      	Launcher <#launcher>

	      	Taskbar/Pager <#taskbar-pager>

	      	Taskbar	buttons	<#taskbar-buttons>

	      	Mouse actions for taskbar buttons <#mouse-actions-for-taskbar-
		buttons>

	      	System tray <#system-tray>

	      	Clock <#clock>

	      	Tooltip	<#tooltip>

	      	Battery	<#battery>

	      	Executor <#executor>

	      	Button <#button>

	      	Separator <#separator>

	      	Example	configuration <#example-configuration>

   Introduction
       These are instructions for configuring tint2 directly  by  editing  its
       config  file.   You  may	 also  use  instead  the  graphical  interface
       tint2conf.

       The first time you run  tint2,  it  will	 create	 the  config  file  in
       $HOME/.config/tint2/tint2rc  (This applies if you have done a clean in-
       stall. Running tint2 in the source directory without  doing  'make  in-
       stall' will not create the config file.)

       You  can	 also specify another file on the command line with the	-c op-
       tion, e.g.: tint2 -c $HOME/tint2.conf. This can be used to run multiple
       instances of tint2 that use different settings.

       If you change the config	file while tint2 is running, the command  kil-
       lall -SIGUSR1 tint2 will	force tint2 to reload it.

       All  the	 configuration options supported in the	config file are	listed
       below.  Try to respect as much as possible the order of the options  as
       given below.

   Backgrounds and borders
       The  tint2 config file starts with the options defining background ele-
       ments with borders:

	      	rounded	= number_of_pixels : the corner	radius

	      	border_width = integer : the border width in pixels

	      	border_sides = LRTB : the sides	to draw	the border  on	(left,
		right,	top,  bottom).	If  not	specified, all sides are used.
		(since 0.12.12)

	      	background_color = color opacity

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity varies from (0 to 100), where	0 is  fully  transpar-
		  ent,	100 is fully opaque. Note that for a transparent panel
		  you need to enable a desktop compositor (such	as compton  or
		  compiz).

	      	border_color = color opacity

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity  varies  from	(0 to 100), where 0 is fully transpar-
		  ent, 100 is fully opaque

	      	background_color_hover = color opacity (default: same as back-
		ground_color) (since 0.12.3)

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity varies from (0 to 100), where	0 is  fully  transpar-
		  ent,	100 is fully opaque. Note that for a transparent panel
		  you need to enable a desktop compositor (such	as compton  or
		  compiz)

	      	border_color_hover  =  color  opacity  (default:  same as bor-
		der_color) (since 0.12.3)

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity varies from (0 to 100), where	0 is  fully  transpar-
		  ent, 100 is fully opaque

	      	background_color_pressed  =  color  opacity  (default: same as
		background_color_hover)	(since 0.12.3)

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity varies from (0 to 100), where	0 is  fully  transpar-
		  ent,	100 is fully opaque. Note that for a transparent panel
		  you need to enable a desktop compositor (such	as compton  or
		  compiz)

	      	border_color_pressed  =	 color	opacity	(default: same as bor-
		der_color_hover) (since	0.12.3)

		 color	is specified in	hex RGB, e.g. #ff0000 is red

		 opacity varies from (0 to 100), where	0 is  fully  transpar-
		  ent, 100 is fully opaque

	      	border_content_tint_weight  = integer :	Mixes the border color
		with the content color (for tasks, this	is the	average	 color
		of  the	window icon). Values must be between 0 (no mixing) and
		100 (fully replaces the	color).	(since 16.0)

	      	background_content_tint_weight = integer  :  Mixes  the	 back-
		ground	color  with  the content color (for tasks, this	is the
		average	color of the window icon). Values must	be  between  0
		(no mixing) and	100 (fully replaces the	color).	(since 16.0)

       You  can	 define	as many	backgrounds as you want. For example, the fol-
       lowing config defines two backgrounds:

	      rounded =	1
	      border_width = 0
	      background_color = #282828 100
	      border_color = #000000 0

	      rounded =	1
	      border_width = 0
	      background_color = #f6b655 90
	      border_color = #cccccc 40

       tint2 automatically identifies each background with a  number  starting
       from  1 (1, 2, ...).  Afterwards, you can apply a background to objects
       (panel, taskbar,	task, clock, systray) using the	background id, for ex-
       ample:

	      panel_background_id = 1
	      taskbar_background_id = 0
	      task_background_id = 0
	      task_active_background_id	= 2
	      systray_background_id = 0
	      clock_background_id = 0

       Identifier 0 refers to a	special	background which is fully transparent,
       identifier 1 applies the	first background defined in  the  config  file
       etc.

   Gradients
       (Available since	0.13.0)

       Backgrounds also	allow specifying gradient layers that are drawn	on top
       of the solid color background.

       First  the  user	 must define one or more gradients in the config file,
       each starting with gradient = TYPE. These must be  added	 before	 back-
       grounds.

       Then  gradients	can be added by	index to backgrounds, using the	gradi-
       ent_id =	INDEX, gradient_id_hover = INDEX and gradient_id_pressed = IN-
       DEX, where INDEX	is the gradient	index, starting	from 1.

   Gradient types
       Gradients vary the color	between	fixed control points: *	vertical  gra-
       dients:	top-to-bottom; * horizontal gradients: left-to-right; *	radial
       gradients: center-to-corners.

       The user	must specify the start and end colors, and can optionally  add
       extra  color stops in between using the color_stop option, as explained
       below.

   Vertical gradient, with color varying from the top edge to the bottom edge,
       two colors
	      gradient = vertical
	      start_color = #rrggbb opacity
	      end_color	= #rrggbb opacity

   Horizontal gradient,	with color varying from	the left  edge	to  the	 right
       edge, two colors
	      gradient = horizontal
	      start_color = #rrggbb opacity
	      end_color	= #rrggbb opacity

   Radial gradient, with color varying from the	center to the corner, two col-
       ors:
	      gradient = radial
	      start_color = #rrggbb opacity
	      end_color	= #rrggbb opacity

   Adding  extra  color	stops (0% and 100% remain fixed, more colors at	x% be-
       tween the start and end control points)
	      color_stop = percentage #rrggbb opacity

   Gradient examples
	      #	Gradient 1: thin film effect
	      gradient = horizontal
	      start_color = #111122 30
	      end_color	= #112211 30
	      color_stop = 60 #221111 30

	      #	Gradient 2: radial glow
	      gradient = radial
	      start_color = #ffffff 20
	      end_color	= #ffffff 0

	      #	Gradient 3: elegant black
	      gradient = vertical
	      start_color = #444444 100
	      end_color	= #222222 100

	      #	Gradient 4: elegant black
	      gradient = horizontal
	      start_color = #111111 100
	      end_color	= #222222 100

	      #	Background 1: Active desktop name
	      rounded =	2
	      border_width = 1
	      border_sides = TBLR
	      background_color = #555555 10
	      border_color = #ffffff 60
	      background_color_hover = #555555 10
	      border_color_hover = #ffffff 60
	      background_color_pressed = #555555 10
	      border_color_pressed = #ffffff 60
	      gradient_id = 3
	      gradient_id_hover	= 4
	      gradient_id_pressed = 2

	      [...]

   Panel
	      	panel_items = LTSBC defines the	items tint2 will show and  the
		order  of  those items.	Each letter refers to an item, defined
		as:

		 L shows the Launcher

		 T shows the Taskbar

		 S shows the Systray (also called notification	area)

		 B shows the Battery status

		 C shows the Clock

		 F adds an extensible spacer  (freespace).  You  can  specify
		  more	than  one.  Has	no effect if T is also present.	(since
		  0.12)

		 E adds an executor plugin. You can specify  more  than  one.
		  (since 0.12.4)

		 P  adds a push button. You can specify more than one.	(since
		  0.14)

		 : adds a separator. You can specify more  than  one.	(since
		  0.13.0)

	      For  example,  panel_items  =  STC  will	show  the systray, the
	      taskbar and the clock (from left to right).

	      	panel_monitor =	monitor	(all or	primary	or 1 or	2  or  ...)  :
		Which monitor tint2 draws the panel on

		 The first monitor is 1

		 Use panel_monitor = all to get a separate panel per monitor

	      	primary_monitor_first  =  boolean (0 or	1) : Place the primary
		monitor	before all the other  monitors	in  the	 list.	(since
		0.12.4;	removed	in 1.0,	use primary instead)

       [](images/panel_padding.jpg)

	      	panel_position	= vertical_position horizontal_position	orien-
		tation

		 vertical_position is one of: bottom, top, center

		 horizontal_position is one of: left, right, center

		 orientation is one of: horizontal, vertical

	      	panel_size = width height

		 width	and height can be specified without units  (e.g.  123)
		  as  pixels,  or  followed by % as percentages	of the monitor
		  size (e.g. 50%). Use 100%  for  full	monitor	 width/height.
		  Example:

	      	scale_relative_to_dpi  = integer : If set to a non-zero	value,
		HiDPI scaling is enabled. Each panel is	visible	on a different
		monitor. Thus each panel has a specific	 scaling  factor.  The
		scaling	 factor	 is  computed as the ratio between the monitor
		DPI (obtained from the dimensions in  pixels  and  millimeters
		from  RandR)  and a configured reference DPI - this is the DPI
		for which exising user configs	looked	normal,	 for  backward
		compatibility.

	      	scale_relative_to_screen_height	  =   integer	:  Similar  to
		scale_relative_to_dpi, except the scaling factor  is  computed
		as  the	 ratio	between	 the  monitor  height  and scale_rela-
		tive_to_screen_height.	 The   effect	is   cumulative	  with
		scale_relative_to_dpi,	i.e.  if both options are present, the
		factors	are multiplied.

	      #	The panel's width is 94% the size of the monitor, the height is	30 pixels:
	      panel_size = 94% 30

	      	panel_shrink = boolean (0 or 1)	: If set to 1, the panel  will
		shrink to a compact size dynamically. (since 0.13)

	      	panel_margin = horizontal_margin vertical_margin : The margins
		define	the distance between the panel and the horizontal/ver-
		tical monitor edge. Use	0 to obtain a panel with the same size
		as the edge of the monitor (no margin).

       [](images/panelsizemargin.jpg)

	      	panel_padding =	horizontal_padding vertical_padding spacing  :
		Please refer to	the image below.

       [](images/panel_padding.jpg)

	      	font_shadow = boolean (0 or 1)

	      	panel_background_id  =	integer	 : Which background to use for
		the panel.

	      	wm_menu	= boolean (0 or	1) : Defines if	tint2 forwards	unhan-
		dled  mouse  events  to	your window manager. Useful for	window
		managers such as openbox, which	display	the start menu if  you
		right click on the desktop.

	      	panel_dock  =  boolean	(0  or 1) : Defines if tint2 is	placed
		into the window	manager's dock.	For the	openbox	window manager
		it is advised to also use a modifier for  the  moveButton  op-
		tion,  otherwise the mouse click is not	forwarded to tint2 (in
		~/.config/openbox/rc.xml).

	      	panel_pivot_struts = boolean (0	or 1) :	Defines	if tint2  lies
		to  the	 window	 manager  about	its orientation	(horizontal vs
		vertical) when requesting  reserved  space  with  STRUTs  (see
		strut_policy  below).  On  some	 window	 managers, this	allows
		placing	a panel	in the middle of the virtual screen,  e.g.  on
		the  bottom edge of the	top monitor in a vertical dual-monitor
		setup.

	      	panel_layer = bottom/normal/top	: Places tint2 into  the  bot-
		tom/normal/top	layer.	This  is helpful for specifying	if the
		panel can be covered by	other windows or not. The  default  is
		the  bottom  layer,  but  with real transparency normal	or top
		layer may be a nice alternative.

	      	strut_policy = follow_size/minimum/none	: STRUTs are  used  by
		the  window  manager  to decide	the size of maximized windows.
		Note: on multi-monitor (Xinerama) setups, the panel  generally
		must  be placed	at the edge (not in the	middle)	of the virtual
		screen for this	to work	correctly (though on some window  man-
		agers, setting panel_pivot_struts may work around this limita-
		tion).

		 follow_size  means  that the maximized windows always	resize
		  to have a common edge	with tint2.

		 minimum means	that the maximized windows  always  expand  to
		  have	a common edge with the hidden panel. This is useful if
		  the autohide option is enabled.

		 none means that the maximized	windows	use  the  full	screen
		  size.

	      	panel_window_name  =  string : Defines the name	of the panel's
		window.	Default: 'tint2'. (since 0.12)

	      	disable_transparency = boolean (0 or 1)	: Whether  to  disable
		transparency  instead  of detecting if it is supported.	Useful
		on broken graphics stacks. (since 0.12)

	      	mouse_effects =	boolean	(0 or 1) :  Whether  to	 enable	 mouse
		hover effects for clickable items. (since 0.12.3)

	      	mouse_hover_icon_asb  =	 alpha	(0 to 100) saturation (-100 to
		100) brightness	(-100 to 100) :	Adjusts	 the  icon  color  and
		transparency  on  mouse	hover (works only when mouse_effects =
		1).` (since 0.12.3)

	      	mouse_pressed_icon_asb = alpha (0 to 100) saturation (-100  to
		100)  brightness  (-100	 to  100) : Adjusts the	icon color and
		transparency on	mouse press (works only	when  mouse_effects  =
		1).` (since 0.12.3)

	      	autohide  =  boolean (0	or 1) :	Whether	to enable panel	hiding
		when the mouse cursor exists the panel.

	      	autohide_show_timeout =	float :	Show timeout in	seconds	 after
		the  mouse cursor enters the panel. Use	'.' as decimal separa-
		tor.

	      	autohide_hide_timeout =	float :	Hide timeout in	seconds	 after
		the  mouse  cursor exits the panel. Use	'.' as decimal separa-
		tor.

	      	autohide_height	= integer : panel height (width	 for  vertical
		panels)	in hidden mode.

   Launcher
	      	launcher_item_app     =	    path_to_application	    :	  Each
		launcher_item_app must be a file path to a .desktop file  fol-
		lowing	 the   freedesktop.org	 specification	 <http://stan-
		dards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-
		latest.html>. The paths	may begin with ~, which	is expanded to
		the path of the	user's home directory. If only a file name  is
		specified,  the	file is	search in the standard application di-
		rectories ($XDG_DATA_HOME/applications,	 ~/.local/share/appli-
		cations,  $XDG_DATA_DIRS/applications, /usr/local/share/appli-
		cations, /usr/share/applications, /opt/share/applications).

	      	launcher_apps_dir = path_to_directory :	Specifies a path to  a
		directory  from	 which	the  launcher  is loading all .desktop
		files (all subdirectories are explored	recursively).  Can  be
		used  multiple	times. The path	may begin with ~, which	is ex-
		panded to the path of the user's home directory. (since	0.12)

	      	launcher_background_id = integer : Defines which background to
		use.

	      	launcher_icon_background_id = integer :	 Defines  which	 back-
		ground to use for icons.

	      	launcher_padding = horizontal_padding vertical_padding spacing

	      	launcher_icon_size = integer : The launcher icon size, in pix-
		els.

	      	launcher_icon_theme  =	name_of_theme  :  (Optional)  Uses the
		specified icon theme to	 display  shortcut  icons.  Note  that
		tint2  will  detect  and use the icon theme of your desktop if
		you have an XSETTINGS manager running (which you probably do),
		unless launcher_icon_theme_override = 1.

	      	launcher_icon_theme_override = boolean	(0  or	1)  :  Whether
		launcher_icon_theme  overrides	the  value  obtained  from the
		XSETTINGS manager. (since 0.12)

	      	launcher_icon_asb = alpha (0 to	100) saturation	(-100 to  100)
		brightness  (-100  to 100) : Adjusts the icon color and	trans-
		parency.

	      	launcher_tooltip = boolean (0 or 1) : Whether to show tooltips
		for the	launcher icons.

	      	startup_notifications =	boolean	(0 or 1)  :  Whether  to  show
		startup	 notifications	when  starting	applications  from the
		launcher. (since 0.12)

   Taskbar / Pager
	      	taskbar_mode = single_desktop/multi_desktop

		 single_desktop : Shows a normal taskbar  listing  the	 tasks
		  running on the current virtual desktop (also known as	'work-
		  space');

		 multi_desktop	  :  Pager  like  capability.  Shows  multiple
		  taskbars, one	per virtual desktop, with which:

		   You	can drag-and-drop tasks	between	virtual	desktops;

		   You	can switch between virtual desktops.

	      	taskbar_hide_if_empty =	boolean	(0 or  1)  :  If  enabled,  in
		multi-desktop  mode  the taskbars corresponding	to empty desk-
		tops different from the	current	 desktop  are  hidden.	(since
		0.13)

	      	taskbar_distribute_size	 =  boolean  (0	or 1) :	If enabled, in
		multi-desktop mode distributes between taskbars	the  available
		size proportionally to the number of tasks. Default: disabled.
		(since 0.12)

	      	taskbar_padding	= horizontal_padding vertical_padding spacing

       [](images/taskbar_padding.jpg)

	      	taskbar_background_id =	integer	: Which	background to use

	      	taskbar_active_background_id  =	 integer : Which background to
		use for	the taskbar of the current virtual desktop.

	      	taskbar_hide_inactive_tasks = boolean (0 or 1) :  If  enabled,
		the taskbar shows only the active task.	(since 0.12)

	      	taskbar_hide_different_monitor	=  boolean  (0 or 1) :	If en-
		abled, the taskbar shows only the tasks	from the current moni-
		tor. Useful when running different tint2 instances on  differ-
		ent monitors, each one having its own config. (since 0.12)

	      	taskbar_hide_different_desktop	=  boolean  (0 or 1) :	If en-
		abled, the taskbar shows only the tasks	from the current desk-
		top. Useful to make multi-desktop taskbars more	 compact,  but
		still allow desktop switching with mouse click.	(since 1.0)

	      	taskbar_always_show_all_desktop_tasks  =  boolean  (0  or 1) :
		Has effect only	if taskbar_mode	= multi_desktop.  If  enabled,
		tasks  that  appear on all desktops are	shown on all taskbars.
		Otherwise, they	are shown only on the taskbar of  the  current
		desktop. (since	0.12.4)

	      	taskbar_sort_order  =  none/title/center  : Specifies the sort
		order of the tasks on the taskbar.  (since 0.12)

		 none : No sorting. New tasks are simply appended at the  end
		  of the taskbar when they appear.

		 title	: Sorts	the tasks by title.

		 application  :  Sorts	 the tasks by application name.	(since
		  16.3)

		 center : Sorts the tasks by their window centers.

		 mru :	Shows the  most	 recently  used	 tasks	first.	(since
		  0.12.4)

		 lru  :  Shows	 the  most  recently  used  tasks last.	(since
		  0.12.4)

	      	task_align = left/center/right : Specifies  the	 alignment  of
		the tasks on the taskbar. Default: left.

	      	taskbar_name = boolean (0 or 1)	:  Whether to show the virtual
		desktop	name in	the taskbar.

	      	taskbar_name_padding  =	 padding  :   Padding  for the virtual
		desktop	name.

	      	taskbar_name_background_id = integer :	 Which	background  to
		use for	the desktop name.

	      	taskbar_name_font  =  [FAMILY-LIST]  [STYLE-OPTIONS]  [SIZE] :
		Font configuration for the desktop name.

	      	taskbar_name_font_color	= color	opacity	(0  to	100)  :	  Font
		color for the desktop name.

	      	taskbar_name_active_background_id  =  integer  :   Which back-
		ground to use for the name of the current desktop.

	      	taskbar_name_active_font_color = color opacity (0  to  100)  :
		Font color for the name	of the current desktop.

Taskbar	buttons
       The following options configure the task	buttons	in the taskbar:

	      	task_icon  =  boolean  (0  or 1) : Whether to display the task
		icon. There is no explicit option to  control  the  task  icon
		size;	it   depends   on   the	  vertical  padding  set  with
		task_padding.

	      	task_text = boolean (0 or 1) : Whether	to  display  the  task
		text.

	      	task_centered  =  boolean  (0 or 1) : Whether the task text is
		centered.

	      	task_tooltip = boolean (0 or 1)	: Whether to show tooltips for
		tasks.

	      	task_thumbnail = boolean (0 or 1) : Whether to show  thumbnail
		tooltips for tasks. (since 16.0)

	      	task_thumbnail_size = width : Thumbnail	size. (since 16.0)

	      	task_maximum_size = width height

		 width	 is  used  with	horizontal panels to limit the size of
		  the tasks. Use width = 0 to get full taskbar width.

		 height is used with vertical panels.

	      	task_padding = horizontal_padding vertical_padding spacing

	      	urgent_nb_of_blink = integer : Number of blinks	on 'get	atten-
		tion' events.

       [](images/task_padding.jpg)

	      	task_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

	      	task_font_color	= color	opacity	(0 to 100)

	      	task_icon_asb =	alpha (0 to  100)  saturation  (-100  to  100)
		brightness  (-100  to  100) : Adjust the task icon's color and
		transparency.

	      	task_background_id = integer : Which background	to use for non
		selected tasks

       For the next 3 options STATUS can be active / iconified	/ urgent:
	      *	task_STATUS_font_color = color opacity (0 to 100)

	      	task_STATUS_icon_asb = alpha (0	to 100)	 saturation  (-100  to
		100)  brightness (-100 to 100) : Adjusts the task icon's color
		and transparency.

	      	task_STATUS_background_id = integer : Which background to  use
		for the	task.

   Mouse actions for taskbar buttons
       The   possible  mouse  events  are:  left,  middle,  right,  scroll_up,
       scroll_down.

       The possible mouse actions are: none, close,  toggle,  iconify,	shade,
       toggle_iconify,	  maximize_restore,    desktop_left,	desktop_right,
       next_task, prev_task.

       Use mouse_event = action	to customize mouse actions. Example:
	 mouse_middle =	none
	 mouse_right = close
	 mouse_scroll_up = toggle
	 mouse_scroll_down = iconify

       The action semantics:
	      *	none : If wm_menu = 1 is set, the mouse	event is forwarded  to
	      the  window  manager.  Otherwise it is ignored.  * close : close
	      the task * toggle	: toggle the task * iconify :  iconify	(mini-
	      mize)  the  task * toggle_iconify	: toggle or iconify the	task *
	      maximize_restore : maximized or minimized	the  task  *  shade  :
	      shades  (collapses)  the	task * desktop_left : send the task to
	      the desktop on the left *	desktop_right :	send the task  to  the
	      desktop on the right * next_task : send the focus	to next	task *
	      prev_task	: send the focus to previous task

   System Tray
	      	systray_padding	= horizontal_padding vertical_padding spacing

	      	systray_background_id =	integer	: Which	background to use.

	      	systray_sort  =	 ascending/descending/left2right/right2left  :
		Specifies the sorting order for	the icons in the  systray:  in
		ascending/descending  alphabetical order of the	icon title, or
		always add icons to the	right/left (note that with  left2right
		or right2left the order	can be different on panel restart).

	      	systray_icon_size  =  max_icon_size  :	Set the	maximum	system
		tray icon size to number. Set to 0 for automatic icon sizing.

	      	systray_icon_asb = alpha (0 to 100) saturation (-100  to  100)
		brightness  (-100 to 100) : Adjust the systray icons color and
		transparency.

	      	systray_monitor	= integer (1, 2, ...) or primary :   On	 which
		monitor	 to  draw  the systray.	The first monitor is 1.	(since
		0.12)

	      	systray_name_filter = string :	Regular	expression to identify
		icon names to be hidden. For example,  ^audacious$  will  hide
		icons  with  the exact name audacious, while aud will hide any
		icons having aud in the	name. (since 0.13.1)

   Clock
	      	time1_format = %H:%M : The format used by the  first  line  of
		the clock.

		 time1_format,	 time2_format and clock_tooltip	use the	'strf-
		  time'	syntax.	More info can be found here:  <http://www.man-
		  pagez.com/man/3/strftime/>

		 To hide the clock, comment time1_format and time2_format.

	      	time1_timezone = :US/Hawaii

		 time1_timezone,  time2_timezone  and	clock_tooltip_timezone
		  can be used to specify a timezone. If	you do not  specify  a
		  value	 the  system-wide  timezone is used. The timezones can
		  usually be found in /usr/share/zoneinfo. If  your  timezones
		  are  in  a  different	directory, you need to specify the ab-
		  solute  path,	 e.g.	time1_timezone	 =   :/different/zone-
		  info/dir/US/Hawaii Always prepend the	timezone with a	':'

	      	time1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

	      	time2_format = %A %d %B

	      	time2_timezone = :Europe/Berlin

	      	time2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

	      	clock_font_color = color opacity (0 to 100)

	      	clock_padding =	horizontal_padding vertical_padding

	      	clock_background_id = integer :	Which background to use

	      	clock_tooltip  =  %a,  %d.  %b	%Y  :  Format  for the clock's
		tooltip.

	      	clock_tooltip_timezone = :UTC

	      	clock_lclick_command = text  :	Command	 to  execute  on  left
		click.

	      	clock_rclick_command  =	 text  :  Command  to execute on right
		click.

	      	clock_mclick_command = text : Command  to  execute  on	middle
		click. (since 0.12.1)

	      	clock_uwheel_command  =	 text  :  Command  to execute on wheel
		scroll up. (since 0.12.1)

	      	clock_dwheel_command = text :  Command	to  execute  on	 wheel
		scroll down. (since 0.12.1)

   Tooltip
	      	tooltip_padding	= horizontal_padding vertical_padding

	      	tooltip_show_timeout  =	 float	: Delay	to show	the tooltip in
		seconds. Use . as decimal separator.

	      	tooltip_hide_timeout = float : Delay to	hide  the  tooltip  in
		seconds. Use . as decimal separator.

	      	tooltip_background_id  = integer : Which background to use for
		tooltips. Note that with fake transparency the	alpha  channel
		and corner radius options are not respected.

	      	tooltip_font_color = color opacity  (0 to 100)

	      	tooltip_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

   Battery
	      	battery_hide = never/integer (0	to 100)	: At what battery per-
		centage	the battery item is hidden.

	      	battery_low_status  =  integer:	At what	battery	percentage the
		low command is executed.

	      	battery_low_cmd	= xmessage 'tint2: Battery low!' : Command  to
		execute	when the battery is low.

	      	battery_full_cmd = notify-send "battery	full" :	Command	to ex-
		ecute when the battery is full.

	      	bat1_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

	      	bat2_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE]

	      	battery_font_color = color opacity (0 to 100)

	      	bat1_format  =	FORMAT_STRING :	Format for battery line	1. De-
		fault: %p. (since 1.0) Format specification:

		 %s: State (charging, discharging, full, unknown).

		 %m: Minutes left until completely charged/discharged	(esti-
		  mated).

		 %h:  Hours  left  until completely charged/discharged	(esti-
		  mated).

		 %t: Time left. Shows "hrs:mins"  when	 charging/discharging,
		  or "Ful\" when full.

		 %p: Percentage. Includes the % sign.

		 %P: Percentage. Without the %	sign.

	      	bat2_format  =	FORMAT_STRING :	Format for battery line	2. De-
		fault: %t. (since 1.0)

	      	battery_padding	= horizontal_padding vertical_padding

	      	battery_background_id =	integer	: Which	background to use  for
		the battery.

	      	battery_tooltip_enabled	 =  boolean  (0	or 1) :	Enable/disable
		battery	tooltips. (since 0.12.3)

	      	battery_lclick_command = text :	Command	 to  execute  on  left
		click. (since 0.12.1)

	      	battery_rclick_command	=  text	 : Command to execute on right
		click. (since 0.12.1)

	      	battery_mclick_command = text :	Command	to execute  on	middle
		click. (since 0.12.1)

	      	battery_uwheel_command	=  text	 : Command to execute on wheel
		scroll up. (since 0.12.1)

	      	battery_dwheel_command = text :	Command	to  execute  on	 wheel
		scroll down. (since 0.12.1)

	      	ac_connected_cmd  =  text  : Command to	execute	when the power
		adapter	is plugged in. (since 0.12.3)

	      	ac_disconnected_cmd = text : Command to	execute	when the power
		adapter	is unplugged. (since 0.12.3)

   Executor
	      	execp =	new : Begins the configuration of a new	executor  plu-
		gin. Multiple such plugins are supported; just use multiple Es
		in panel_items.	(since 0.12.4)

	      	execp_command =	text : Command to execute. (since 0.12.4)

	      	execp_interval = integer : The command is executed again after
		execp_interval	seconds	from the moment	it exits. If zero, the
		command	is executed only once. (since 0.12.4)

	      	execp_continuous = integer : If	non-zero, the last  execp_con-
		tinuous	 lines	from  the output of the	command	are displayed,
		every execp_continuous lines; this is useful for  showing  the
		output	of  commands  that  run	 indefinitely,	such  as  ping
		127.0.0.1. If zero, the	output of the command is displayed af-
		ter it finishes	executing. (since 0.12.4)

	      	execp_has_icon = boolean (0 or 1) : If execp_has_icon =	1, the
		first line printed by the command is interpreted as a path  to
		an image file. (since 0.12.4)

	      	execp_cache_icon = boolean (0 or 1) : If execp_cache_icon = 0,
		the  image is reloaded each time the command is	executed (use-
		ful if the image file is changed on disk by the	 program  exe-
		cuted by execp_command). (since	0.12.4)

	      	execp_icon_w  =	 integer  :  You  can use execp_icon_w and ex-
		ecp_icon_h to resize the image.	If one of them	is  zero/miss-
		ing, the image is rescaled proportionally. If both of them are
		zero/missing, the image	is not rescaled. (since	0.12.4)

	      	execp_icon_h = integer : See execp_icon_w. (since 0.12.4)

	      	execp_tooltip  = text :	The tooltip. If	left empty, no tooltip
		is displayed. If missing, the standard error of	the command is
		shown as a tooltip (an ANSI clear screen  sequence  can	 reset
		the contents, bash: printf '\e[2J', C: printf("\x1b[2J");). If
		the standard error is empty, the tooltip will show information
		about  the  time  when	the  command was last executed.	(since
		0.12.4)

	      	execp_font = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] :  The  font
		used to	draw the text.	(since 0.12.4)

	      	execp_font_color  =  color  opacity  :	The font color.	(since
		0.12.4)

	      	execp_markup = boolean (0 or 1)	: If non-zero, the  output  of
		the command is treated as Pango	markup,	which allows rich text
		formatting.  The  format  is  documented  here <https://devel-
		oper.gnome.org/pygtk/stable/pango-markup-language.html>.  Note
		that  using this with commands that print data downloaded from
		the Internet is	a possible security risk. (since 0.12.4)

	      	execp_background_id =  integer	:  Which  background  to  use.
		(since 0.12.4)

	      	execp_centered	=  boolean  (0	or  1) : Whether to center the
		text. (since 0.12.4)

	      	execp_padding  =  horizontal_padding  vertical_padding	 spac-
		ing_between_icon_and_text (since 0.12.4)

	      	execp_lclick_command  =	 text  :  Command  to  execute on left
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.12.4)

	      	execp_mclick_command = text :  Command	to  execute  on	 right
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.12.4)

	      	execp_rclick_command  =	 text  :  Command to execute on	middle
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.12.4)

	      	execp_uwheel_command = text :  Command	to  execute  on	 wheel
		scroll	up. If not defined, execp_command is  executed immedi-
		ately, unless it is currently running. (since 0.12.4)

	      	execp_dwheel_command = text :  Command	to  execute  on	 wheel
		scroll	down. If not defined, execp_command is	executed imme-
		diately, unless	it is currently	running. (since	0.12.4)

   Executor samples
   Print the hostname
	      execp = new
	      execp_command = hostname
	      execp_interval = 0

   Print disk usage for	the root partition every 10 seconds
	      execp = new
	      execp_command = df -h | awk '/\/$/ { print $6 ": " $2 " "	$5}'
	      execp_interval = 10

   Button with icon and	rich text, executes command when clicked
	      execp = new
	      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>'
	      execp_has_icon = 1
	      execp_interval = 0
	      execp_centered = 1
	      execp_font = sans	9
	      execp_markup = 1
	      execp_font_color = #aaffaa 100
	      execp_padding = 2	0
	      execp_tooltip = I	will tell you a	secret...
	      execp_lclick_command = zenity --info "--text=$(uname -sr)"
	      execp_background_id = 2

   Desktop pager with text
	      execp = new
	      execp_command = xprop -root -spy | awk '/^_NET_CURRENT_DESKTOP/ {	print "Workspace " ($3 + 1) ; fflush();	}'
	      execp_interval = 1
	      execp_continuous = 1

   Desktop pager with icon
	      execp_command = xprop -root -spy | awk -v	home="$HOME" '/^_NET_CURRENT_DESKTOP/ {	print home "/.config/myPager/" ($3 + 1)	".png\n" ; fflush(); }'
	      execp_interval = 1
	      execp_has_icon = 1
	      execp_cache_icon = 1
	      execp_continuous = 2

   Round-trip time to the gateway, refreshed every second
	      execp = new
	      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(); } '
	      execp_continuous = 0
	      execp_interval = 1
	      execp_markup = 1

   Memory usage
	      execp = new
	      execp_command = free | awk '/^-/ { printf	"Mem: '$(free -h | awk '/^Mem:/	{ print	$2 }')'	%.0f%%\n", 100*$3/($3+$4); fflush(stdout) }'
	      execp_interval = 5
	      execp_continuous = 0

   Network load
	      #	Note the use of	"stdbuf	-oL" to	force the program to flush the output line by line.
	      execp = new
	      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)'
	      execp_continuous = 1
	      execp_interval = 1

   Button
	      	button = new : Begins the configuration	of a new button.  Mul-
		tiple  such  plugins  are  supported;  just use	multiple Ps in
		panel_items. (since 0.14)

	      	button_icon = text : Name or path of icon (or  empty).	(since
		0.14)

	      	button_text = text : Text to display (or empty). (since	0.14)

	      	button_tooltip = text :	The tooltip (or	empty).	(since 0.14)

	      	button_font  = [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] : The font
		used to	draw the text.	(since 0.14)

	      	button_font_color = color opacity :  The  font	color.	(since
		0.14)

	      	button_background_id  =	 integer  :  Which  background to use.
		(since 0.14)

	      	button_centered	= boolean (0 or	1) :  Whether  to  center  the
		text. (since 0.14)

	      	button_padding	=  horizontal_padding  vertical_padding	 spac-
		ing_between_icon_and_text (since 0.14)

	      	button_max_icon_size = integer : Sets  a  limit	 to  the  icon
		size.  Otherwise,  the	icon  will expand to the edges.	(since
		0.14)

	      	button_lclick_command =	text :	Command	 to  execute  on  left
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.14)

	      	button_mclick_command  =  text	:  Command to execute on right
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.14)

	      	button_rclick_command =	text : Command to  execute  on	middle
		click. If not defined, execp_command is	 executed immediately,
		unless it is currently running.	(since 0.14)

	      	button_uwheel_command  =  text	:  Command to execute on wheel
		scroll up. If not defined, execp_command is  executed  immedi-
		ately, unless it is currently running. (since 0.14)

	      	button_dwheel_command  =  text	:  Command to execute on wheel
		scroll down. If	not defined, execp_command is  executed	 imme-
		diately, unless	it is currently	running. (since	0.14)

   Separator
	      	separator = new	: Begins the configuration of a	new separator.
		Multiple  such	plugins	are supported; just use	multiple :s in
		panel_items. (since 0.13.0)

	      	separator_background_id	= integer : Which background  to  use.
		(since 0.13.0)

	      	separator_color	= color	opacity	: The foreground color.	(since
		0.13.0)

	      	separator_style	= [empty | line	| dots]	: The separator	style.
		(since 0.13.0)

	      	separator_size	=  integer  :  The thickness of	the separator.
		Does not include the border and	padding. For example,  if  the
		style  is  line,  this	is the line thickness; if the style is
		dots, this is the dot's	diameter. (since 0.13.0)

	      	separator_padding = side_padding cap_padding : The padding  to
		add to the sides of the	separator, in pixels. (since 0.13.0)

   Example configuration
       See /etc/xdg/tint2/tint2rc.

AUTHOR
       tint2  was  written  by Thierry Lorthiois <lorthiois@bbsoft.fr>.	 It is
       based on	ttm, originally	written	by Pl Staurland	<staura@gmail.com>.

       This manual  page  was  originally  written  by	Daniel	Moerner	 <dmo-
       erner@gmail.com>,  for  the Debian project (but may be used by others).
       It was adopted from the tint2 docs.

SEE ALSO
       The main	website	<https://gitlab.com/o9000/tint2> and the wiki page  at
       <https://gitlab.com/o9000/tint2/wikis/home>.

       This  documentation is also provided in HTML and	Markdown format	in the
       system's	  default   location   for   documentation   files,    usually
       /usr/share/doc/tint2 or /usr/local/share/doc/tint2.  .  .

16.7				  2019-07-14			      TINT2(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tint2&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help