
                 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, and list themes.

  The program cannot distinguish between different kinds of themes on its
  own, so you must run it using the invocation that corresponds to the
  window manager:

    Theme type         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 install an IceWM theme that has been downloaded as Dolphins2.tar.gz:

    itheme -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

