#------------------------------------------------------
#
# Xfce-Theme-Manager
#
# ©K.D.Hedger 2013
# kdhedger68713@gmail.com
#
# Released under GPL see the included licence file ( {prefix}/share/Xfce-Theme-Manager/docs/gpl-3.0.txt )
# Translations of the licence can be found here:
# http://www.gnu.org/licenses/translations.html
#------------------------------------------------------
DEPENDENCIES:
glib-2.0
gdk-2.0
cairo
gtk+-2.0
unzip - Runtime dependency to drag and drop zip archives.
****************************************************
EXTERNAL APPS (Optional):
Xfce4-Composite-Editor Available here:
http://gtk-apps.org/content/show.php/Xfce4-Composite-Editor?content=149523&PHPSESSID=f9317d406c1ed0e51799fb6b6a1e3e32
****************************************************
Usage: xfce-theme-manager [option.1] ... [option.N]
OPTION Usage
-v, --version Print version info and quit
-u, --update-db Update the database
-r, --build-db Re-build the database
-n, --nogui Don't run the GUI
-t, --theme=ARG Set the meta-theme to ARG
-c, --controls=ARG Set the controls theme to ARG
-w, --wmborder=ARG Set the window border to ARG
-i, --icons=ARG Set the icon theme to ARG
-p, --cursors=ARG Set the cursor theme to ARG
-b, --backdrop=ARG Set wallpaper to ARG
-l, --list=ARG List DB entry's, where ARG = any of "*Ctwcib"
Where 'C' prints custom themes, 't' prints themes,
'w' prints window borders, 'c' prints controls,
'i' prints icons and 'b' prints backdrops.
If the first/only character is a '*' then all entry's are printed.
-?, --help=ARG This help
Options tcwipblvh? all imply -n
[Reset Theme]
Discard all changes.
[Save Theme]
Enter a custom theme name to save/delete, you can also quickly delete a custom theme by control-clicking a custom theme thumbnail.
[About]
Credits and stuff.
[Advanced Tab]
[Rebuild DB]
Rebuild the database.
[Xfce-Composite-Editor]
Run the composite editor (if installed).
Available here:
http://keithhedger.hostingsiteforfree.com/zips/Xfce4-Composite-Editor.ta r.gz
You need to have gtkdialog version 0.8.x and BASH installed To run the Composite Editor.
[Backdrop Adjustments]
Set Brightness/Saturation of the wallpaper.
[Button Layout]
The layout of close, maximize etc. (some themes may overide this).
[Title Position]
Placement of the window title, (some themes may overide this).
[Font Selection]
Title bar/application font.
[Cursor Size]
Set the cursor size if the cursor theme suports it, some do some don't.
[View Options]
[Show system Themes]
Show globally installed theme parts.
[Only show Custom Themes]
Only shows meta themes that you have created, auto generated meta themes are not shown.
[Themes]
Show globally installed meta themes.
[Window Borders]
Show globally installed Xwm4 themes.
[Controls]
Show globally installed Gtk themes.
[Icons]
Show globally installed icon themes.
[Cursors]
Show globally installed mouse themes.
[Wallpapers]
Show globally installed wallpapers.
Locally installed themes parts are always shown except for meta themes if the [Only show Custom Themes] is checked.
You can quickly delete a custom theme by holding control and clicking on the thumbnail, only custom themes you have created can be deleted and only the database entry is removed nothing is uninstalled from your system.
To install a theme/gtk/icon/cursor/border/wallpaper just drag and drop the archive (wallpapers should not be archived) anywhere on the main window and if posible the theme etc will be installed into the correct place, all installations are local, supported archive types are: "*.tgz","*.gz","*.zip","*.tar","*.bz2", supported wallpaper types are: "*.jpg","*.png","*.bmp","*.gif" anything else you will have to install yourself.
You must have unzip installed to drag 'n' drop .zip files.
The thumbnails are stored in ${HOME}/.config/XfceThemeManager.
The DB is updated automatically on drag'n'drop, if you do a lot of adding and removing of themes/icons etc you may want to run Re-build DB from the advanced tab.
Meta Themes are themes that contain a gtk2 folder and an xfwm4 folder (ie window frames and controls), if there is a gnome-like "theme.index" file that also specifies an icon set this will be used as well.
Spanish/German is now catered for if you have set the 'LANG' enviroment variable properly, other translations are invited email me for a list to be translated.
INSTALL:
Extract the archive say into /tmp, cd into /tmp/Xfce-Theme-Manager-(VERSION), run ./autogen.sh ( or ./configure ), make, sudo make install, this will install the Xfce-Theme-Manager GUI, icon and the desktop file.
The GUI can be run from the command line or from the settings menu.
The GUI can be manually installed and/or run from the main folder.
There is no configure script as the makefile is very simple, default is to install in /usr/local/bin this can be changed by setting the PREFIX variable prior to make install ( sudo make install PREFIX=/usr ).
If you have a source based pkg manager like slackware the dev files for glib etc should already be installed, if you are using a debian based install you may have to install the dev packages as well, from a terminal for a clean system type:
sudo apt-get update
sudo apt-get install build-essential glib-2.0-dev libgtk2.0-dev libxfce4ui-1-dev
Check your installation documentation for further details, but this works on a new clean version of xubuntu-12.10, other flavours of debian based installs should be the same.
You may have to access xfce-theme-manager via the main settings manager in the main menu.
You may have to run xfce4-panel --restart to see the Xfce-Theme-Manager menu item in settings.
If you are upgrading from an older version please rebuild the DB ( from the "Advanced" tab ).
***************************************
BUGS:
Please send them direct to me at: kdhedger68713@gmail.com posting them on xfce-look etc gets too messy!
***************************************
Enjoy!
