
                 wmtheme -- window manager theme utility


Description
----------

  wmtheme is a command-line perl program to manage window manager themes.
  There is support for AfterStep, Blackbox, Enlightenment, Golem, GTK+,
  IceWM, Oroborus, Sawfish, Window Maker, and xmms.

  wmtheme can be used to activate, install, uninstall, list, and download
  themes from www.themes.org.


    Theme subject      How to run
    -------------      -----------
    AfterStep          astheme
    Blackbox           bbtheme
    Enlightenment      etheme
    GTK+               gtktheme
    IceWM              itheme
    Sawfish            sftheme
    Window Maker       wmtheme
    xmms               xmtheme
    Oroborus           ortheme *
    Golem              gotheme *

  * Support for these window managers is not enabled by default.
    Create a symlink to enable them, e.g.:

      ln -s `which wmtheme` ~/bin/ortheme


Examples
-------

  To try a theme on wm.themes.org, called "The Matrix":

    wmtheme -g matrix

  To install a theme that has been downloaded as Dolphins2.tar.gz:

    wmtheme -i Dolphins2.tar.gz

  To rename a Blackbox theme from "cryptix" to "Cogs"

    bbtheme -r cryptix Cogs

  To try out an xmms skin:

    wget ftp://ftp.xmms.org/xmms/Skins/Covenant.zip
    xmtheme -i Covenant.zip


User data directory and additional configuration
------------------------------------------------

  User data and the configuration file are stored in ~/.wmtheme.
  This directory will not be created unless the program is given
  permission to do so.

  However, it is advisable to have it right away.  The -b/--backout
  option cannot uninstall any theme unless the fact that it was
  installed can be recorded.  The data directory is required for
  this.

  Run "wmtheme --setup" as a user to create ~/.wmtheme and copy
  the default configuration file into it.  The program will also
  request permission to do this if you try to use a function that
  requires it, such as "wmtheme -f".

  The data directory is used for the following purposes:

   *  caches themes so it doesn't have to scan all directories
      each time it's run

   *  enables -f/--favorite

   *  ensures that -R/--random won't repeat

   *  enables -b/--backout and -B/--backmany

   *  enables --update

   *  allows additional options to be set in ~/.wmtheme/conf
      (see the manual page, CONFIGURATION section)


Font support
------------

  As of version 1.2.1, wmtheme has experimental font support.  It is not
  enabled by default.  See README.fonts for more information.


Feedback
--------

  Send feedback to: jswink@pacbell.net

