Note: this wiki is no longer maintained. If you have any questions related to this wiki, please post them on the CrunchBang forums.
Tint2 is the default panel for CrunchBang, it is specifically designed for Openbox, CrunchBang's default window manager. By default Tint2 shows task bars for both desktops, applications can be dragged from desktop to desktop using the panel, and you can also switch desktops by clicking on the relevant task bar. The configuration file is stored in ~/.config/tint2, it is accessible in the menu in Preferences –> tint2 panel config –> edit config files. Sections of the configuration file are covered below.
1: Task bar for desktop 1, 2: Task bar for desktop 2, 3: System tray (right), 4: Clock (left)
The first section of the config file deals with the colour and border of the panel, the default configuration file has 3 groups that look similar to the following:
rounded = 0 border_width = 1 background_color = #FFFFFF 0 border_color = #FFFFFF 20
By default the first 'colour group' is for the entire panel border, the second is for active tasks and the third is for inactive tasks, but you can assign any 'colour group' to any part of the panel by changing any of the variables that end with 'id', for example:
panel_background_id = 0
would use the first 'colour group', (the index starts from 0), to use the second colour group change it to:
panel_background_id = 1
You will notice that most sections have at least one of these 'id' variables.
rounded = 0
The rounding of the left and right borders. Examples are 6 or 15 pixels wide, there is a maximum limit. Rounding one pixel isn't much different than a zero rounded rectangle border.
border_width = 1
The thickness of the border in pixels
background_color = #FFFFFF 0
#FFFFFF is the colour of the main body, 0 is the opacity, 0 is clear, 100 is solid. You can use gcolor2 to select a colour.
border_color = #FFFFFF 20
Same as above except for the border.
this section deals with the panel as a whole.
panel_monitor = all panel_position = bottom center panel_size = 100% 28 panel_margin = 0 0 panel_padding = 7 0 font_shadow = 0 panel_background_id = 0 wm_menu = 0
panel_monitor = all
(If you have more than one monitor), choose which one it is displayed on, 1,2,3…. all.
panel_position = bottom center horizontal
The position on the screen of the panel, vertical x horizontal x orientation. Valid vertical values are bottom, top or center. Valid horizontal values are left, right or centre. valid orientation values are horizontal or vertical.
panel_size = 100% 28
The percentage is the width of the panel relative to the screen, the next value is the height in pixels of the panel.
panel_margin = 0 0
The margin in pixels horizontal x vertical to the edge of the screen.
panel_padding = 7 0
Padding around the taskbar horizontal x vertical.
font_shadow = 0
The font has a show effect or not 1 = true, 0 = false.
panel_background_id = 0
Which colour combination group (covered above) is used.
wm_menu = 0
Whether to allow showing the main menu when right clicking on a clear area of the panel, 1 = true, 0 = false.
The taskbar is the section where your currently running applications are shown.
taskbar_mode = multi_desktop taskbar_padding = 0 0 0 taskbar_background_id = 1
taskbar_mode = multi_desktop
whether to show all desktops, or jut the current one, by default on crunchbang shows both, valid options are single_desktop or multi_desktop.
taskbar_padding = 0 0 0
the padding for tasks in the taskbar, horizontal padding for the taskbar as a whole, vertical padding, horizontal padding for each task in taskbar, all measured in pixels.
taskbar_background_id = 1
colour group to use for the taskbar.
This section covers the individual tasks running in the taskbar.
task_icon = 1 task_text = 1 task_width = 160 task_centered = 1 task_padding = 2 2 task_font = sans 7 task_font_color = #ffffff 70 task_active_font_color = #ffffff 85 task_background_id = 3 task_active_background_id = 2
task_icon = 1
Whether to show application icons in the taskbar, 1 = true, 0 = false.
task_text = 1
Whether to show application text in the taskbar, 1 = true, 0 = false.
task_width = 160
The default width of tasks in the taskbar, in pixels.
task_centered = 1
Whether to centre or the text of the task, 1 = true, 0 = false.
task_padding = 2 2
Horizontal and vertical padding for each individual task.
task_font = sans 7
Taskbar font and size.
task_font_color = #ffffff 70
Taskbar font colour and opacity for non selected tasks, opacity is between 0 clear, and 100 solid.
task_active_font_color = #ffffff 85
and the same for the active task.
task_background_id = 3
Which colour group to use for non active tasks.
task_active_background_id = 2
Which colour group for active task.
The system tray is on the right and generally shows internet connection status, volume etc.
systray_padding = 4 2 3 systray_background_id = 0
systray_padding = 4 2 3
Padding for the system tray, horizontal padding for system tray as a whole, vertical padding and horizontal padding between items in system tray, all measured in pixels.
systray_background_id = 0
Colour group to use for system tray.
time1_format = %H:%M time1_font = sans 10 time2_format = %a %d %B time2_font = sans 8 clock_font_color = #ffffff 76 clock_padding = 4 4 clock_background_id = 0 clock_lclick_command = xclock clock_rclick_command = gworldclock
time1_format = %H:%M
Format for the first line of the clock.
time1_font = sans 10
Font style and size for the first line.
time2_format = %a %d %B
Time format for line two.
time2_font = sans 8
Font style and size for the second line.
clock_font_color = #ffffff 76
Colour and opacity for for clock fonts.
clock_padding = 4 4
Padding for the clock horizontal and vertical.
clock_background_id = 0
colour group to use for the clock.
clock_lclick_command = xclock
Command to run when left clicking on the clock, in this case xclock.
clock_rclick_command = gworldclock
Command to run when right clicking on the clock.
battery = 0 battery_low_status = 7 battery_low_cmd = notify-send "battery low" bat1_font = sans 8 bat2_font = sans 6 battery_font_color = #ffffff 76 battery_padding = 1 0 battery_background_id = 0
battery = 0
Whether to show the battery applet or not, 1 = true, 0 = false.
battery_low_status = 7
At what percentage will battery_low_cmd be run.
battery_low_cmd = notify-send "battery low"
The command to run when the battery reaches the percentage defined in batter_low_status.
bat1_font = sans 8 bat2_font = sans 6
Font and size for lines in battery applet.
battery_font_color = #ffffff 76
Colour and opacity for battery applet font.
battery_padding = 1 0
Padding for the battery applet, horizontal and vertical.
battery_background_id = 0
Colour group to use for battery.
What to do with certain mouse actions, options are none, close, toggle, iconify, shade and toggle_iconify.
mouse_middle = none mouse_right = close mouse_scroll_up = toggle mouse_scroll_down = iconify
It is possible to have multiple panels, like the Gnome panel. To do so you just need to create a second configuration file, save it, for example as tint2rc2 and put it with the original tint2rc in ~/.config/tint2, then to run enter the following into the terminal:
tint2 -c ~/.config/tint2/tint2rc2 &
Once you are happy, add the same command to your autostart file.