Cinnamox-gtk-theme

Introduction

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 gtk2-engines-murrine or 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.

Credits

Cinnamox-gtk-theme is a fork of Oomox-gtk-theme used in the excellent Oomox GUI theme making app.

Oomox-gtk-theme is in turn a fork of the famous Numix-gtk-theme.

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.

Cinnamon-gtk-theme also includes the theme definitions and helper scripts used to build the Cinnamox Themes. Please note that the theme definitions in Cinnamox-gtk-theme are not compatible with Oomox

Instructions

Prerequisites

On order to build themes using the tools in this repository you need to have these dependencies installed:

• glib-compile-schemas
• gdk-pixbuf-pixdata
• sassc>=3.4
• libsass0>=3.4
• gtk3>=3.18

To build the GTK2 elements you need gtk2-engines-murrine or gtk-engine-murrine

Arch Linux

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

sassc>=3.4 & 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 libsass0 and 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.

bionic libsass0

bionic sassc

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

1. Open ~/cinnamox-gtk-theme/colors/theme_template in your preferred text editor. I recommend Geany as it includes a built in color wheel / picker utility which can assist in choosing colors.

2. Theme colors values are listed in this file in HEX format without the preceeding #. E.g. the HEX for green, #008000, would be entered as 008000

3. Edit the theme colors as preferred. Please ensure the variable names are not changed and ensure not to include the # in the color values

4. Edit the other theme characteristics (name, roundness, gradient, opacity etc) taking note of the required or recommended range of values

5. Save the file into the colors directory with a new name - e.g ~/cinnamox-gtk-theme/colors/excellent-theme

6. Open a terminal window and input this command ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/excellent-theme to build your theme. Themes are built in ~/.themes

7. 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

8. Apply the theme using the Cinnamon Themes module in Cinnamon Settings to set your Windows Border theme, Controls theme, and Desktop theme to cinnamox-excellent-theme

9. Enjoy your new theme.

Example templates

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.

• Mint-X ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/mint_themes/Mint-X
• Mint-Y ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/mint_themes/Mint-Y
• Mint-Y-Dark ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/mint_themes/Mint-Y-Dark

Also included are three 'test' themes from Oomox.

• Clearlooks ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/oomox/clearlooks
• Lavender ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/oomox/lavender
• Monovedek_lcars ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/oomox/monovedek_lcars

Building the Cinnamox themes

Individual Cinnamox themes can be built using

• ~/cinnamox-gtk-theme/change_color.sh ~/cinnamox-gtk-theme/colors/cinnamox/<themename>

Alternatively ~/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.

Screenshots

Cinnamox-Kashir-Blue release screenshot

Cinnamox-Kashir-Blue GTK test result screenshots