Skip to content
This repository has been archived by the owner. It is now read-only.
A highly customizable chameleon theme for Gnome Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
modules Set the theme when running apply Dec 26, 2013
presets Tweaked presets to not use gradient and shadows together Mar 30, 2014
templates Optimized SVG resources Nov 15, 2014
.gitignore Updated presets May 27, 2013
Makefile Tweaked Makefile Dec 3, 2013 Mention elegance-colors-prefs Apr 1, 2014
elegance-colors switched bc with awk- hence removing the bc dep Feb 28, 2015
elegance-colors-prefs.desktop Fix issues with desktop file. Fixes #13 Jul 4, 2013
elegance-colors.appdata.xml Added appdata Dec 3, 2013
elegance-colors.desktop Fix issues with desktop file. Fixes #13 Jul 4, 2013
elegance-colors.svg Optimize files Mar 27, 2014
screenshot.png Added screenshot Dec 3, 2013


Elegance Colors is a highly customizable chameleon theme for Gnome Shell. It can change colors according to the current GTK theme, current wallpaper (uses imagemagick to get color) or use a user defined color.


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

Copyright (C) Satyajit Sahoo


Ubuntu users can install Elegance Colors from our themes PPA using the following commands,

sudo add-apt-repository ppa:satyajit-happy/themes
sudo apt-get update && sudo apt-get install gnome-shell-theme-elegance-colors

Fedora and OpenSUSE users can add the appropriate repo from opensuse build service and install the package gnome-shell-theme-elegance-colors via the distro's package manager.

Arch Linux users can install Elegance Colors from aur.

If you use another distro, you need to compile from source. This is needed for the GUI.

Don't worry, it is easy and straight forward.

You need to install the build-dependencies first (package names may vary depending on your distro),

glib2-devel gtk3-devel vala

Extract the archive, navigate to the directory and type the following commands in a terminal,

make sudo make install

To derive color from wallpaper, you need to install ImageMagick

Also install the User Theme Extension for Gnome Shell.


A process runs in background which detects changes, generates the theme and reloads the theme accordingly. After installation, you must run the following command to start the background process,


To set the theme, choose the theme via Gnome Tweak Tool or run the following commands,

gsettings set name 'elegance-colors'

You can launch the GUI from the menu which lets you customise various aspects of the the theme. You can also export your customized theme, import/export settings from the GMenu. Click on the title in the Gnome Shell top bar to get the GMenu. You can also launch the GUI by running:


Advanced configuration

Apart from the included presets, Elegance Colors supports user presets installed under ~/.config/elegance-colors/presets/

To create a preset, just export your customized settings from the GMenu and give it a name by editing the exported file and adding the following at the beginning,

# Name: Your Awesome Name

You can also change the settings by editing the file ~/.config/elegance-colors.ini instead of using the GUI. It also gives more power to you by enabling you to use symbolic colors.

For example, you can use,


Where @mode is the color derived from the wallpaper, GTK theme or a custom color.

There are 3 methods for manipulating colors, alpha - for making a color translucent, shade - to darken or lighten a color, tint - to mix a color with another.

For example, you can use,


It takes the symbolic color @mode, and darkens it by "10". You can have a look at the included presets to have more understanding.

If you want even more customization, you can include single line custom CSS code,

For example,


If that's not enough, you can also include a custom CSS file to override the values in the default template.

To include a custom CSS file, create a directory under ~/.config/elegance-colors/presets/ and put all required files there. Then list the files to be included in the configuration file,

For example,



It is recommended to stop any previous instances of elegance-colors when updating to a new version. You can stop the running process of elegance-colors with the command,

elegance-colors stop

To view any error messages produced, run the process in Terminal,

elegance-colors start

To manually apply changes, run,

elegance-colors apply

If your theme fails to apply after an upgrade, it is likely that the config file doesn't include new options. To update the config file, run,

elegance-colors update

To export the theme, run,

elegance-colors export /path/to/

Getting the source

You can get the latest source code from the GitHub page.

git clone

Bugs and feature requests

Please submit bugs and feature requests here.

You can’t perform that action at this time.