|
|
# Introduction
|
|
|
|
|
|
Tint2 is very easy to install. For several distributions, including Ubuntu and Debian, prebuilt packages are available.
|
|
|
|
|
|
|
|
|
# Installing from distribution packages
|
|
|
|
|
|
## Debian or Ubuntu
|
|
|
```
|
|
|
sudo apt-get install tint2
|
|
|
```
|
|
|
|
|
|
## Gentoo
|
|
|
```
|
|
|
su
|
|
|
emerge -av tint2
|
|
|
```
|
|
|
|
|
|
## Arch Linux
|
|
|
```
|
|
|
sudo pacman -S tint2
|
|
|
```
|
|
|
|
|
|
|
|
|
# Installing from source
|
|
|
## Requirements
|
|
|
Tint2 requires an [EWMH-compliant](http://freedesktop.org/wiki/Specifications/wm-spec/) Window manager and an UTF-8 system.
|
|
|
|
|
|
## Build system
|
|
|
|
|
|
You need to install git, cmake, make and gcc.
|
|
|
|
|
|
### Ubuntu, Debian
|
|
|
```
|
|
|
sudo apt-get install git cmake build-essential
|
|
|
```
|
|
|
|
|
|
## Dependencies
|
|
|
Tint2 depends on `cairo`, `pango`, `glib2`, `imlib2>=1.4.2`, `libgtk2.0-dev`, `xinerama`, `libXrender`, `libXcomposite`, `libXdamage`, `libx11`, `libXrandr>=1.3`, `librsvg2`, `libstartup-notification`.
|
|
|
|
|
|
### Ubuntu, Debian
|
|
|
```
|
|
|
sudo apt-get install libcairo2-dev libpango1.0-dev libglib2.0-dev libimlib2-dev libgtk2.0-dev libxinerama-dev libx11-dev libxdamage-dev libxcomposite-dev libxrender-dev libxrandr-dev librsvg2-dev libstartup-notification0-dev
|
|
|
```
|
|
|
|
|
|
### Gentoo
|
|
|
```
|
|
|
emerge -av cairo pango glib:2 imlib2 gtk+ libXinerama libX11 libXdamage libXcomposite libXrender libXrandr librsvg libstartup-notification
|
|
|
```
|
|
|
|
|
|
## Getting the sources
|
|
|
|
|
|
* To get the latest development version (master):
|
|
|
```
|
|
|
git clone https://gitlab.com/o9000/tint2.git
|
|
|
cd tint2
|
|
|
```
|
|
|
|
|
|
* To switch to one of the stable releases, for example 0.12.2:
|
|
|
```
|
|
|
git checkout 0.12.2
|
|
|
```
|
|
|
|
|
|
## Building
|
|
|
```
|
|
|
mkdir build
|
|
|
cd build
|
|
|
cmake ..
|
|
|
make
|
|
|
```
|
|
|
|
|
|
Notes:
|
|
|
* Run `cmake -L` for a list of possible variables which change building behaviour.
|
|
|
* If you have errors in the cmake step, it can be helpful to delete the file CMakeCache.txt in your build directory.
|
|
|
* For better integration with xcompmgr, see the [How to configure real transparency](FAQ) section of the FAQ.
|
|
|
|
|
|
# Installing after build
|
|
|
```
|
|
|
sudo make install
|
|
|
```
|
|
|
or
|
|
|
```
|
|
|
su
|
|
|
make install
|
|
|
```
|
|
|
|
|
|
Keep in mind that if you install from source, tint2 will install to `/usr/local/bin/tint2` and not `/usr/bin/tint2`.
|
|
|
|
|
|
# Starting tint2
|
|
|
|
|
|
Tint2 provides two executables: the panel (named tint2) and a configurator (named tint2conf).
|
|
|
|
|
|
* Execute `tint2` to start the panel and `tint2conf` to start the configurator.
|
|
|
* Execute `tint2 -c path_to_config_file`
|
|
|
|
|
|
If you have both the development version and the packaged version installed side-by-side, you might have to execute tint2 with a full path: `/usr/local/bin/tint2`
|
|
|
|
|
|
[Configuring your tint2 config file](Configure)
|
|
|
|
|
|
On startup, tint2 detects if you have a composite manager to decide whether to uses real transparency or fake transparency.
|
|
|
|
|
|
## Autostart tint2 in Openbox
|
|
|
Add the following command in the config file `$HOME/.config/openbox/autostart`
|
|
|
```
|
|
|
(sleep 2s && tint2) &
|
|
|
```
|
|
|
Restart Openbox.
|
|
|
If you run a composite manager (xcompmgr, compiz, compton, ...), increase the sleep time so that it finishes loading before tint2.
|
|
|
|
|
|
## Autorun tint2 in Fluxbox
|
|
|
* Remove the fluxbox panel and systray from the file `~/.fluxbox/init`.
|
|
|
* Remove systemtray from the list of items on the line `session.screen0.toolbar.tools`.
|
|
|
* On the line `session.screen0.toolbar.visible: true` change `true` to `false`.
|
|
|
* Add in `~/.fluxbox/startup`:
|
|
|
```
|
|
|
(sleep 2s && tint2) &
|
|
|
```
|
|
|
Restart Fluxbox.
|
|
|
|
|
|
## Autorun tint2 in Gnome 2
|
|
|
Go to System > Preferences > Sessions. Fill the form as shown in the screenshot and click on add.
|
|
|
|
|
|
![](http://farm4.static.flickr.com/3043/3287368393_57101eabfa.jpg)
|
|
|
|
|
|
|
|
|
# Troubleshooting
|
|
|
|
|
|
If you run into any problems, please check out the [FAQ](FAQ).
|
|
|
|
|
|
Compiz users should especially check the [Tint2 doesn't work on compiz correctly?](FAQ) section of the FAQ.
|
|
|
|
|
|
|
|
|
# Uninstalling after installing from source
|
|
|
|
|
|
First of all determine which files were installed by make install. For that you can look at the make install output (just run it again from the build directory if necessary), of interest are the lines that look like this:
|
|
|
|
|
|
```
|
|
|
-- Installing: /usr/local/bin/tint2
|
|
|
-- Up-to-date: /usr/local/share/icons/hicolor/scalable/apps/tint2.svg
|
|
|
-- Up-to-date: /usr/local/share/applications/tint2.desktop
|
|
|
-- Up-to-date: /etc/xdg/tint2/tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/default_icon.png
|
|
|
-- Up-to-date: /usr/local/share/doc/tint2/AUTHORS
|
|
|
-- Up-to-date: /usr/local/share/doc/tint2/ChangeLog
|
|
|
-- Up-to-date: /usr/local/share/doc/tint2/README.md
|
|
|
-- Up-to-date: /usr/local/share/man/man1/tint2.1
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_7.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/vertical-dark-opaque.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_2.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_and_text_3.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_and_text_4.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_and_text_1.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_6.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/horizontal-light-opaque.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/vertical-light-opaque.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_and_text_2.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_4.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_5.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/vertical-dark-transparent.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/horizontal-dark-opaque.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_2.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_4.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/horizontal-dark-transparent.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_3.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_6.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_1.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/icon_only_3.tint2rc
|
|
|
-- Up-to-date: /usr/local/share/tint2/text_only_1.tint2rc
|
|
|
-- Installing: /usr/local/bin/tint2conf
|
|
|
-- Up-to-date: /usr/local/share/icons/hicolor/scalable/apps/tint2conf.svg
|
|
|
-- Up-to-date: /usr/local/share/applications/tint2conf.desktop
|
|
|
-- Up-to-date: /usr/local/share/locale/fr/LC_MESSAGES/tint2conf.mo
|
|
|
-- Up-to-date: /usr/local/share/locale/pl/LC_MESSAGES/tint2conf.mo
|
|
|
-- Up-to-date: /usr/local/share/locale/sr/LC_MESSAGES/tint2conf.mo
|
|
|
-- Up-to-date: /usr/local/share/locale/bs/LC_MESSAGES/tint2conf.mo
|
|
|
-- Up-to-date: /usr/local/share/locale/hr/LC_MESSAGES/tint2conf.mo
|
|
|
```
|
|
|
|
|
|
Those are the files that need to be removed. Afterwards you can also reinstall the packaged version by removing and installing again the package, for instance:
|
|
|
|
|
|
```
|
|
|
sudo apt-get remove tint2
|
|
|
sudo apt-get install tint2
|
|
|
``` |