README.md
1## Overview
2
3The Clearlooks-Phénix project aims at creating a GTK3 port of Clearlooks, the default theme for Gnome 2. Style is also included for GTK2, Unity and for Metacity, Openbox and Xfwm4 window managers.
4
5Here are screenshots (if applicable, click to see the original image):
6
7<a href="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/exemple1.png"><img src="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/exemple1.png" alt="Screenshot of a Gnome 3 desktop (fallback mode) with the Clearlooks-Phénix theme" width="658" height="493" /></a>
8
9<img src="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/exemple2.png" alt="Screenshot of gedit 3 with the Clearlooks-Phénix theme" width="659" height="537" />
10
11<a href="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/exemple3.png"><img src="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/exemple3.png" alt="Screenshot of GTK+ Widget Factory with the Clearlooks-Phénix theme" width="658" height="435" /></a>
12
13## Requirements
14
15- Requirements for Clearlooks-Phénix v1: packages `gtk2-engines` (if GTK2 applications are used) and `gnome-themes-standard`.
16
17- Requirements for Clearlooks-Phénix v2: packages `gtk2-engines` (if GTK2 applications are used), `gnome-themes-standard` and `gtk3-engines-unico`.
18
19- Requirements for Clearlooks-Phénix v3 and newer: package `gtk2-engines` (if GTK2 applications are used).
20
21## Installation
22
23- Download the appropriate version according to your situation:
24
25 - for GTK 3.0 and 3.2: [download Clearlooks-Phénix v1](https://github.com/jpfleury/clearlooks-phenix/archive/v1.zip);
26
27 - for GTK 3.4: [download Clearlooks-Phénix v2](https://github.com/jpfleury/clearlooks-phenix/archive/v2.zip);
28
29 - for GTK 3.6: [download Clearlooks-Phénix v3](https://github.com/jpfleury/clearlooks-phenix/archive/v3.zip);
30
31 - for GTK 3.8: [download Clearlooks-Phénix v4](https://github.com/jpfleury/clearlooks-phenix/archive/v4.zip);
32
33 - for GTK 3.10 and 3.12: [download Clearlooks-Phénix v5](https://github.com/jpfleury/clearlooks-phenix/archive/v5.zip);
34
35 - for GTK 3.14: [download Clearlooks-Phénix v6](https://github.com/jpfleury/clearlooks-phenix/archive/v6.zip);
36
37 - for GTK 3.20: [download Clearlooks-Phénix v7](https://github.com/jpfleury/clearlooks-phenix/archive/master.zip).
38
39 To find your GTK version:
40
41 - You can check in your package manager the version of the package `libgtk-3-0`.
42
43 - If you use Ubuntu, here's a correspondence between its versions and those of GTK (for a default installation of Ubuntu):
44
45 - Ubuntu 11.10: GTK 3.2
46 - Ubuntu 12.04: GTK 3.4
47 - Ubuntu 12.10 and 13.04: GTK 3.6
48 - Ubuntu 13.10: GTK 3.8
49 - Ubuntu 14.04: GTK 3.10
50 - Ubuntu 14.10: GTK 3.12
51 - Ubuntu 15.04: GTK 3.14
52 - Ubuntu 15.10: GTK 3.16
53 - Ubuntu 16.04: GTK 3.18
54 - Ubuntu 16.10: GTK 3.20
55
56- Extract the archive.
57
58- Rename the extracted folder to `Clearlooks-Phenix`.
59
60- Copy the folder `Clearlooks-Phenix` in one of the following two locations:
61
62 - `~/.themes/` for the current user;
63
64 - `/usr/share/themes/` for all users, including style for programs ran with root privileges (e.g. Synaptic).
65
66### Selection
67
68The theme must be selected once the installation is complete:
69
70- On Gnome: with [gnome-tweak-tool](https://live.gnome.org/GnomeTweakTool), by setting *Theme > Window theme* and *Theme > GTK+ theme*, or in a terminal:
71
72 dconf write /org/gnome/desktop/wm/preferences/theme \'Clearlooks-Phenix\'
73 dconf write /org/gnome/desktop/interface/gtk-theme \'Clearlooks-Phenix\'
74
75- On Xfce: by going to *Settings > Appearence > Style* in the main menu for the GTK theme, and to *Settings > Window Manager > Style* for the Xfwm4 theme, or in a terminal:
76
77 xfconf-query -s Clearlooks-Phenix -c xfwm4 -p /general/theme
78 xfconf-query -s Clearlooks-Phenix -c xsettings -p /Net/ThemeName
79
80## Configuration
81
82### Desktop managed by Nautilus
83
84By default, the font color on a desktop managed by Nautilus is black. To set it to white, open the file `gtk-3.0/applications.css` with a text editor, find the code relative to Nautilus:
85
86 /************
87 * Nautilus *
88 ************/
89
90 /*
91 COMMENTED
92 CSS
93 CODE
94 */
95
96and uncomment it, as follows:
97
98 /************
99 * Nautilus *
100 ************/
101
102 UNCOMMENTED
103 CSS
104 CODE
105
106To get a custom color, change the color directly in the file `gtk-3.0/applications.css`.
107
108### Window buttons layout
109
110If after installing or updating Ubuntu, the window buttons are on the left side, but you want them to the right, run the following command in a terminal:
111
112 gconftool-2 --set /apps/metacity/general/button_layout --type string ":minimize,maximize,close"
113
114### Wallpaper
115
116The wallpaper used for the Gnome 3 desktop screenshot is available in the folder `wallpapers`.
117
118### Icons
119
120The icon theme used for the same screenshot is Mist, installed with the package `gnome-themes`, under LGPL. However, this package is no longer available with last Ubuntu versions. Here's an easy way to install Mist:
121
122- [Download the archive of the Mist icon theme.](http://mirror.centos.org/centos/6/os/i386/Packages/gnome-themes-2.28.1-6.el6.noarch.rpm)
123
124- Extract the archive.
125
126- Copy the folder `usr/share/icons/Mist` in one of the following two locations:
127
128 - `~/.icons/` for the current user;
129
130 - `/usr/share/icons/` for all users.
131
132- Then, choose Mist:
133
134 - on Gnome: with gnome-tweak-tool by setting *Theme > Icon theme*;
135
136 - on Xfce: by going to *Settings > Appearence > Icons* in the main menu.
137
138## Development and license
139
140Git is used for revision control. [Repository can be browsed online or cloned.](https://github.com/jpfleury/clearlooks-phenix)
141
142Thanks to Andrew Shadura and Andrey Cherepanov for the support of GTK 3.20, and to Yuri Khan for the support of HiDPI.
143
144Author: Jean-Philippe Fleury (<http://www.jpfleury.net/en/contact.php>)
145Copyright © 2011-2014 Jean-Philippe Fleury
146Copyright © 2013-2014 Andrew Shadura
147
148This program is free software: you can redistribute it and/or modify
149it under the terms of the GNU General Public License as published by
150the Free Software Foundation, either version 3 of the License, or
151(at your option) any later version.
152
153This program is distributed in the hope that it will be useful,
154but WITHOUT ANY WARRANTY; without even the implied warranty of
155MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
156GNU General Public License for more details.
157
158You should have received a copy of the GNU General Public License
159along with this program. If not, see <http://www.gnu.org/licenses/>.
160
161### Third-party code
162
163- Adwaita theme, from the package [`gnome-themes-standard`](http://packages.ubuntu.com/search?keywords=gnome-themes-standard), under LGPL.
164
165- File `gtk-2.0/gtkrc`, from the package [`gtk2-engines`](http://packages.ubuntu.com/search?keywords=gtk2-engines), under LGPL.
166
167- File `metacity-1/metacity-theme-1.xml`, from the package [`gnome-themes-selected`](http://packages.ubuntu.com/search?keywords=gnome-themes-selected), under LGPL.
168
169- File `openbox-3/themerc`, from the package [`openbox`](http://packages.ubuntu.com/search?keywords=openbox), under GPL.
170
171- [Clearlooks XFWM4](http://xfce-look.org/content/show.php/Clearlooks+for+XFWM4?content=137055) theme, under GPL.
172
173- Files in `wallpapers`, based on an [image from volvoguy](http://gnome-look.org/content/show.php?content=22210), under GPL.
174
