This repository provides the templates and scripts used to build the Cinnamox Themes.
It also serves as a command line tool for end-users to make their own personalised theme.
Cinnamox themes include a Cinnamon, GTK2, GTK3, GTK3.20 and Metacity Theme, are compatible with Cinnamon 3.2+, GTK3.18 or GTK 3.20+ and require the
gtk-engine-murrine package to be installed.
The current release versions of the themes can be downloaded and installed via Cinnamon's Themes module in Cinnamon Settings or manually via Cinnamon Spices, openDesktop.org, or from this Github repository.
Thank-you to all the upstream developers for their time and effort in making these resources available.
The cinnamon theme includes in Cinnamox-gtk-theme is authored by me. A version has now been merged upstream to Oomox-gtk-theme and the Oomox app version 1.60+ has the option to build a cinnamon theme.
Cinnamox-gtk-theme has some cinnamox specific changes applied to the theme code so will produce a slightly different output to Oomox. Having said that improvements to either theme are often merged upstream / downstream.
On order to build themes using the tools in this repository you need to have these dependencies installed:
To build the GTK2 elements you need
Enter this command in a termimal to install the dependencies in an Arch based distro.
sudo pacman -S --needed bash grep sed bc glib2 gdk-pixbuf2 sassc gtk-engine-murrine gtk-engines librsvg
Ubuntu / Linux Mint
Enter this command in a termimal to install the dependencies in an Ubuntu based distro.
sudo apt install libgdk-pixbuf2.0-dev libxml2-utils gtk2-engines-murrine librsvg2-bin
libsass0>=3.4 are available in the Ubuntu repos for version 17.10 'artful' and later. Ubuntu 17.10+ and Linux Mint 19+ users can enter this command into a terminal to install.
sudo apt install sassc libsass0
Ubuntu 16.04 and Mint 18.x users can download the required
sassc deb packages appropriate for their architecture from the Ubuntu website. I have successfully installed the bionic versions available from the links below on a Linux Mint 18 AMD64 machine.
libsass0 should be installed first. Please disregard any warning about the
libsass0 version being newer than the xenial repo version.
Clone this repo
Once the dependencies are installed clone the repo. The command below will clone the repo to the home folder. The remaining instructions assume you have used this location
cd git clone https://github.com/smurphos/cinnamox-gtk-theme.git cd cinnamox-gtk-theme
Make and build your own theme
~/cinnamox-gtk-theme/colors/theme_templatein your preferred text editor. I recommend Geany as it includes a built in color wheel / picker utility which can assist in choosing colors.
Theme colors values are listed in this file in HEX format without the preceeding
#. E.g. the HEX for
#008000, would be entered as
Edit the theme colors as preferred. Please ensure the variable names are not changed and ensure not to include the # in the color values
Edit the other theme characteristics (name, roundness, gradient, opacity etc) taking note of the required or recommended range of values
Save the file into the colors directory with a new name - e.g
Open a terminal window and input this command
~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/excellent-themeto build your theme. Themes are built in
To ensure the theme applies to gui apps opened as root input this command
sudo ln -s ~/.themes/* /usr/share/themes/in a terminal window
Apply the theme using the Cinnamon Themes module in Cinnamon Settings to set your Windows Border theme, Controls theme, and Desktop theme to
Enjoy your new theme.
The repo includes example templates to build themes based on Linux Mint's Mint-X, Mint-Y and Mint-Y-Dark colours. To build these themes use one of the following commands.
Also included are three 'test' themes from Oomox.
Building the Cinnamox themes
Individual Cinnamox themes can be built using
~/cinnamox-gtk-theme/cinnamox_specific/cinnamox_gtk_picker.sh will launch an interactive bash script allowing you to build one or all of the Cinnamox themes including extras such as the transparency script.