Arc-39-theme/README.md

151 lines
6.3 KiB
Markdown
Raw Normal View History

2015-05-17 13:21:20 +02:00
# Arc Theme
2015-12-08 14:37:25 +01:00
Arc is a flat theme with transparent elements for GTK 3, GTK 2 and Gnome-Shell which supports GTK 3 and GTK 2 based desktop environments like Gnome, Unity, Budgie, Pantheon, XFCE, Mate, etc.
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
## Arc is available in three variants
2015-07-11 19:32:05 +02:00
2016-11-07 22:59:30 +01:00
##### Arc
2015-07-11 19:32:05 +02:00
![A screenshot of the Arc theme](http://i.imgur.com/Ph5ObOa.png)
2015-07-11 19:32:05 +02:00
2016-11-07 22:59:30 +01:00
##### Arc-Darker
2015-07-11 19:32:05 +02:00
![A screenshot of the Arc-Darker theme](http://i.imgur.com/NC6dqyl.png)
2015-07-11 19:32:05 +02:00
2016-11-07 22:59:30 +01:00
##### Arc-Dark
2015-07-11 19:32:05 +02:00
![A screenshot of the Arc-Dark theme](http://i.imgur.com/5AGlCnA.png)
2015-07-11 19:32:05 +02:00
2016-11-07 22:59:30 +01:00
## Installation
2015-07-11 19:32:05 +02:00
2016-11-07 22:59:30 +01:00
### Packages
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
|Distro|Package Name/Link|
|:----:|:----:|
| Arch Linux | `arc-gtk-theme`, [`arc-gtk-theme-git`](https://aur.archlinux.org/packages/gtk-theme-arc-git) (AUR) |
| Debian 8 | [OBS Repo](http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme) |
| Debian Testing/Unstable | `arc-theme` |
| Fedora | [OBS Repo](http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme) |
| Gentoo/Funtoo | `x11-themes/arc-theme` from the [Scriptkitties Overlay][sk-overlay] |
| Open SUSE | [OBS Repo](http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme) |
| Solus | `arc-gtk-theme` |
| Ubuntu 15.04 - 16.04 | [OBS Repo](http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme) |
| Ubuntu 16.10 | `arc-theme` |
2015-06-06 00:18:46 +02:00
2016-11-07 22:59:30 +01:00
**elementary OS Note:** elementary OS Freya users can install the package for Ubuntu 15.04, Loki user can install the package for Ubuntu 16.04
2015-06-06 00:18:46 +02:00
2015-09-29 16:39:07 +02:00
--
2015-06-06 00:18:46 +02:00
2016-11-07 22:59:30 +01:00
**AUR Note:** If you're having trouble with the AUR packages please email the package maintainer at zach@zach-adams.com before creating an issue.
2016-09-09 20:10:39 +02:00
--
2016-11-07 22:59:30 +01:00
A non-transparent version of the theme is available here: [Arc Solid OBS repo](http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme-solid)
2016-09-20 13:05:10 +02:00
2016-11-07 22:59:30 +01:00
### Manual Installation
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
To build the theme the follwing packages are required
2015-05-28 17:41:22 +02:00
* `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
2016-11-07 22:59:30 +01:00
**Note:** If your distribution doesn't ship separate development packages you just need GTK 3 instead of the `-dev` packages.
For the theme to function properly, install the following
* Gnome Shell, GTK 3.14 - 3.22
* The `gnome-themes-standard` package
* 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)
2015-05-28 17:41:22 +02:00
Install the theme with the following commands
2016-11-07 22:59:30 +01:00
#### 1. Get the source
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
Clone the git repository with
2015-05-28 17:41:22 +02:00
git clone https://github.com/horst3180/arc-theme --depth 1 && cd arc-theme
2016-11-07 22:59:30 +01:00
#### 2. Build and install the theme
2015-05-28 17:41:22 +02:00
./autogen.sh --prefix=/usr
sudo make install
Other options to pass to autogen.sh are
2015-07-10 16:53:14 +02:00
--disable-transparency disable transparency in the GTK3 theme
--disable-light disable Arc Light support
--disable-darker disable Arc Darker support
--disable-dark disable Arc Dark support
2015-08-17 23:08:23 +02:00
--disable-cinnamon disable Cinnamon support
2015-05-28 17:41:22 +02:00
--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
2016-03-23 22:14:40 +01:00
--with-gnome=<version> build the theme for a specific Gnome version (3.14, 3.16, 3.18, 3.20)
2015-05-28 17:41:22 +02:00
Note: Normally the correct version is detected automatically and this
option should not be needed.
2016-11-07 22:59:30 +01:00
After the installation is complete you can activate the theme with `gnome-tweak-tool` or a similar program by selecting `Arc`, `Arc-Darker` or `Arc-Dark` as Window/GTK+ theme and `Arc` or `Arc-Dark` as Gnome Shell/Cinnamon theme.
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
## Uninstall
2015-05-28 17:41:22 +02:00
Run
sudo make uninstall
2016-11-07 22:59:30 +01:00
from the cloned git repository, or
2015-05-28 17:41:22 +02:00
2015-07-10 16:53:14 +02:00
sudo rm -rf /usr/share/themes/{Arc,Arc-Darker,Arc-Dark}
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
## Extras
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
### Arc Firefox theme
2015-08-19 20:03:36 +02:00
A theme for Firefox is available at https://github.com/horst3180/arc-firefox-theme
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
### Arc icon theme
2016-06-06 21:00:25 +02:00
The Arc icon theme is available at https://github.com/horst3180/arc-icon-theme
2016-11-07 22:59:30 +01:00
### Chrome/Chromium theme
2015-07-11 19:32:05 +02:00
To install the Chrome/Chromium theme go to the `extra/Chrome` folder and drag and drop the arc-theme.crx or arc-dark-theme.crx file into the Chrome/Chromium window. The source of the Chrome themes is located in the source "Chrome/arc-theme" folder.
2015-05-28 17:41:22 +02:00
2016-11-07 22:59:30 +01:00
### Plank theme
2015-06-13 18:38:30 +02:00
To install the Plank theme, copy the `extra/Arc-Plank` folder to `~/.local/share/plank/themes` or to `/usr/share/plank/themes` for system-wide use.
Now open the Plank preferences window by executing `plank --preferences` from a terminal and select `Arc-Plank` as the theme.
2016-11-07 22:59:30 +01:00
### Arc-Dark for Ubuntu Software Center
2016-05-17 20:05:54 +02:00
The Arc Dark theme for the Ubuntu Software Center by [mervick](https://github.com/mervick) can be installed from [here](https://github.com/mervick/arc-dark-software-center). It solves readability issues with Arc Dark and the Ubuntu Software Center.
2016-11-07 22:59:30 +01:00
## Troubleshooting
2015-05-28 17:41:22 +02:00
2015-12-08 14:37:25 +01:00
If you have Ubuntu with a newer GTK/Gnome version than the one included by default (i.e Ubuntu 14.04 with GTK 3.14 or Ubuntu 15.04 with GTK 3.16, etc.) the prebuilt packages won't work properly and you have to install the theme manually as described above.
2015-09-29 16:39:07 +02:00
This is also true for other distros with a different GTK/Gnome version than the one included by default
--
2015-05-28 17:41:22 +02:00
If you get artifacts like black or invisible backgrounds under Unity, disable overlay scrollbars with
gsettings set com.canonical.desktop.interface scrollbar-mode normal
2016-11-07 22:59:30 +01:00
## Bugs
2015-05-28 17:41:22 +02:00
If you find a bug, please report it at https://github.com/horst3180/arc-theme/issues
2015-05-17 13:21:20 +02:00
2016-11-07 22:59:30 +01:00
## License
Arc is available under the terms of the GPL-3.0. See `COPYING` for details.
2016-07-30 14:31:07 +02:00
2016-11-07 22:59:30 +01:00
## Full Preview
![A full screenshot of the Arc theme](http://i.imgur.com/tD1OBQ3.png)
2016-06-05 16:08:52 +02:00
<sub>Screenshot Details: Icons: [Arc](https://github.com/horst3180/arc-icon-theme) | Launcher Icons based on [White Pixel Icons](http://darkdawg.deviantart.com/art/White-Pixel-Icons-252310560) | [Wallpaper](https://pixabay.com/photo-869593/) | Font: Futura Bk bt</sub>
2016-09-09 20:10:39 +02:00
[sk-overlay]: https://c.darenet.org/scriptkitties/overlay