numix-gtk-theme/README.md

4.0 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

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.

Distro Commands
arch  antergos sudo pacman -S glib2 gdk-pixbuf2
opensuse sudo zipper install glib2-devel gdk-pixbuf-devel
fedora sudo dnf install glib2-devel gdk-pixbuf2-devel
debian  ubuntu sudo apt-get install 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"

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+