shearn89
September 13th, 2007, 07:05 AM
In response to a post in the Screenshot thread, here is a quick howto on how to get Openbox up and running...
All commands in "code" tags should be run in a terminal. I have also added command-line instructions, for those who like to do things the CL way! These are prefixed with "Code:". Ignore it if you wish.
N.B - I myself had some problems with the autostart file working. This was fixed (for me) by reinstalling Openbox using the .deb from the website. In the meantime, if your autostart isn't working, i'd suggest trying the package in the Gutsy repos (if you're on gutsy), or the official deb. I'm fairly certain the gutsy repo version is the latest, as I Gutsy is no longer in beta testing.
This howto has been fully tested on Feisty and Gutsy 32bit. I don't have any idea about 64bit, or Dapper.
This howto should be safe, and poses no risk in terms of breaking your system, however, I obviously take no responsibility. If you do get stuck or something breaks, post a reply to this (preferably with some feedback about where/how you got stuck) or in the "Random Openbox Chatter" thread (community cafe). Someone should be able to help you out!
1. Grab the latest .deb from here: http://icculus.org/openbox/releases/openbox_3.4.4-0ubuntu1_i386.deb
and run it. This can be done either by clicking on the link and opening the file, or with the following command (assuming it downloads to the home folder):
wget http://icculus.org/openbox/releases/openbox_3.4.4-0ubuntu1_i386.deb
dpkg -i openbox_3.4.4-0ubuntu1_1386.deb
If it downloaded to the Desktop folder (or any other), you will have to insert "cd <directory>" after the wget.
2. Get the configuration tool from here:
http://icculus.org/openbox/obconf/obconf_2.0.2-0ubuntu1_i386.deb
and run it.
wget http://icculus.org/openbox/obconf/obconf_2.0.2-0ubuntu1_i386.deb
dpkg -i obconf_2.0.2-0ubuntu1_i386.deb
3. Grab the other stuff that you might want:
sudo apt-get install thunar thunar-volman-plugin pypanel feh
and also this:
http://david.chalkskeletons.com/scripts/wallmenu-0.3.py
Move the wallmenu script to your home directory, and rename it ".wallmenu.py".
Then open it (you may need to press ctrl-h to view hidden files).
wget http://david.chalkskeletons.com/scripts/wallmenu-0.3.py
mv wallmenu-0.3.py .wallmenu.py
gedit .wallmenu.py
Change the following bits:
# --------------------------------------------------------------------------- #
# User configuration #
# --------------------------------------------------------------------------- #
# types of files accepted (list, seperated by a |)
filetypes = "jpg|png|gif|jpeg"
# directory where wallpapers are stored (must be long: no ~ symbol allowed)
directory = "/home/<your username>/<your wallpaper directory>"
# program to set wallpaper
program = "feh --bg-scale"
Thunar is the lightweight file manager we'll be using, the volman-plugin is a plugin for it that deals with mounting/unmounting volumes (similar to the nautilus equivalent).
Feh is the program we'll be using for setting the background - it is a command line image viewer (can do slideshows and things - see "feh --help" for more info).
Pypanel is the panel and system tray we'll be using. See the sourceforge page (http://pypanel.sourceforge.net/) for more info.
There are a number of alternatives to these programs; You CAN use nautilus instead of thunar, although it is slower and you have to be careful not to let it draw the desktop, and I know others use konqueror. I use thunar mainly because konqueror (to my knowledge) depends on a lot of libraries not on a default Ubuntu install - if you installed Kubuntu, konqueror would be a good choice. If you have a hunt around the forums, or on google, you will come across huge numbers of other options - look for "file managers".
Pypanel is used here because it is a popular choice, and the default configuration file is quite nicely setup and easy to change. I personally use XFCE4-Panel (installable via apt-get), but you could also try Perlpanel or Visibility. Again, check the forums or google.
As fuscia says - one of the intentions of openbox is to get out of people's way so that they can run whatever apps they wish, so it's important, i think, to make people aware of how wide their choices are.
4. Copy the default configuration file to your openbox config directory so you can change keybindings etc.
cp /etc/xdg/openbox/rc.xml ~/.config/openbox/
If you want to, you can set your most-used programs to be launched with keyboard shortcuts. This is all done in this file. Open it with gedit, and find the section with lots of entries saying <keybind>. These can be changed to launch whatever you like (I have mine set up so that Alt-f1 launches rxvt, alt-f2 launches firefox, alt-f3 launches thunar. When you're done, save the file. If you're doing this from inside openbox, you need to reconfigure it with the menu shortcut.
5. Download the menu.tar.gz attachment from the bottom of this post, and extract it into ~/.config/openbox/
wget http://www.mediamax.com/shearn89/Hosted/menu.tar.gz
mv menu.tar.gz ~/.config/openbox/
cd ~/.config/openbox/
tar -xvf menu.tar.gz
6. Download the autostart.sh attachment from the bottom of this post, and copy it to the same place.
Code:
wget http://www.mediamax.com/shearn89/Hosted/autostart.sh
mv autostart.sh ~/.config/openbox/
This autostart script loads most of the useful things (screensaver daemon, keyring, gnome settings to match themes). It also loads Gaim - if you don't want this, you need to open the autostart.sh and remove the line saying "gaim &".
For more info on Autostart scripts, have a look at this page (http://icculus.org/openbox/index.php/Help:Autostart)
7. Finally, logout, go to "Options -> Select Session -> Openbox" and log back in again. You should be all done!
You may also want to install Nitrogen (a background chooser) so hunt round the forums, as I can't get it to work. In this howto we installed "feh" and what is called a "Pipe menu", which applies backgrounds for you.
Any questions/feedback/errors please tell me - i'll try and answer ASAP.
Other tools you may want to try:
Tint Task Manager (TTM) (ttm.googlecode.com)
XFCE4-panel (from the repos: "sudo apt-get install xfce4-panel")
Visibility (not sure where to find it).
NOTES:
This was tested on my laptop (640Mhz, 10GB HD, 512MB RAM), running Feisty 32bit install on i386 archictecture. Now also tested in Gutsy! yay!
Changelog:
29/10/07 - Fixed some typos, and added a short sentence on the rc.xml file. Added a disclaimer, and some info on what it's been tested on. Look out for urukrama's OB guide coming soon!
16/09/07 - Changed the terminal command for getting the attachments - now hosted offsite.
14/09/07 - Added link to Autostart page on OB site, and added info on the installed programs. Changed formatting for easier viewing. Added terminal code for downloading etc. Added comments on different programs.
All commands in "code" tags should be run in a terminal. I have also added command-line instructions, for those who like to do things the CL way! These are prefixed with "Code:". Ignore it if you wish.
N.B - I myself had some problems with the autostart file working. This was fixed (for me) by reinstalling Openbox using the .deb from the website. In the meantime, if your autostart isn't working, i'd suggest trying the package in the Gutsy repos (if you're on gutsy), or the official deb. I'm fairly certain the gutsy repo version is the latest, as I Gutsy is no longer in beta testing.
This howto has been fully tested on Feisty and Gutsy 32bit. I don't have any idea about 64bit, or Dapper.
This howto should be safe, and poses no risk in terms of breaking your system, however, I obviously take no responsibility. If you do get stuck or something breaks, post a reply to this (preferably with some feedback about where/how you got stuck) or in the "Random Openbox Chatter" thread (community cafe). Someone should be able to help you out!
1. Grab the latest .deb from here: http://icculus.org/openbox/releases/openbox_3.4.4-0ubuntu1_i386.deb
and run it. This can be done either by clicking on the link and opening the file, or with the following command (assuming it downloads to the home folder):
wget http://icculus.org/openbox/releases/openbox_3.4.4-0ubuntu1_i386.deb
dpkg -i openbox_3.4.4-0ubuntu1_1386.deb
If it downloaded to the Desktop folder (or any other), you will have to insert "cd <directory>" after the wget.
2. Get the configuration tool from here:
http://icculus.org/openbox/obconf/obconf_2.0.2-0ubuntu1_i386.deb
and run it.
wget http://icculus.org/openbox/obconf/obconf_2.0.2-0ubuntu1_i386.deb
dpkg -i obconf_2.0.2-0ubuntu1_i386.deb
3. Grab the other stuff that you might want:
sudo apt-get install thunar thunar-volman-plugin pypanel feh
and also this:
http://david.chalkskeletons.com/scripts/wallmenu-0.3.py
Move the wallmenu script to your home directory, and rename it ".wallmenu.py".
Then open it (you may need to press ctrl-h to view hidden files).
wget http://david.chalkskeletons.com/scripts/wallmenu-0.3.py
mv wallmenu-0.3.py .wallmenu.py
gedit .wallmenu.py
Change the following bits:
# --------------------------------------------------------------------------- #
# User configuration #
# --------------------------------------------------------------------------- #
# types of files accepted (list, seperated by a |)
filetypes = "jpg|png|gif|jpeg"
# directory where wallpapers are stored (must be long: no ~ symbol allowed)
directory = "/home/<your username>/<your wallpaper directory>"
# program to set wallpaper
program = "feh --bg-scale"
Thunar is the lightweight file manager we'll be using, the volman-plugin is a plugin for it that deals with mounting/unmounting volumes (similar to the nautilus equivalent).
Feh is the program we'll be using for setting the background - it is a command line image viewer (can do slideshows and things - see "feh --help" for more info).
Pypanel is the panel and system tray we'll be using. See the sourceforge page (http://pypanel.sourceforge.net/) for more info.
There are a number of alternatives to these programs; You CAN use nautilus instead of thunar, although it is slower and you have to be careful not to let it draw the desktop, and I know others use konqueror. I use thunar mainly because konqueror (to my knowledge) depends on a lot of libraries not on a default Ubuntu install - if you installed Kubuntu, konqueror would be a good choice. If you have a hunt around the forums, or on google, you will come across huge numbers of other options - look for "file managers".
Pypanel is used here because it is a popular choice, and the default configuration file is quite nicely setup and easy to change. I personally use XFCE4-Panel (installable via apt-get), but you could also try Perlpanel or Visibility. Again, check the forums or google.
As fuscia says - one of the intentions of openbox is to get out of people's way so that they can run whatever apps they wish, so it's important, i think, to make people aware of how wide their choices are.
4. Copy the default configuration file to your openbox config directory so you can change keybindings etc.
cp /etc/xdg/openbox/rc.xml ~/.config/openbox/
If you want to, you can set your most-used programs to be launched with keyboard shortcuts. This is all done in this file. Open it with gedit, and find the section with lots of entries saying <keybind>. These can be changed to launch whatever you like (I have mine set up so that Alt-f1 launches rxvt, alt-f2 launches firefox, alt-f3 launches thunar. When you're done, save the file. If you're doing this from inside openbox, you need to reconfigure it with the menu shortcut.
5. Download the menu.tar.gz attachment from the bottom of this post, and extract it into ~/.config/openbox/
wget http://www.mediamax.com/shearn89/Hosted/menu.tar.gz
mv menu.tar.gz ~/.config/openbox/
cd ~/.config/openbox/
tar -xvf menu.tar.gz
6. Download the autostart.sh attachment from the bottom of this post, and copy it to the same place.
Code:
wget http://www.mediamax.com/shearn89/Hosted/autostart.sh
mv autostart.sh ~/.config/openbox/
This autostart script loads most of the useful things (screensaver daemon, keyring, gnome settings to match themes). It also loads Gaim - if you don't want this, you need to open the autostart.sh and remove the line saying "gaim &".
For more info on Autostart scripts, have a look at this page (http://icculus.org/openbox/index.php/Help:Autostart)
7. Finally, logout, go to "Options -> Select Session -> Openbox" and log back in again. You should be all done!
You may also want to install Nitrogen (a background chooser) so hunt round the forums, as I can't get it to work. In this howto we installed "feh" and what is called a "Pipe menu", which applies backgrounds for you.
Any questions/feedback/errors please tell me - i'll try and answer ASAP.
Other tools you may want to try:
Tint Task Manager (TTM) (ttm.googlecode.com)
XFCE4-panel (from the repos: "sudo apt-get install xfce4-panel")
Visibility (not sure where to find it).
NOTES:
This was tested on my laptop (640Mhz, 10GB HD, 512MB RAM), running Feisty 32bit install on i386 archictecture. Now also tested in Gutsy! yay!
Changelog:
29/10/07 - Fixed some typos, and added a short sentence on the rc.xml file. Added a disclaimer, and some info on what it's been tested on. Look out for urukrama's OB guide coming soon!
16/09/07 - Changed the terminal command for getting the attachments - now hosted offsite.
14/09/07 - Added link to Autostart page on OB site, and added info on the installed programs. Changed formatting for easier viewing. Added terminal code for downloading etc. Added comments on different programs.