Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
lassekongo83 committed Dec 17, 2018
1 parent f6d1b0c commit 140bde6
Showing 1 changed file with 27 additions and 26 deletions.
53 changes: 27 additions & 26 deletions README.md
@@ -1,12 +1,10 @@
## Amber Theme

A theme for GNOME and Xfce4.

![Amber theme](images/amber2.png?raw=true)
<sub>Screenshot Details: [Wallpaper](https://i.imgur.com/U8r1J84.png) by [Tom Haugomat](https://www.handsomefrank.com/illustrators/tom-haugomat) | [Icons](https://github.com/numixproject/numix-icon-theme-circle) | GNOME shell extension: Dash to dock</sub>

### Requirements

GTK 3.22+

* The murrine engine
Expand All @@ -20,7 +18,6 @@ GTK 3.22+
* `gtk-engines` (Arch, Manjaro, Antergos)

#### Optional recommended requirements

* Ubuntu fonts (For the GNOME shell theme.)
* `ttf-ubuntu-font-family`

Expand All @@ -34,21 +31,28 @@ GTK 3.22+
### How to install

#### Option 1: Running install.sh

Make sure you have `wget` **or** `git` installed.

1. `mkdir -p ~/.themes/Amber && cd ~/.themes/Amber`
2. Download the theme
* with wget: `wget https://github.com/lassekongo83/amber-theme/archive/master.zip`
* `unzip master.zip`
* or with git: `git clone https://github.com/lassekongo83/amber-theme.git`
3. `sh amber-theme/install.sh`
4. `rm -r amber-theme`
**With wget:**
```bash
mkdir -p ~/.themes/Amber && cd ~/.themes/Amber
wget https://github.com/lassekongo83/amber-theme/archive/master.zip
unzip master.zip
sh amber-theme/install.sh
rm -r amber-theme
```

**With git:**
```bash
mkdir -p ~/.themes/Amber && cd ~/.themes/Amber
git clone https://github.com/lassekongo83/amber-theme.git
sh amber-theme/install.sh
rm -r amber-theme
```

The install script will detect if you are running GNOME or Xfwm4 and exclude the `gnome-shell` or `xfwm4` folder depending on which wm you're using. It will exclude both if you don't use either.

#### Option 2: Graphical user interface

1. Download the theme: https://github.com/lassekongo83/amber-theme/archive/master.zip
2. Create the folder `~/.themes/Amber`
3. Open the `master.zip` file and navigate to the `src` folder.
Expand All @@ -59,20 +63,18 @@ The install script will detect if you are running GNOME or Xfwm4 and exclude the
Note: This option will not provide you with an `index.theme` file. It's not a necessary file, but some users may need it. Unecessary source files will also be kept. If you need an `index.theme` file you can run the `create-tarball.sh` script in `src` and extract the content of the created tarball to `~/.themes/Amber`.

#### Option 3: meson

This installation method is to try out the theme while developing it.

Make sure you have `git`, `meson`, [ninja](https://github.com/ninja-build/ninja/wiki/Pre-built-Ninja-packages), and `sassc` installed.

1. `git clone https://github.com/lassekongo83/amber-theme.git`
2. `cd amber-theme`
3. `meson build`
4. `sudo ninja -C build install`

```bash
git clone https://github.com/lassekongo83/amber-theme.git
cd amber-theme
meson build
sudo ninja -C build install
```
The theme will be installed in: `/usr/share/themes/Amber`

### Using the theme

Using `gnome-tweaks`. (Make sure you have `gnome-shell-extensions` installed.)

1. Go to Extensions and activate `User themes`. (You may have to restart `gnome-tweaks` after doing that for the option to swap shell theme to be available in the next step.)
Expand All @@ -83,26 +85,25 @@ Using `dconf-editor`. (Make sure you have `gnome-shell-extensions` installed and
1. To change the GTK theme: `gsettings set org.gnome.desktop.interface gtk-theme Amber`
2. To change the GNOME shell theme: `gsettings set org.gnome.shell.extensions.user-theme name 'Amber'`

If you want to change back to the default GNOME theme run: `gsettings set org.gnome.desktop.interface gtk-theme Adwaita` and `gsettings set org.gnome.shell.extensions.user-theme name ''`

If you want to change back to the default GNOME theme run:
```bash
gsettings set org.gnome.desktop.interface gtk-theme Adwaita
gsettings set org.gnome.shell.extensions.user-theme name ''
```
A shell restart may be needed after swapping themes. <kbd>Alt</kbd> + <kbd>F2</kbd> and running <kbd>r</kbd> as command.

Xfce users can change themes in `Settings > Appearance` and `Settings > Window manager`.

### Known issues

None of these steps below are required.

#### Ubuntu Dock double indicators

The default dock in Ubuntu will give you double indicators. These can't be removed with a theme, so some manual intervention is required.

One way around this is to install the original [Dash to Dock](https://extensions.gnome.org/extension/307/dash-to-dock/) and disable it, then change its settings using `dconf-editor` at `(org / gnome / shell / extensions / dash-to-dock / running-indicator-style)` - changing its settings should affect not only the original Dash to Dock, but also Ubuntu Dock. Another way is to remove or disable the Ubuntu Dock and use the original Dash to Dock, which is much more customizable.

#### Ubuntu dynamic panel opacity

Ubuntu changes the opacity of the panel when you maximize applications. The opacity overrides some of the default theme settings. [Here are some ways](https://askubuntu.com/questions/1012328/how-to-disable-the-dynamic-transparency-effect-of-the-dock-while-maximizing-a-wi/1012331#1012331) you can disable or modify it.

#### Left aligned maximize buttons

Left aligned maximize buttons in the titlebar will swap appearance on normal GNOME applications using client side decorations (csd). Applications that don't use csd (gnome-terminal for example) will use the right aligned appearance, even if it's left aligned. Just a minor inconsistency.

0 comments on commit 140bde6

Please sign in to comment.