aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 1beba167f5c8cff8fa14d7898b340a9cb715a463 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
## Librix

Based in [Numix](https://github.com/numixproject/numix-gtk-theme)

##### A modern flat theme with dark elements. It supports GNOME, Unity, Xfce and Openbox.
![Supports GTK+ 3.18](https://img.shields.io/badge/GTK%2B-3.18-4a90d9.svg?style=flat-square)  ![Supports GTK+ 3.24](https://img.shields.io/badge/GTK%2B-3.24-4a90d9.svg?style=flat-square)

## Build It

First, you need to compile the theme using the [Sass](http://sass-lang.com/) 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` (not needed for Ubuntu/Debian)

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|
|:----:|:----:|
|![hyperbola][hyperbola]  ![parabola][parabola]  ![arch][arch]|`sudo pacman -S ruby glib2 gdk-pixbuf2`|
|![opensuse][opensuse]|`sudo zypper install glib2-devel gdk-pixbuf-devel`|
|![fedora][fedora]|`sudo dnf install glib2-devel gdk-pixbuf2-devel`|
|![trisquel][trisquel]  ![debian][debian]  ![ubuntu][ubuntu]|`sudo apt-get install ruby-sass 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,

```sh
make zip
```

or for install in global system:

```sh
sudo make install
```

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

```sh
gsettings set org.gnome.desktop.interface gtk-theme "Librix"
gsettings set org.gnome.desktop.wm.preferences theme "Librix"
```

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

```sh
xfconf-query -c xsettings -p /Net/ThemeName -s "Librix"
xfconf-query -c xfwm4 -p /general/theme -s "Librix"
```

In Openbox you can set the theme with [ObConf](http://openbox.org/wiki/ObConf:About) tool. Alternatively, you can set the theme by changing the `<name> `key value to `Librix` in the `<theme>` section of your rc.xml file.

#### 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,

```sh
make watch
```

If you change any assets, you'll need to regenerate the `gtk.gresource.xml` and `gtk.gresource` files. You can use [grrr](https://github.com/satya164/grrr) to do it easily.

### Requirements

GTK+ 3.18 or above

Murrine theme engine

### Code and license

Report bugs or contribute at [LibreGit](https://libregit.org/heckyel/librix)

License: GPL-3.0+

[hyperbola]: https://archive.org/download/libreweb/hyperbola.png "Hyperbola"
[parabola]: https://archive.org/download/libreweb/parabola.png "Parabola"
[arch]: https://archive.org/download/libreweb/arch.png "Arch"
[fedora]: https://archive.org/download/libreweb/fedora.png "Fedora"
[openSUSE]: https://archive.org/download/libreweb/opensuse.png "openSUSE"
[trisquel]: https://archive.org/download/libreweb/trisquel.png "Trisquel"
[ubuntu]: https://archive.org/download/libreweb/ubuntu.png "Ubuntu"
[debian]: https://archive.org/download/libreweb/debian.png "Debian"