Note: this wiki is no longer maintained. If you have any questions related to this wiki, please post them on the CrunchBang forums.

Translations of this page?:

DESKTOP tint2

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)

Background & Border

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.

Panel

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.

Taskbar

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.

Tasks

 Tasks in the taskbar, showing icons & no text.

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.

Systray Bar

 Tint2 system tray & clock.

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.

Clock

Formatting codes for the clock

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

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.

Mouse action on task

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

Adding Multiple Panels

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.

Links

 
tint2.txt · Last modified: 2012/05/25 17:49 by machinebacon
Except where otherwise noted, content on this wiki is licensed under the following license:CC Attribution-Share Alike 3.0 Unported

Powered by DokuWiki. Hosted by Linode.
Copyright © 2010 CrunchBang Linux.
Proudly powered by Debian GNU/Linux.
Debian is a registered trademark of Software in the Public Interest, Inc.