ObConf:About

From Openbox

(Difference between revisions)
Jump to: navigation, search
(ObConf 1)
(Dependencies)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
= ObConf 1 =
+
This page is about the Openbox configuration tool, ObConf 2.0.
The old 1.x series of ObConf is available for [[Openbox:Download| download here]].  It will be soon replaced by the 2.x series, which you can read about below.
+
  
The current changelog is [[ObConf:Changelog| found here]].
+
== Installing and distributing Openbox themes ==
 +
 
 +
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 can also use ObConf to create <code>.obt</code> Openbox theme archives for distributing your own themes.
  
 
== Screenshots ==
 
== Screenshots ==
 
{|-
 
{|-
| [[Image:ObConf1Theme.png|thumb|Theme options]]
+
| [[Image:ObConfTheme.png|thumb|Theme options]]
| [[Image:ObConf1Appearance.png|thumb|Appearance options]]
+
| [[Image:ObConfAppearance.png|thumb|Appearance options]]
| [[Image:ObConf1Behavior.png|thumb|Behavior options]]
+
| [[Image:ObConfBehavior.png|thumb|Behavior options]]
 
|-
 
|-
| [[Image:ObConf1Desktops.png|thumb|Desktop options]]
+
| [[Image:ObConfDesktops.png|thumb|Desktop options]]
| [[Image:ObConf1Dock.png|thumb|Dock options]]
+
| [[Image:ObConfDock.png|thumb|Dock options]]
 
|-
 
|-
 
|}
 
|}
  
= ObConf 2 =
+
== Download ==
 +
ObConf is available for [[Openbox:Download#ObConf - Openbox configuration tool| download here]].
  
== Features ==
+
The current changelog is [[ObConf:Changelog| found here]].
* 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 ObConf ==
* 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 should be installed to the <code>/usr</code> prefix to have file associations function correctly.
You'll need the following:
+
  
* openbox from subversion
+
When ObConf is installed, upgraded or uninstalled, you need to run these commands to update the <code>.obt</code> file associations for GNOME:
svn co svn://svn.icculus.org/openbox/trunk/ openbox
+
<code><pre>
cd openbox; ./configure --prefix=/usr; make; make install [make install requires root privileges]
+
update-mime-database /usr/share/mime
* [http://ruby-gnome2.sourceforge.jp/ ruby-gnome2] 0.16.0 or cvs.
+
update-desktop-database /usr/share/applications
** FOR 0.16.0 ONLY: edit /usr/lib/ruby/site_ruby/1.8/libglade2.rb
+
</pre></code>
*** find (should be line 42)
+
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.
#!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 ==
+
=== Dependencies ===
[[Image:Obconf_Theme.png]]
+
  
[[Image:Obconf_Appearance.png]]
+
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)
  
[[Image:Behaviour.png]]
+
=== Building ObConf ===
  
[[Image:Obconf_Desktops.png]]
+
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:
  
[[Image:Obconf_Dock.png]]
+
<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