-
Notifications
You must be signed in to change notification settings - Fork 10
/
README
165 lines (158 loc) · 6.85 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
Xfce-Theme-Manager
©K.D.Hedger 2013-2019
Released under GPL see the included licence file ( {prefix}/share/Xfce-Theme-Manager/docs/gpl-3.0.txt )<br>
Translations of the licence can be found here:<br>
http://www.gnu.org/licenses/translations.html<br>
PLEASE NOTE!!<br>
This project is now in maintenence mode,I will NOT be accepting ANY new feeature requests.<br>
I will ONLY be accepting/fixing bugs.<br>
Please see the readme, man page or webpage:<br>
https://keithdhedger.github.io/pages/apps.html#themeed<br>
<br>
<br>
<br>
DEPENDENCIES:<br>
<br>
glib-2.0<br>
gdk-2.0<br>
cairo<br>
gtk+-2.0<br>
<br>
unzip - Runtime dependency to drag and drop zip archives.<br>
<br>
EXTERNAL APPS (Optional):<br>
Xfce4-Composite-Editor Available here:<br>
https://github.com/KeithDHedger/Xfwm4CompositeEditor/archive/xfce4-composite-editor-0.2.2.tar.gz<br>
<br>
CLI Usage: xfce-theme-manager [option.1] ... [option.N]<br>
<br>
OPTION Usage<br>
-v, --version Print version info and quit<br>
-u, --update-db Update the database<br>
-r, --build-db Re-build the database<br>
-n, --nogui Don't run the GUI<br>
-t, --theme=ARG Set the meta-theme to ARG<br>
-c, --controls=ARG Set the controls theme to ARG<br>
-w, --wmborder=ARG Set the window border to ARG<br>
-i, --icons=ARG Set the icon theme to ARG<br>
-p, --cursors=ARG Set the cursor theme to ARG<br>
-b, --backdrop=ARG Set wallpaper to ARG<br>
-l, --list=ARG List DB entry's, where ARG = any of "\*Ctwcib"<br>
Where 'C' prints custom themes, 't' prints themes,<br>
'w' prints window borders, 'c' prints controls,<br>
'i' prints icons and 'b' prints backdrops.<br>
If the first/only character is a '\*' then all entry's are printed.<br>
-?, --help=ARG This help<br>
<br>
Options tcwipblvh? all imply -n<br>
<br>
[Reset Theme]<br>
Discard all changes.<br>
<br>
[Save Theme]<br>
Enter a custom theme name to save/delete, you can also quickly delete a custom theme by control-clicking a custom theme thumbnail.<br>
<br>
[About]<br>
Credits and stuff.<br>
<br>
[Advanced Tab]<br>
<br>
<br>
[Rebuild DB]<br>
Rebuild the database.<br>
<br>
[Xfce-Composite-Editor]<br>
Run the composite editor (if installed).<br>
Available here:<br>
https://github.com/KeithDHedger/Xfwm4CompositeEditor/archive/xfce4-composite-editor-0.2.2.tar.gz<br>
You need to have gtkdialog version 0.8.x and BASH installed To run the Composite Editor.<br>
<br>
[Backdrop Adjustments]<br>
Set Brightness/Saturation of the wallpaper.<br>
<br>
[Button Layout]<br>
The layout of close, maximize etc. (some themes may overide this).<br>
<br>
[Title Position]<br>
Placement of the window title, (some themes may overide this).<br>
<br>
[Font Selection]<br>
Title bar/application font.<br>
<br>
[Cursor Size]<br>
Set the cursor size if the cursor theme suports it, some do some don't.<br>
<br>
[View Options]<br>
[Show system Themes]<br>
Show globally installed theme parts.<br>
<br>
[Only show Custom Themes]<br>
Only shows meta themes that you have created, auto generated meta themes are not shown.<br>
<br>
[Themes]<br>
Show installed meta themes.<br>
<br>
<br>
[Window Borders]<br>
Show installed Xwm4 themes.<br>
<br>
<br>
[Controls]<br>
Show installed Gtk themes.<br>
<br>
<br>
[Icons]<br>
Show installed icon themes.<br>
<br>
<br>
[Cursors]<br>
Show installed cursor themes.<br>
<br>
<br>
[Wallpapers]<br>
Show installed wallpapers.<br>
<br>
<br>
Locally installed themes parts are always shown except for meta themes if the [Only show Custom Themes] is checked.<br>
<br>
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.<br>
<br>
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.<br>
<br>
You must have unzip installed to drag 'n' drop .zip files.<br>
<br>
The thumbnails are stored in ${HOME}/.config/XfceThemeManager.<br>
<br>
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.<br>
<br>
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.<br>
<br>
<br>
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.<br>
<br>
INSTALL:<br>
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.<br>
<br>
The GUI can be run from the command line or from the settings menu.<br>
The GUI can be manually installed and/or run from the main folder.<br>
<br>
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 ).<br>
<br>
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:<br>
<br>
sudo apt-get update<br>
sudo apt-get install build-essential glib-2.0-dev libgtk2.0-dev libxfce4ui-1-dev<br>
<br>
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.<br>
<br>
You may have to run xfce4-panel --restart to see the Xfce-Theme-Manager menu item in settings.<br>
<br>
If you are upgrading from an older version please rebuild the DB ( from the "Advanced" tab ).<br>
<br>
BUGS:<br>
Please send them direct to me at: [email protected] posting them on xfce-look etc gets too messy!<br>
<br>
<br>
Enjoy!<br>