Configuring the Window Manager:
← Older revision
Revision as of 08:50, 12 December 2012
(3 intermediate revisions by one user not shown)
Line 1:
Line 1:
−
=
Default Config
=
+
==
Introduction
==
−
== Default Keybindings
==
+
−
* Root Menu: "Pandora Key" or
"Ctrl-M"
"Right-Nub-Right-Click"
+
Openbox for the Pandora aims to provide a GUI that's quick, responsive, and highly configurable. The PND (Switch GUI: Openbox) installs a number of components - namely: the window manager itself; the "Warlock Bar" for launching PNDs you've placed in pandora/apps or pandora/menu, and "tint2" - a panel that provides a taskbar, system tray, clock, and battery indicator. Configuration for each component is typically done by editing text files, or by using a graphical application that will edit the files for you, and let you preview the results.
+
+
[[File:OpenboxScreenshot.png|center]]
+
+
+
+
== Configuring the Window Manager ==
+
+
Openbox lets you assign key and/or mouse events with actions. By default, the following are defined:
+
+
* Root Menu: "Pandora Key" or "Right-Nub-Right-Click"
* Go To Desktop 1: Alt DPAD-left
* Go To Desktop 1: Alt DPAD-left
* Go To Desktop 2: Alt DPAD-right
* Go To Desktop 2: Alt DPAD-right
Line 14:
Line 23:
* Long press on "Pandora Key": a kill menu
* Long press on "Pandora Key": a kill menu
−
= Customize your environment =
+
You can add more by editing $XDG_CONFIG_HOME/openbox/rc.xml (Root Menu
-
> Config -> Edit rc.xml - keybinding start around line 177). Additional keybindings from CountOrlock's setup are here
:
[[OpenBox#rc.xml]]
−
* start
-
up file
: /
usr/bin
/openbox-
session
+
−
* pnd menu
: /
etc
/
xdg
/
menus/openbox
-
pnd
.menu
+
You can also define exactly how each application is launched. Line 660 onwards of rc.xml shows that XFCE's terminal is always launched maximized, and - commented out - how jumanji can be launched fullscreen, and how the size, position and appearance of applications can be controlled.
−
* root menu:
/
home
/
>/
Applications
/
Settings
/
openbox
/
menu
.
xml
+
−
* openbox settings: /home/
yourname
>
/Applications/Settings/openbox/rc
.
xml
+
The contents Root Menu is defined in $XDG_CONFIG_HOME
/
openbox
/
menu.xml (Choose Root Menu -> Config -> Edit menu.xml). You can remove submenus and shortcuts you don't need, and add ones you do - as exemplified by CountOrlock's additions [[OpenBox#menu.xml]]
−
* execute before openbox starts:
/
home
/
/
Applications
/
Settings
/
openbox
/
environment
+
−
* execute after openbox starts:
/
home
/
yourname
>/
Applications
/
Settings
/openbox/autostart
+
After making your changes and saving the file, reconfigure
openbox
(Root Menu
-
> Config -> Reconfigure) to see the results.
−
* manually add stuff to warlock
bar
:
/
home
/
/
Applications
/
Settings/openbox
/wbar_custom.cfg
+
+
The graphical application for configuring the window manager is called obconf, and is accessed via Root Menu -> Config -> Config Manager. Amongst other things, this lets you choose and preview an Openbox theme. Openbox themes (as distinct from GTK+ themes), control the appearence of the Root Menu, application window frames (but not the contents), and buttons such as Maximize and Close. Additional themes can be downloaded from sites such as http
://
box-look.org - they are typically packaged in the ".obt "achive file understood by obconf.
+
+
== Configuring GTK+ Applications ==
+
+
The appearance of GTK+ applications such as Mousepad and Geany are controlled by GTk+ engines and themes, the choice of which is determined in the $HOME
/
.gtkrc
-
2
.
0 file. This file can be manipulated by choosing Root Menu -> Config -> GTK+ Theme Switcher. GTK+ themes control the contents of application windows - the scrollbar, the colours, and the
menu
items. If you want to extend a theme, you can edit $HOME/.gtkrc.mine - the file placed there by default shows how to make scrollbars bigger as an example.
+
+
==Configuring the Panel==
+
+
By default, the tint2 panel is started along with the window manager. To change this, edit $XDG_CONFIG_HOME
/
openbox
/
autostart (Root Menu -
>
Config -> Edit autostart). You can also change whether it appears or not via Root Menu -> Toggle Tint2 Panel. The graphical application for configuration is launched by choosing Root Menu -> Config -> Tint2 Panel Wizard. Interesting options can be found in Panel -> Panel Display (to move the panel to the bottom of the screen for example); Panel -> Panel Autohide (to choose whether the panel only appears when you mouseover its area, to give you the maximum screen real estate for applications), and in Launchers. There's 3 slots for application launchers, with a Root Menu launcher in slot 1 by default. To add a launcher for a PND, add the path to it's desktop file (e.g.
/
usr
/
share
/
applications
/
hdonk_firefox_001#0
.
desktop) to one of the slots. You can also create your own desktop files for custom actions, e.g. launching the File Manager for the root of a SD card:
+
+
pre
>
+
[Desktop Entry]
+
Name=Show SD 1 Contents
+
Type=Application
+
Version=1
.
0
+
Icon=
/
usr
/
share
/
icons
/
gnome
/
32x32
/
devices/gnome-dev-media-sdmmc.png
+
Exec=Thunar
/
media
/
mmcblk0p1
+
/pre
>
+
+
Save this text in a file called $XDG_CONFIG_HOME
/
tint2
/
showSD1.desktop and add this path to one of the launcher slots.
+
+
==Configuring the Warlock Bar==
+
+
By default, the Warlock Bar is started along with the window manager. To change this, edit $XDG_CONFIG_HOME
/openbox/autostart
(Root Menu -> Config -> Edit autostart). You can also change whether it appears or not via Root Menu -> Toggle Warlock Bar. The
bar
's contents are auto-generated at startup by merging the file at $XDG_CONFIG_HOME
/
openbox
/
wbar_custom.cfg with a config created from the PNDs installed in pandora
/
apps or pandora
/
desktop (or - more accurately, it's created from the .desktop files in $HOME
/
Desktop). You can add or remove other entries by choosing Root Menu -> Config -> Edit
wbar_custom.cfg
, and change it's appearance by editing the first entry in that file (e.g. changing the second line to "c: wbar --bpress --pos right --vbar --isize 48 --idist 15 --nanim 4 --falfa 65" would put a vertical bar on the right of the screen). After making changes, choose Root Menu -> Config -> Reload Warlock bar to see them.
= CountOrlock Config =
= CountOrlock Config =