INSTALL.md

                
                    
1
                    ## Installation from source
                
                    
2
                    
                
                    
3
                    ### Dependencies
                
                    
4
                    
                
                    
5
                    Materia requires the following build and runtime dependencies:
                
                    
6
                    
                
                    
7
                    - `meson` >= 0.47.0
                
                    
8
                    - `sassc`
                
                    
9
                    - `gnome-themes-extra` (or `gnome-themes-standard` for older distributions)
                
                    
10
                    - Murrine engine — The package name depends on the distro:
                
                    
11
                      - `gtk-engine-murrine` on Arch Linux
                
                    
12
                      - `gtk-murrine-engine` on Fedora
                
                    
13
                      - `gtk2-engine-murrine` on openSUSE
                
                    
14
                      - `gtk2-engines-murrine` on Debian, Ubuntu, etc.
                
                    
15
                    
                
                    
16
                    ### Steps to install
                
                    
17
                    
                
                    
18
                    1. Clone the repository and move into the project directory in terminal:
                
                    
19
                    
                
                    
20
                    ```sh
                
                    
21
                    git clone https://github.com/nana-4/materia-theme
                
                    
22
                    cd materia-theme
                
                    
23
                    ```
                
                    
24
                    
                
                    
25
                    2. Configure and install it using Meson:
                
                    
26
                    
                
                    
27
                    ```sh
                
                    
28
                    meson _build
                
                    
29
                    meson install -C _build
                
                    
30
                    ```
                
                    
31
                    
                
                    
32
                    ### Build options
                
                    
33
                    
                
                    
34
                    Option | Default Value | Description
                
                    
35
                    --- | --- | ---
                
                    
36
                    `prefix` | `/usr` | Installation prefix
                
                    
37
                    `colors` | `default,light,dark` | Choose color variant(s)
                
                    
38
                    `sizes` | `default,compact` | Choose size variant(s)
                
                    
39
                    `gnome_shell_version` | n/a (auto) | Manually set gnome-shell version
                
                    
40
                    `gtk4_version` | n/a (auto) | Manually set gtk4 version
                
                    
41
                    
                
                    
42
                    Build options can be set at the configuration time, for example:
                
                    
43
                    
                
                    
44
                    ```sh
                
                    
45
                    meson _build -Dprefix="$HOME/.local" -Dcolors=default,dark -Dsizes=compact
                
                    
46
                    ```
                
                    
47
                    
                
                    
48
                    ## Installation for older distributions
                
                    
49
                    
                
                    
50
                    If you can't use Meson `>= 0.47.0`, you can use `./install.sh` instead:
                
                    
51
                    
                
                    
52
                    ```sh
                
                    
53
                    sudo ./install.sh
                
                    
54
                    ```
                
                    
55
                    
                
                    
56
                    For installation options, run: `./install.sh --help`
                
                    
57
                    
                
                    
58
                    ## Uninstallation
                
                    
59
                    
                
                    
60
                    Delete the installed directories:
                
                    
61
                    
                
                    
62
                    ```sh
                
                    
63
                    sudo rm -rf /usr/share/themes/Materia{,-dark,-light}{,-compact}
                
                    
64
                    ```
                
                    
65