numix-gtk-theme/README.md

4.1 KiB

Numix

A modern flat theme with a combination of light and dark elements. It supports GNOME, Unity, Xfce and Openbox.

By The Numix Project  Circle CI  GitHub release  Supports GTK+ 3.18  Supports GTK+ 3.24

Install It

Distro Packages

Distro Install Command/Links
arch  antergos sudo pacman -S numix-gtk-theme
opensuse 1 Click Install  |  OBS Repo
fedora sudo dnf install numix-gtk-theme
debian  ubuntu sudo apt install numix-gtk-theme

Build It

First, you need to compile the theme using the Sass compiler.

You will need to install SassC (sassc) which is likely to be available as a package in your distribution's software repositories.

You'll also need the glib-compile-schemas and gdk-pixbuf-pixdata commands in your path to generate the gresource binary. Install them using your distribution's package manager.

Distro Commands
arch  antergos sudo pacman -S sassc glib2 gdk-pixbuf2
opensuse sudo zypper install sassc glib2-devel gdk-pixbuf-devel
fedora sudo dnf install sassc glib2-devel gdk-pixbuf2-devel
debian  ubuntu sudo apt-get install sassc libglib2.0-dev libgdk-pixbuf2.0-dev libxml2-utils

After installing all the dependencies, change to the cloned directory and, run the following in Terminal,

sudo make install

To set the theme in GNOME, run the following commands in Terminal,

gsettings set org.gnome.desktop.interface gtk-theme "Numix"
gsettings set org.gnome.desktop.wm.preferences theme "Numix"

To set the theme in Xfce, run the following commands in Terminal,

xfconf-query -c xsettings -p /Net/ThemeName -s "Numix"
xfconf-query -c xfwm4 -p /general/theme -s "Numix"

In Openbox you can set the theme with ObConf tool. Alternatively, you can set the theme by changing the <name> key value to Numix in the <theme> section of your rc.xml file.

For contributors

Start by reviewing the guidelines for contributing.

For developers

If you want to hack on the theme, make sure you have the inotifywait command available, which is used for watching and automatically building the files.

To start watching for changes, run the following,

make watch

If you change any assets, you'll need to regenerate the gtk.gresource.xml and gtk.gresource files. You can use grrr to do it easily.

Requirements

GTK+ 3.18 or above

Murrine theme engine

Code and license

Report bugs or contribute at GitHub

License: GPL-3.0+