add build system

1 files changed, 105 insertions, 2 deletions

diff --git a/README.md b/README.md
index cd256aa..d2d6d73 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,112 @@
 # Arc Theme
 
-Arc is a flat theme with transparent elements for GTK 3, GTK 2 and Gnome-Shell. Currently it only supports Gnome 3.16, but support for Gnome 3.14 will be added.
+Arc is a flat theme with transparent elements for GTK 3, GTK 2 and Gnome-Shell. It supports GTK 3 and GTK 2 based desktop environments like Gnome, Unity, Budgie, Pantheon, etc.
+
+### Requirements
+
+* Gnome/GTK 3.14 or 3.16
+* The `gtk2-engines-pixbuf` package only for Debian/Ubuntu based distros.
+* The murrine engine. This has different names depending on your distro.
+  * `gtk-engine-murrine` (Arch Linux)
+  * `gtk2-engines-murrine` (Debian, Ubuntu, elementary OS)
+  * `gtk-murrine-engine` (Fedora)
+  * `gtk2-engine-murrine` (openSUSE)
+  * `gtk-engines-murrine` (Gentoo)
+
+Main distributions that meet these requirements are
+
+* Arch Linux and Arch Linux based distros
+* Ubuntu 15.04
+* elementary OS Freya
+* Debian Jessie, Testing or Unstable
+* Gentoo
+* Fedora 21 and 22
+* OpenSuse 13.2 and Tumbleweed
+
+Derivatives of these distributions should work, aswell.
+
+If your distribution is not listed, please check the requirements yourself.
 
 ### Installation
-Copy the directory this README resides in to `/usr/share/themes` and apply the theme with `gnome-tweak-tool` or a similar program.
+
+**Important:** Remove all older versions of the theme from your system before you proceed any further.
+
+    sudo rm -rf /usr/share/themes/Arc
+    rm -rf ~/.local/share/themes/Arc
+    rm -rf ~/.themes/Arc
+
+**Manual Installation**
+
+To build the theme you need 
+* `autoconf`
+* `automake`
+* `pkg-config` or `pkgconfig` if you use Fedora
+* `libgtk-3-dev` for Debian based distros or `gtk3-devel` for RPM based distros
+* `git` if you want to clone the source directory
+
+If your distributions doesn't ship separate development packages you just need GTK 3 instead of the `-dev` packages.
+
+Install the theme with the following commands
+
+**1. Get the source**
+
+If you want to install the latest version from git, clone the repository with
+
+    git clone https://github.com/horst3180/arc-theme --depth 1 && cd arc-theme
+
+If you want to install the latest stable release, run
+
+    git clone https://github.com/horst3180/arc-theme --depth 1 && cd arc-theme
+    git fetch --tags
+    git checkout $(git describe --tags `git rev-list --tags --max-count=1`)
+
+or download it from https://github.com/horst3180/arc-theme/releases and cd into the extracted archive
+
+**2. Build and install the theme**
+
+    ./autogen.sh --prefix=/usr
+    sudo make install
+
+Other options to pass to autogen.sh are
+
+    --disable-gnome-shell      disable GNOME Shell support
+    --disable-gtk2             disable GTK2 support
+    --disable-gtk3             disable GTK3 support
+    --disable-metacity         disable Metacity support
+    --disable-unity            disable Unity support
+    --disable-xfwm             disable XFWM support
+
+    --with-gnome=<version>     build the theme for a specific Gnome version (3.14, 3.16)
+                               Note: Normally the correct version is detected automatically and this
+                               option should not be needed.
+
+After the installation is complete you can activate the theme with `gnome-tweak-tool` or a similar program by selecting `Arc`.
+
+**Uninstall the theme**
+
+Run
+
+    sudo make uninstall
+
+from the same directory as this README resides in, or
+
+    sudo rm -rf /usr/share/themes/Arc
+
+### Extras
+
+The `extra` directory in the same directory as this README resides in contains a Chrome/Chromium  theme.
+
+To install the Chrome/Chromium theme go to the `extra/Chrome` folder and drag and drop the arc-theme.crx into the Chrome/Chromium window. The source of the Chrome themes is located in the source "Chrome/arc-theme" folder.
+
+### Troubleshooting
+
+If you get artifacts like black or invisible backgrounds under Unity, disable overlay scrollbars with
+
+    gsettings set com.canonical.desktop.interface scrollbar-mode normal
+
+
+### Bug reporting
+If you find a bug, please report it at https://github.com/horst3180/arc-theme/issues
 
 ### Preview
 ![alt tag](http://i.imgur.com/B1oroyH.jpg)