You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
horst3180_arc-theme/README.md

157 lines
6.6 KiB

9 years ago
# Arc Theme
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.
9 years ago
8 years ago
## Arc is available in three variants
9 years ago
8 years ago
##### Arc
9 years ago
![A screenshot of the Arc theme](http://i.imgur.com/Ph5ObOa.png)
9 years ago
8 years ago
##### Arc-Darker
9 years ago
![A screenshot of the Arc-Darker theme](http://i.imgur.com/NC6dqyl.png)
9 years ago
8 years ago
##### Arc-Dark
9 years ago
![A screenshot of the Arc-Dark theme](http://i.imgur.com/5AGlCnA.png)
9 years ago
8 years ago
## Installation
9 years ago
8 years ago
### Packages
9 years ago
8 years ago
|Distro|Package Name/Link|
|:----:|:----:|
| Arch Linux | `arc-gtk-theme`, [`gtk-theme-arc-git`](https://aur.archlinux.org/packages/gtk-theme-arc-git) (AUR) |
8 years ago
| Debian 8 | [OBS Repo][obs-repo] |
8 years ago
| Debian Testing/Unstable | `arc-theme` |
7 years ago
| Fedora 21 - 23 | [OBS Repo][obs-repo] |
| Fedora 24 -25 | `arc-theme` |
8 years ago
| Gentoo/Funtoo | `x11-themes/arc-theme` from the [Scriptkitties Overlay][sk-overlay] |
| openSUSE | [OBS Repo][obs-repo] |
8 years ago
| Solus | `arc-gtk-theme` |
8 years ago
| Ubuntu 15.04 - 16.04 | [OBS Repo][obs-repo] |
8 years ago
| Ubuntu 16.10 | `arc-theme` |
9 years ago
8 years ago
**elementary OS Note:** elementary OS Freya users can install the package for Ubuntu 15.04, Loki users can install the package for Ubuntu 16.04.
9 years ago
8 years ago
**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.
8 years ago
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)
8 years ago
8 years ago
--
8 years ago
### Manual Installation
9 years ago
8 years ago
To build the theme the follwing packages are required
9 years ago
* `autoconf`
* `automake`
7 years ago
* `pkg-config` or `pkgconfig` for Fedora
9 years ago
* `libgtk-3-dev` for Debian based distros or `gtk3-devel` for RPM based distros
7 years ago
* `git` to clone the source directory
9 years ago
7 years ago
**Note:** For distributions which don't ship separate development packages, just the GTK 3 package is needed instead of the `-dev` packages.
8 years ago
For the theme to function properly, install the following
7 years ago
* GNOME Shell 3.14 - 3.24, GTK 3.14 - 3.22
8 years ago
* The `gnome-themes-standard` package
7 years ago
* The murrine engine. This has different names depending on the distro.
8 years ago
* `gtk-engine-murrine` (Arch Linux)
* `gtk2-engines-murrine` (Debian, Ubuntu, elementary OS)
* `gtk-murrine-engine` (Fedora)
* `gtk2-engine-murrine` (openSUSE)
* `gtk-engines-murrine` (Gentoo)
9 years ago
Install the theme with the following commands
8 years ago
#### 1. Get the source
9 years ago
8 years ago
Clone the git repository with
9 years ago
git clone https://github.com/horst3180/arc-theme --depth 1 && cd arc-theme
8 years ago
#### 2. Build and install the theme
9 years ago
./autogen.sh --prefix=/usr
sudo make install
Other options to pass to autogen.sh are
9 years ago
--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
9 years ago
--disable-cinnamon disable Cinnamon support
9 years ago
--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
7 years ago
--with-gnome=<version> build the theme for a specific GNOME version (3.14, 3.16, 3.18, 3.20, 3.22)
Note 1: Normally the correct version is detected automatically and this
9 years ago
option should not be needed.
7 years ago
Note 2: For GNOME 3.24, use --with-gnome-version=3.22
(this works for now, the build system will be improved in the future)
9 years ago
7 years ago
After the installation is complete the theme can be activated 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.
If the `--disable-transparency` option was used, the theme will be installed as `Arc-solid`, `Arc-Darker-solid` and `Arc-Dark-solid`.
9 years ago
8 years ago
## Uninstall
9 years ago
Run
sudo make uninstall
8 years ago
from the cloned git repository, or
9 years ago
9 years ago
sudo rm -rf /usr/share/themes/{Arc,Arc-Darker,Arc-Dark}
9 years ago
8 years ago
## Extras
9 years ago
### Arc KDE
A port of Arc for the Plasma 5 desktop with a few additions and extras. Available [here](https://github.com/PapirusDevelopmentTeam/arc-kde).
8 years ago
### Arc Firefox theme
9 years ago
A theme for Firefox is available at https://github.com/horst3180/arc-firefox-theme
9 years ago
8 years ago
### Arc icon theme
8 years ago
The Arc icon theme is available at https://github.com/horst3180/arc-icon-theme
8 years ago
### Chrome/Chromium theme
9 years ago
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.
9 years ago
8 years ago
### Plank theme
9 years ago
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.
8 years ago
### Arc-Dark for Ubuntu Software Center
8 years ago
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.
8 years ago
## Troubleshooting
9 years ago
7 years ago
If you use 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 the theme has to be installed manually as described above.
This is also true for other distros with a different GTK/GNOME version than the one included by default
9 years ago
--
9 years ago
If you get artifacts like black or invisible backgrounds under Unity, disable overlay scrollbars with
gsettings set com.canonical.desktop.interface scrollbar-mode normal
8 years ago
## Bugs
9 years ago
If you find a bug, please report it at https://github.com/horst3180/arc-theme/issues
9 years ago
8 years ago
## License
Arc is available under the terms of the GPL-3.0. See `COPYING` for details.
8 years ago
8 years ago
## Full Preview
![A full screenshot of the Arc theme](http://i.imgur.com/tD1OBQ3.png)
8 years ago
<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>
8 years ago
[obs-repo]: http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme
[sk-overlay]: https://c.darenet.org/scriptkitties/overlay