|
1 | 1 | ## Overview
|
2 | 2 |
|
3 |
| -The 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. |
| 3 | + |
4 | 4 |
|
5 |
| -Here are screenshots (if applicable, click to see the original image): |
| 5 | +The Clearlooks-Phénix project aims to create a GTK 3 port of Clearlooks, the default theme for GNOME 2. Style is also included for GTK 2, Unity, and for the Metacity, Openbox, and Xfwm4 window managers. |
6 | 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> |
| 7 | +*Note: GTK was formerly known as GTK+.* |
8 | 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" /> |
| 9 | +### Screenshots |
10 | 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> |
| 11 | +Click to view full-size images, if applicable: |
| 12 | + |
| 13 | +<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="659" height="494"></a> |
| 14 | + |
| 15 | +<a href="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/gimp.png"><img src="https://raw.githubusercontent.com/jpfleury/clearlooks-phenix/master/doc/gimp.png" alt="Screenshot of GIMP with the Clearlooks-Phénix theme" width="659" height="358"></a> |
| 16 | + |
| 17 | +<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"> |
| 18 | + |
| 19 | +<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="659" height="444"></a> |
12 | 20 |
|
13 | 21 | ## Requirements
|
14 | 22 |
|
15 |
| -- Requirements for Clearlooks-Phénix v1: packages `gtk2-engines` (if GTK2 applications are used) and `gnome-themes-standard`. |
| 23 | +- Requirements for Clearlooks-Phénix v1: `gnome-themes-standard`. |
16 | 24 |
|
17 |
| -- Requirements for Clearlooks-Phénix v2: packages `gtk2-engines` (if GTK2 applications are used), `gnome-themes-standard` and `gtk3-engines-unico`. |
| 25 | +- Requirements for Clearlooks-Phénix v2: `gnome-themes-standard` and `gtk3-engines-unico`. |
18 | 26 |
|
19 |
| -- Requirements for Clearlooks-Phénix v3 and newer: package `gtk2-engines` (if GTK2 applications are used). |
| 27 | +In all cases, the `gtk2-engines` package is also required if you're using GTK 2 applications. |
20 | 28 |
|
21 | 29 | ## Installation
|
22 | 30 |
|
23 |
| -- Download the appropriate version according to your situation: |
| 31 | +- Download the appropriate version based on your GTK version: |
24 | 32 |
|
25 |
| - - for GTK 3.0 and 3.2: [download Clearlooks-Phénix v1](https://github.com/jpfleury/clearlooks-phenix/archive/v1.zip); |
| 33 | + - for GTK 3.0/3.2: [download Clearlooks-Phénix v1](https://github.com/jpfleury/clearlooks-phenix/archive/v1.zip); |
26 | 34 |
|
27 | 35 | - for GTK 3.4: [download Clearlooks-Phénix v2](https://github.com/jpfleury/clearlooks-phenix/archive/v2.zip);
|
28 | 36 |
|
29 | 37 | - for GTK 3.6: [download Clearlooks-Phénix v3](https://github.com/jpfleury/clearlooks-phenix/archive/v3.zip);
|
30 | 38 |
|
31 | 39 | - for GTK 3.8: [download Clearlooks-Phénix v4](https://github.com/jpfleury/clearlooks-phenix/archive/v4.zip);
|
32 | 40 |
|
33 |
| - - for GTK 3.10 and 3.12: [download Clearlooks-Phénix v5](https://github.com/jpfleury/clearlooks-phenix/archive/v5.zip); |
| 41 | + - for GTK 3.10/3.12: [download Clearlooks-Phénix v5](https://github.com/jpfleury/clearlooks-phenix/archive/v5.zip); |
34 | 42 |
|
35 |
| - - for GTK 3.14: [download Clearlooks-Phénix v6](https://github.com/jpfleury/clearlooks-phenix/archive/v6.zip); |
| 43 | + - for GTK 3.14/3.18: [download Clearlooks-Phénix v6](https://github.com/jpfleury/clearlooks-phenix/archive/v6.zip); |
36 | 44 |
|
37 |
| - - for GTK 3.20: [download Clearlooks-Phénix v7](https://github.com/jpfleury/clearlooks-phenix/archive/master.zip). |
| 45 | + - for GTK 3.20 and later: [download Clearlooks-Phénix v7](https://github.com/jpfleury/clearlooks-phenix/archive/master.zip). |
38 | 46 |
|
39 |
| - To find your GTK version: |
| 47 | + To check your GTK version, run `gtk-launch --version` in a terminal. |
40 | 48 |
|
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 |
| 49 | + You can also browse the [official releases](https://github.com/jpfleury/clearlooks-phenix/releases) for specific or older versions. |
55 | 50 |
|
56 | 51 | - Extract the archive.
|
57 | 52 |
|
58 | 53 | - Rename the extracted folder to `Clearlooks-Phenix`.
|
59 | 54 |
|
60 |
| -- Copy the folder `Clearlooks-Phenix` in one of the following two locations: |
| 55 | +- Copy the `Clearlooks-Phenix` folder into one of the following locations: |
| 56 | + |
| 57 | + For the current user: |
| 58 | + |
| 59 | + - [$XDG\_DATA\_HOME](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)`/themes`, or |
| 60 | + - `~/.themes/` |
61 | 61 |
|
62 |
| - - `~/.themes/` for the current user; |
| 62 | + For all users, including programs run with root privileges (e.g. your package-update utility): |
63 | 63 |
|
64 |
| - - `/usr/share/themes/` for all users, including style for programs ran with root privileges (e.g. Synaptic). |
| 64 | + - `/usr/share/themes/` |
65 | 65 |
|
66 | 66 | ### Selection
|
67 | 67 |
|
68 | 68 | The theme must be selected once the installation is complete:
|
69 | 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: |
| 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 | 71 |
|
72 | 72 | dconf write /org/gnome/desktop/wm/preferences/theme \'Clearlooks-Phenix\'
|
73 | 73 | dconf write /org/gnome/desktop/interface/gtk-theme \'Clearlooks-Phenix\'
|
74 | 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: |
| 75 | +- On Xfce: by going to *Settings > Appearance > Style* in the main menu for the GTK theme, and to *Settings > Window Manager > Style* for the Xfwm4 theme, or in a terminal: |
76 | 76 |
|
77 | 77 | xfconf-query -s Clearlooks-Phenix -c xfwm4 -p /general/theme
|
78 | 78 | xfconf-query -s Clearlooks-Phenix -c xsettings -p /Net/ThemeName
|
79 | 79 |
|
| 80 | +- Otherwise, set `gtk-theme-name` in `$XDG_CONFIG_HOME/settings.ini` (GTK 3) or `~/.gtkrc-2.0` (GTK 2). |
| 81 | + |
80 | 82 | ## Configuration
|
81 | 83 |
|
82 | 84 | ### Desktop managed by Nautilus
|
@@ -107,42 +109,56 @@ To get a custom color, change the color directly in the file `gtk-3.0/applicatio
|
107 | 109 |
|
108 | 110 | ### Window buttons layout
|
109 | 111 |
|
110 |
| -If 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: |
| 112 | +If, after installing or updating GNOME, the window buttons are on the left, and you'd prefer them on the right, run the following command in a terminal: |
111 | 113 |
|
112 | 114 | gconftool-2 --set /apps/metacity/general/button_layout --type string ":minimize,maximize,close"
|
113 | 115 |
|
| 116 | +### GTK 3 overlay scrollbars |
| 117 | + |
| 118 | +A user has shared a method to disable GTK 3 overlay scrollbars system-wide, for those who prefer it. See [issue #46](https://github.com/jpfleury/clearlooks-phenix/issues/46). |
| 119 | + |
| 120 | +⚠️ Not required or officially supported. Use at your own risk. |
| 121 | + |
114 | 122 | ### Wallpaper
|
115 | 123 |
|
116 |
| -The wallpaper used for the Gnome 3 desktop screenshot is available in the folder `wallpapers`. |
| 124 | +The wallpaper used for the GNOME 3 desktop screenshot is available in the folder `wallpapers`. |
117 | 125 |
|
118 | 126 | ### Icons
|
119 | 127 |
|
120 |
| -The 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: |
| 128 | +The icon theme used in the same screenshot is Mist, which was included in the `gnome-themes` package, licensed under the LGPL. However, this package is no longer available. Here's how to manually install the Mist icon theme: |
121 | 129 |
|
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) |
| 130 | +- [Download the latest available archive of the `gnome-themes` package.](https://snapshot.debian.org/archive/debian-ports/20091029T000000Z/pool/main/g/gnome-themes/gnome-themes_2.28.1-1_all.deb) |
123 | 131 |
|
124 | 132 | - Extract the archive.
|
125 | 133 |
|
126 |
| -- Copy the folder `usr/share/icons/Mist` in one of the following two locations: |
| 134 | +- Copy the folder `usr/share/icons/Mist` in one of the following locations: |
127 | 135 |
|
128 |
| - - `~/.icons/` for the current user; |
| 136 | + For the current user: |
129 | 137 |
|
130 |
| - - `/usr/share/icons/` for all users. |
| 138 | + - `$XDG_DATA_HOME/icons/`, or |
| 139 | + - `~/.icons/` |
| 140 | + |
| 141 | + For all users: |
| 142 | + |
| 143 | + - `/usr/share/icons/` |
131 | 144 |
|
132 | 145 | - Then, choose Mist:
|
133 | 146 |
|
134 |
| - - on Gnome: with gnome-tweak-tool by setting *Theme > Icon theme*; |
| 147 | + - on GNOME: with gnome-tweak-tool by setting *Theme > Icon theme*; |
135 | 148 |
|
136 |
| - - on Xfce: by going to *Settings > Appearence > Icons* in the main menu. |
| 149 | + - on Xfce: by going to *Settings > Appearance > Icons* in the main menu; |
| 150 | + |
| 151 | + - otherwise, set `gtk-icon-theme-name` in `$XDG_CONFIG_HOME/settings.ini` |
| 152 | + for GTK 3 or ~/.gtkrc-2.0 for GTK 2. |
137 | 153 |
|
138 | 154 | ## Development and license
|
139 | 155 |
|
140 |
| -Git is used for revision control. [Repository can be browsed online or cloned.](https://github.com/jpfleury/clearlooks-phenix) |
| 156 | +Git is used for version control. [The repository can be viewed online or cloned.](https://github.com/jpfleury/clearlooks-phenix) |
141 | 157 |
|
142 |
| -Thanks to Andrew Shadura and Andrey Cherepanov for the support of GTK 3.20, and to Yuri Khan for the support of HiDPI. |
| 158 | +Thanks to Yuri Khan for HiDPI support, and to Andrew Shadura, Andrey Cherepanov, jsane-h8ms, and others for their contributions to GTK 3.20+ support. |
143 | 159 |
|
144 |
| -Author: Jean-Philippe Fleury (<http://www.jpfleury.net/en/contact.php>) |
145 |
| -Copyright © 2011-2014 Jean-Philippe Fleury |
| 160 | +Author: Jean-Philippe Fleury (<https://github.com/jpfleury>) |
| 161 | +Copyright © 2011-2014, 2025 Jean-Philippe Fleury |
146 | 162 | Copyright © 2013-2014 Andrew Shadura
|
147 | 163 |
|
148 | 164 | This program is free software: you can redistribute it and/or modify
|
|
0 commit comments