README.md

May 25, 2025 · View on GitHub

publish-release.yml

Overview

Clearlooks-Phénix

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.

Note: GTK was formerly known as GTK+.

Screenshots

Click to view full-size images:

Screenshot of GTK Widget Factory with the Clearlooks-Phénix theme

Screenshot of a GNOME 3 desktop (fallback mode) with the Clearlooks-Phénix theme

Screenshot of GIMP with the Clearlooks-Phénix theme

Screenshot of gedit 3 with the Clearlooks-Phénix theme

Requirements

  • Requirements for Clearlooks-Phénix v1: gnome-themes-standard.

  • Requirements for Clearlooks-Phénix v2: gnome-themes-standard and gtk3-engines-unico.

In all cases, the gtk2-engines package is also required if you're using GTK 2 applications.

Installation

Selection

The theme must be selected once the installation is complete:

  • On GNOME: with gnome-tweak-tool, by setting Theme > Window theme and Theme > GTK theme, or in a terminal:

      dconf write /org/gnome/desktop/wm/preferences/theme \'Clearlooks-Phenix\'
  dconf write /org/gnome/desktop/interface/gtk-theme \'Clearlooks-Phenix\'

  • 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:

      xfconf-query -s Clearlooks-Phenix -c xfwm4 -p /general/theme
  xfconf-query -s Clearlooks-Phenix -c xsettings -p /Net/ThemeName

  • Otherwise, set gtk-theme-name in $XDG_CONFIG_HOME/settings.ini (GTK 3) or ~/.gtkrc-2.0 (GTK 2).

Configuration

Desktop managed by Nautilus

By 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:

/************
 * Nautilus *
 ************/

/*
COMMENTED
CSS
CODE
*/

and uncomment it, as follows:

/************
 * Nautilus *
 ************/

UNCOMMENTED
CSS
CODE

To get a custom color, change the color directly in the file gtk-3.0/applications.css.

Window buttons layout

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:

gconftool-2 --set /apps/metacity/general/button_layout --type string ":minimize,maximize,close"

GTK 3 overlay scrollbars

A user has shared a method to disable GTK 3 overlay scrollbars system-wide, for those who prefer it. See issue #46.

⚠️ Not required or officially supported. Use at your own risk.

Wallpaper

The wallpaper used for the GNOME 3 desktop screenshot is available in the folder wallpapers.

Icons

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:

  • Download the latest available archive of the gnome-themes package.

  • Extract the archive.

  • Copy the folder usr/share/icons/Mist in one of the following locations:

    For the current user:

    • $XDG_DATA_HOME/icons/, or
    • ~/.icons/

    For all users:

    • /usr/share/icons/

  • Then, choose Mist:

    • on GNOME: with gnome-tweak-tool by setting Theme > Icon theme;

    • on Xfce: by going to Settings > Appearance > Icons in the main menu;

    • otherwise, set gtk-icon-theme-name in $XDG_CONFIG_HOME/settings.ini for GTK 3 or ~/.gtkrc-2.0 for GTK 2.

Development and license

Git is used for version control. The repository can be viewed online or cloned.

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.

Author: Jean-Philippe Fleury (https://github.com/jpfleury)
Copyright © 2011-2014, 2025 Jean-Philippe Fleury
Copyright © 2013-2014 Andrew Shadura

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Third-party code