numix-gtk-theme/README.md

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

Install It

Official Distro Packages

Distro Install Command/Links
arch antergos sudo pacman -S numix-themes
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.

To install Sass, install Ruby and the gem command using your distribution's package manager. Then install sass with the gem command,

gem install sass

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.

Debian, Ubuntu

sudo apt-get install libglib2.0-dev libgdk-pixbuf2.0-dev libxml2-utils

Fedora

sudo dnf install glib2-devel gdk-pixbuf2-devel

Arch Linux

sudo pacman -S glib2 gdk-pixbuf2

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

make
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"

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+