ObConf:About

From Openbox

(Difference between revisions)
Jump to: navigation, search
m (Obconf moved to Obconf:About: We can have an Obconf namespace.)
(Dependencies)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Features ==
+
This page is about the Openbox configuration tool, ObConf 2.0.
* Real theme previews generated using libobrender
+
* Written in Ruby, not a pain in the ass to add new options to it (not 500 callback functions like the C version)
+
  
== Caveats ==
+
== Installing and distributing Openbox themes ==
* Lags behind openbox development either because I'm lazy or because of school.
+
* Ubuntu has an old (buggy) version of ruby-gnome2 in its repositories that doesn't work well with Obconf.
+
  
== Installation ==
+
ObConf now easily installs new themes which use the <code>.obt</code> Openbox theme archive format for distribution.  Just open any <code>.obt</code> theme archive in your file browser, or use the interface provided inside ObConf.
You'll need the following:
+
  
* openbox from subversion
+
You can also use ObConf to create <code>.obt</code> Openbox theme archives for distributing your own themes.
svn co svn://svn.icculus.org/openbox/trunk/ openbox
+
cd openbox; ./configure --prefix=/usr; make; make install [make install requires root privileges]
+
* [http://ruby-gnome2.sourceforge.jp/ ruby-gnome2] 0.16.0 or cvs.
+
** FOR 0.16.0 ONLY: edit /usr/lib/ruby/site_ruby/1.8/libglade2.rb
+
*** find (should be line 42)
+
#!ruby
+
if signal_proc
+
*** add guard_source_from_gc(source) so that it looks like
+
#!ruby
+
if signal_proc
+
    guard_source_from_gc(source)
+
* ruby-gettext
+
* obtain and install obconf
+
** svn co http://svn.l3ib.org/obconf/trunk obconf
+
** cd obconf; sudo ruby setup.rb [requires root privileges]
+
* enjoy life
+
** run obconf2
+
  
 
== Screenshots ==
 
== Screenshots ==
[[Image:Obconf_Theme.png]]
+
{|-
 +
| [[Image:ObConfTheme.png|thumb|Theme options]]
 +
| [[Image:ObConfAppearance.png|thumb|Appearance options]]
 +
| [[Image:ObConfBehavior.png|thumb|Behavior options]]
 +
|-
 +
| [[Image:ObConfDesktops.png|thumb|Desktop options]]
 +
| [[Image:ObConfDock.png|thumb|Dock options]]
 +
|-
 +
|}
  
[[Image:Obconf_Appearance.png]]
+
== Download ==
 +
ObConf is available for [[Openbox:Download#ObConf - Openbox configuration tool| download here]].
  
[[Image:Behaviour.png]]
+
The current changelog is [[ObConf:Changelog| found here]].
  
[[Image:Obconf_Desktops.png]]
+
== Installing ObConf ==
  
[[Image:Obconf_Dock.png]]
+
ObConf should be installed to the <code>/usr</code> prefix to have file associations function correctly.
 +
 
 +
When ObConf is installed, upgraded or uninstalled, you need to run these commands to update the <code>.obt</code> file associations for GNOME:
 +
<code><pre>
 +
update-mime-database /usr/share/mime
 +
update-desktop-database /usr/share/applications
 +
</pre></code>
 +
These programs are a part of the <code>shared-mime-info</code> and <code>desktop-file-utils</code> packages.  They should be installed if GNOME is installed.
 +
 
 +
=== Dependencies ===
 +
 
 +
Compiling ObConf requires the following packages:
 +
* GTK+ 2.x library and headers (development package)
 +
* Glade 2.x library and headers (development package)
 +
* Openbox 3.4 or above (the libraries development package if it is separate)
 +
 
 +
=== Building ObConf ===
 +
 
 +
If you have installed Openbox into the <code>/usr/local</code> prefix, you will need to tell the ObConf configure script where to find the Openbox libraries:
 +
 
 +
<code><pre>
 +
  PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ./configure --prefix=/usr
 +
</pre></code>

Latest revision as of 09:37, 10 June 2007

This page is about the Openbox configuration tool, ObConf 2.0.

Contents

[edit] Installing and distributing Openbox themes

ObConf now easily installs new themes which use the .obt Openbox theme archive format for distribution. Just open any .obt theme archive in your file browser, or use the interface provided inside ObConf.

You can also use ObConf to create .obt Openbox theme archives for distributing your own themes.

[edit] Screenshots

(thumbnail)
Theme options
(thumbnail)
Appearance options
(thumbnail)
Behavior options
(thumbnail)
Desktop options
(thumbnail)
Dock options

[edit] Download

ObConf is available for download here.

The current changelog is found here.

[edit] Installing ObConf

ObConf should be installed to the /usr prefix to have file associations function correctly.

When ObConf is installed, upgraded or uninstalled, you need to run these commands to update the .obt file associations for GNOME:

update-mime-database /usr/share/mime
update-desktop-database /usr/share/applications

These programs are a part of the shared-mime-info and desktop-file-utils packages. They should be installed if GNOME is installed.

[edit] Dependencies

Compiling ObConf requires the following packages:

  • GTK+ 2.x library and headers (development package)
  • Glade 2.x library and headers (development package)
  • Openbox 3.4 or above (the libraries development package if it is separate)

[edit] Building ObConf

If you have installed Openbox into the /usr/local prefix, you will need to tell the ObConf configure script where to find the Openbox libraries:

  PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ./configure --prefix=/usr
Personal tools