Difference between revisions of "Tint2"

From ArchWiki
Jump to navigation Jump to search
(See Also)
(Renovating the "transparency" section and removing the "outdated" tag)
 
(38 intermediate revisions by 17 users not shown)
Line 1: Line 1:
 +
{{Lowercase title}}
 
[[Category:Eye candy]]
 
[[Category:Eye candy]]
 
[[es:Tint]]
 
[[es:Tint]]
 +
[[ja:Tint2]]
 
[[ru:Tint2]]
 
[[ru:Tint2]]
[[zh-CN:Tint2]]
+
[[zh-hans:Tint2]]
[https://gitlab.com/o9000/tint2 tint2] is a system panel/taskbar for Linux. It is described by its developers as "simple, unobtrusive and light". It can be configured to include (or not include), among other things, a system tray, a task list, a battery monitor and a clock. Its look can also be configured a great deal, and it does not have many dependencies. This makes it ideal for window manager users who want a panel but do not have one by default, like [[Openbox]] users.
+
[https://gitlab.com/o9000/tint2 tint2] is a simple, unobtrusive and light [[panel]] for [[Xorg]]. It can be configured to include a system tray, a task list, a battery monitor and more. Its look is configurable and it only has few dependencies, making it ideal for window managers like [[Openbox]], that do not come with a panel.
  
==Installation==
+
== Installation ==
Install the {{Pkg|tint2}} package.
 
  
==Configuration==
+
[[Install]] the {{Pkg|tint2}} package.
tint2 has a configuration file in {{ic|~/.config/tint2/tint2rc}}. A skeleton configuration file with the default settings is created the first time you run tint2. You can then change this file to your liking. Full documentation on how to configure tint2 is found [https://gitlab.com/o9000/tint2/wikis/Configure here]. You can configure the fonts, colors, looks, location and more in this file. The tint2 package also contains a GUI configuration tool that can be launched by running ''tint2conf''.
 
  
===Application launchers===
+
== Configuration ==
With version 0.12, it has become possible to add application launchers to tint2. It is necessary to add the following configuration options to your tint2 config file:
+
 
 +
''tint2'' has a configuration file in {{ic|~/.config/tint2/tint2rc}}. A skeleton configuration file with the default settings is created the first time you run ''tint2''. You can then change this file to your liking. Full documentation on how to configure ''tint2'' is found [https://gitlab.com/o9000/tint2/blob/master/doc/tint2.md#configuration here]. You can configure the fonts, colors, looks, location and more in this file. The ''tint2'' package also contains a GUI configuration tool which can be launched with ''tint2conf''.
 +
 
 +
=== Application launchers ===
 +
 
 +
With version 0.12, it has become possible to add application launchers to ''tint2''. It is necessary to add the following configuration options to your ''tint2'' config file:
 +
 
 +
Under {{ic|#Panel}}:
  
Under {{Ic|#Panel}}:
 
 
  # Panel
 
  # Panel
 
  panel_items = LTSBC
 
  panel_items = LTSBC
Line 28: Line 34:
 
  launcher_item_app = /some/where/anotherapplication.desktop
 
  launcher_item_app = /some/where/anotherapplication.desktop
  
The option {{Ic|launcher_icon_theme}} seems not to be documented yet.
+
{{Ic|panel_items}} is a new configuration option which defines which items ''tint2'' shows and in what order:
  
{{Ic|panel_items}} is a new configuration option which defines which items tint2 shows and in what order:
+
; L: shows the Launcher
; L: Show Launcher
+
; T: shows the Taskbar
; T: Show Taskbar
+
; S: shows the Systray (also called notification area)
; S: Show Systray
+
; B: shows the Battery status
; B: Show Battery status
+
; C: shows the Clock
; C: Show 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)''
 +
; <nowiki>:</nowiki>: adds a separator. You can specify more than one. ''(since 0.13.0)''
  
===Applications menu in Openbox===
+
=== Applications menu in Openbox ===
Since version 0.12, you have the ability to create launchers. Unfortunately, tint2 does not support nested menus yet, so there is no native function to enable an applications menu. With a little ingenuity, one can trick tint2 and get an applications menu anyway! This example will create such a launcher for Openbox.
+
 
 +
Since version 0.12, you have the ability to create launchers. Unfortunately, ''tint2'' does not support nested menus yet, so there is no native function to enable an applications menu. This section describes a way to create a launcher for Openbox.
 +
 
 +
Besides ''tint2'' and Openbox, [[install]] the {{Pkg|xdotool}} package. Next, create a keybinding for opening the Openbox menu. For Openbox, this would require the following entry between the <keyboard> and </keyboard> tags in {{ic|~/.config/openbox/rc.xml}}:
  
Besides tint2 and Openbox, you have to [[install]] the {{Pkg|xdotool}} package. Next you want to create a keybinding for opening the Openbox menu. For Openbox, this would require the following entry between the <keyboard> and </keyboard> tags in {{ic|~/.config/openbox/rc.xml}}:
 
 
   <!-- Keybinding for opening OpenBox menu -->
 
   <!-- Keybinding for opening OpenBox menu -->
 
   <keybind key="C-A-space">
 
   <keybind key="C-A-space">
Line 50: Line 61:
 
  $ xdotool key ctrl+alt+space
 
  $ xdotool key ctrl+alt+space
  
If the menu you chose pops up under your mouse cursor, you have done it right! Now create a {{ic|open-openbox-menu.desktop}} file inside {{ic|~/.local/share/applications}} directory. Be sure to add the line {{Ic|Exec&#61;xdotool key ctrl+alt+space}} where {{ic|Ctrl+Alt+Space}} are your chosen key combinations. Open your new {{ic|open-openbox-menu.desktop}} file from your file manager and, once again, you should see the menu appear under your cursor. Now just add this to tint2 as a launcher, and you have your Openbox Applications Menu as a launcher for tint2!
+
If the menu you chose pops up under your mouse cursor, you have done it right! Now create a {{ic|open-openbox-menu.desktop}} file inside the {{ic|~/.local/share/applications}} directory. Add the line {{Ic|Exec&#61;xdotool key ctrl+alt+space}} where {{ic|Ctrl+Alt+Space}} are your chosen key combinations. Open your new {{ic|open-openbox-menu.desktop}} file from your file manager and, once again, you should see the menu appear under your cursor. Now just add this to ''tint2'' as a launcher, and you have your Openbox Applications Menu as a launcher for ''tint2''. If you need to place the menu at a fixed position, you can use {{ic|xdotool mousemove x y}}. You can create a script and reference it in {{ic|open-openbox-menu.desktop}} since it involves two commands.
  
 
See [http://openbox.org/wiki/Help:Menus Openbox Menus] for further help on creating your own menu to use here, and {{Pkg|menumaker}} to generate a nice full {{ic|menu.xml}} for most (possibly all) of your installed programs.
 
See [http://openbox.org/wiki/Help:Menus Openbox Menus] for further help on creating your own menu to use here, and {{Pkg|menumaker}} to generate a nice full {{ic|menu.xml}} for most (possibly all) of your installed programs.
  
===Volume control===
+
Since version 0.14, you have the ability to create buttons. Just add "xdotool key ctrl+alt+space" string from example above to button key action you want to be start menu action.
Tint2 does not come with a volume control applet. VolWheel is a simple one that sits in the tray. Install it with {{pkg|volwheel}} and show it by running {{ic|volwheel}}.
 
  
Another option is {{pkg|volumeicon}} or {{AUR|volumeicon-gtk2}}.
+
=== Volume control ===
 +
 
 +
''tint2'' does not come with a volume control applet. See [[List of applications/Multimedia#Volume control]].
 +
 
 +
== Running tint2 ==
 +
 
 +
=== Openbox ===
 +
 
 +
You can run ''tint2'' by simply typing the command:
  
==Running tint2==
 
===Openbox===
 
You can run tint2 by simply typing the command:
 
 
  $ tint2
 
  $ tint2
  
If you want to run tint2 when starting [[Openbox]], you will need to edit {{ic|~/.config/openbox/autostart}} and add the following line:
+
If you want to run ''tint2'' when starting [[Openbox]], you will need to edit {{ic|~/.config/openbox/autostart}} and add the following line:
 +
 
 
  tint2 &
 
  tint2 &
  
===GNOME 3===
+
=== GNOME 3 ===
In GNOME 3, the Activities view has replaced the bottom panel and taskbar. To use tint2 in its place, run
+
 
 +
In GNOME 3, the Activities view has replaced the bottom panel and taskbar. To use ''tint2'' in its place, run
  
 
  $ gnome-session-properties
 
  $ gnome-session-properties
  
and add {{ic|/usr/bin/tint2}} as an application to run on start-up. The next time GNOME starts, tint2 will run automatically.
+
and add {{ic|/usr/bin/tint2}} as an application to run on start-up. The next time GNOME starts, ''tint2'' will run automatically.
 +
 
 +
=== i3 ===
 +
 
 +
In [[i3]], to use ''tint2'' as a replacement for {{ic|i3status}}, append the following line to end of the i3 configuration file:
 +
 
 +
{{hc|~/.i3/config|2=
 +
exec --no-startup-id tint2
 +
}}
 +
 
 +
and comment out or remove any section like {{ic|bar{status_command i3status}}} from the same file.
 +
 
 +
=== Multiple panels ===
 +
 
 +
Multiple ''tint2'' panels can be simultaneously running by using executing ''tint2'' with different configuration files:
  
===Multiple panels===
 
Multiple tint2 panels can be simultaneously running by using executing tint2 with different configuration files:
 
 
  tint2 -c <path_to_first_config_file>
 
  tint2 -c <path_to_first_config_file>
 
  tint2 -c <path_to_second_config_file>
 
  tint2 -c <path_to_second_config_file>
  
==Enabling transparency==
+
== Enabling transparency ==
To make tint2 look its best, some form of compositing is required. If your tint2 has a large black rectangular box behind it you are either using a window manager without native compositing (like Openbox) or it is not enabled.
 
  
To enable compositing under Openbox you can install [[Xcompmgr]] or [[Cairo Compmgr]], the packages are {{Pkg|xcompmgr}}, respectively {{AUR|cairo-compmgr}}.
+
''tint2'' supports both fake and real transparency. Which one is used is regulated by the {{ic|disable_transparency}} option in the {{ic|tint2rc}} configuration file.
  
Xcompmgr can be started like this:
+
If you want to completely disable transparency you need to use {{ic|1=disable_transparency = 1}} and set the panel background opacity to 100. Eg:
  
$ xcompmgr
+
  background_color = #000000 100
  
You will have to kill and restart tint2 to enable transparency.
+
=== Fake transparency ===
 +
For fake transparency you need to set {{ic|1=disable_transparency = 1}}.
  
If Xcompmgr is used solely to provide tint2 with transparency effects it can be run at boot by changing the autostart section in {{ic|~/.config/openbox/autostart}} to this:
+
Fake transparency captures a portion of the desktop background and uses that as the panel background. Because of that it is important to set the background image before ''tint2'' is activated. A startup script example for [[Openbox]] could be (using [[Feh]] for the background):  
  
  # Launch Xcomppmgr and tint2 with openbox
+
  ...
  if which tint2 >/dev/null 2>&1; then
+
  feh --randomize --no-fehbg --bg-fill ~/Pictures/wallpapers/
  (sleep 2 && xcompmgr) &
+
(sleep 1 && tint2) &
  (sleep 2 && tint2) &
+
  ...
  fi
 
  
Various other (better) ways to make Xcompmgr run at startup are discussed in the [[Openbox]] article.
+
=== Real transparency ===
 +
For real transparency you need to activate a compositor like [[Compton]] first and set {{ic|1=disable_transparency = 0}}.
  
===Fullscreen/Overlay===
+
The opacity is regulated by the second parameter of the {{ic|background_color}} property in the ''tint2'' [https://gitlab.com/o9000/tint2/blob/master/doc/tint2.md#backgrounds-and-borders configuration file].
  
To force tint2 to stay on top of the application(overlay), you need to set the panel_layer option appropriately. This can be helpful when you switch from a fullscreen window to a normal application using Alt-Tab. There is a discussion on this at [http://crunchbang.org/forums/viewtopic.php?pid=70048 Crunchbang Forum]
+
If you are making changes on the fly, you may need to restart ''tint2'' for the transparency to take effect.
 +
 
 +
== Fullscreen/Overlay ==
 +
 
 +
To force ''tint2'' to stay on top of the application (overlay), you need to set the panel_layer option appropriately. This can be helpful when you switch from a fullscreen window to a normal application using Alt-Tab. There is a discussion on this at [http://crunchbang.org/forums/viewtopic.php?pid=70048 Crunchbang Forum]
  
 
   #Panel
 
   #Panel
Line 108: Line 141:
 
   strut_policy = follow_size
 
   strut_policy = follow_size
  
===See Also===
+
== Third party extensions ==
 +
 
 +
It is also possible to extend ''tint2'' with other applications. To add third party extensions, check the [https://gitlab.com/o9000/tint2/wikis/ThirdPartyApplets Applets] section of official Wiki.
 +
 
 +
== See also ==
  
 
* [https://gitlab.com/o9000/tint2/wikis/home Tint2 Official Wiki]
 
* [https://gitlab.com/o9000/tint2/wikis/home Tint2 Official Wiki]

Latest revision as of 08:19, 12 May 2019

tint2 is a simple, unobtrusive and light panel for Xorg. It can be configured to include a system tray, a task list, a battery monitor and more. Its look is configurable and it only has few dependencies, making it ideal for window managers like Openbox, that do not come with a panel.

Installation

Install the tint2 package.

Configuration

tint2 has a configuration file in ~/.config/tint2/tint2rc. A skeleton configuration file with the default settings is created the first time you run tint2. You can then change this file to your liking. Full documentation on how to configure tint2 is found here. You can configure the fonts, colors, looks, location and more in this file. The tint2 package also contains a GUI configuration tool which can be launched with tint2conf.

Application launchers

With version 0.12, it has become possible to add application launchers to tint2. It is necessary to add the following configuration options to your tint2 config file:

Under #Panel:

# Panel
panel_items = LTSBC

And under the new section #Launchers:

# Launchers
launcher_icon_theme = LinuxLex-8
launcher_padding = 5 0 10
launcher_background_id = 9
launcher_icon_size = 85
launcher_item_app = /some/where/application.desktop
launcher_item_app = /some/where/anotherapplication.desktop

panel_items is a new configuration option which defines which items tint2 shows and in what order:

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)

Applications menu in Openbox

Since version 0.12, you have the ability to create launchers. Unfortunately, tint2 does not support nested menus yet, so there is no native function to enable an applications menu. This section describes a way to create a launcher for Openbox.

Besides tint2 and Openbox, install the xdotool package. Next, create a keybinding for opening the Openbox menu. For Openbox, this would require the following entry between the <keyboard> and </keyboard> tags in ~/.config/openbox/rc.xml:

 <keybind key="C-A-space">
   <action name="ShowMenu"><menu>root-menu</menu></action>
 </keybind>

This will set Ctrl+Alt+Space to open the root-menu (this is the menu that opens when you right-click the desktop). You can change root-menu to any menu-id that you have defined in ~/.config/openbox/menu.xml. Next we need to make that keybinding into a .desktop file with xdotool. First test that your keybind works with:

$ xdotool key ctrl+alt+space

If the menu you chose pops up under your mouse cursor, you have done it right! Now create a open-openbox-menu.desktop file inside the ~/.local/share/applications directory. Add the line Exec=xdotool key ctrl+alt+space where Ctrl+Alt+Space are your chosen key combinations. Open your new open-openbox-menu.desktop file from your file manager and, once again, you should see the menu appear under your cursor. Now just add this to tint2 as a launcher, and you have your Openbox Applications Menu as a launcher for tint2. If you need to place the menu at a fixed position, you can use xdotool mousemove x y. You can create a script and reference it in open-openbox-menu.desktop since it involves two commands.

See Openbox Menus for further help on creating your own menu to use here, and menumaker to generate a nice full menu.xml for most (possibly all) of your installed programs.

Since version 0.14, you have the ability to create buttons. Just add "xdotool key ctrl+alt+space" string from example above to button key action you want to be start menu action.

Volume control

tint2 does not come with a volume control applet. See List of applications/Multimedia#Volume control.

Running tint2

Openbox

You can run tint2 by simply typing the command:

$ tint2

If you want to run tint2 when starting Openbox, you will need to edit ~/.config/openbox/autostart and add the following line:

tint2 &

GNOME 3

In GNOME 3, the Activities view has replaced the bottom panel and taskbar. To use tint2 in its place, run

$ gnome-session-properties

and add /usr/bin/tint2 as an application to run on start-up. The next time GNOME starts, tint2 will run automatically.

i3

In i3, to use tint2 as a replacement for i3status, append the following line to end of the i3 configuration file:

~/.i3/config
exec --no-startup-id tint2

and comment out or remove any section like bar{status_command i3status} from the same file.

Multiple panels

Multiple tint2 panels can be simultaneously running by using executing tint2 with different configuration files:

tint2 -c <path_to_first_config_file>
tint2 -c <path_to_second_config_file>

Enabling transparency

tint2 supports both fake and real transparency. Which one is used is regulated by the disable_transparency option in the tint2rc configuration file.

If you want to completely disable transparency you need to use disable_transparency = 1 and set the panel background opacity to 100. Eg:

 background_color = #000000 100

Fake transparency

For fake transparency you need to set disable_transparency = 1.

Fake transparency captures a portion of the desktop background and uses that as the panel background. Because of that it is important to set the background image before tint2 is activated. A startup script example for Openbox could be (using Feh for the background):

...
feh --randomize --no-fehbg --bg-fill ~/Pictures/wallpapers/
(sleep 1 && tint2) &
...

Real transparency

For real transparency you need to activate a compositor like Compton first and set disable_transparency = 0.

The opacity is regulated by the second parameter of the background_color property in the tint2 configuration file.

If you are making changes on the fly, you may need to restart tint2 for the transparency to take effect.

Fullscreen/Overlay

To force tint2 to stay on top of the application (overlay), you need to set the panel_layer option appropriately. This can be helpful when you switch from a fullscreen window to a normal application using Alt-Tab. There is a discussion on this at Crunchbang Forum

 #Panel
 panel_layer = top
 strut_policy = follow_size

Third party extensions

It is also possible to extend tint2 with other applications. To add third party extensions, check the Applets section of official Wiki.

See also