source: arc-theme/trunk/fuentes/arc-theme/README.md @ 2104

Last change on this file since 2104 was 2104, checked in by hectorgh, 3 years ago

updating theme

File size: 6.3 KB
Line 
1# Arc Theme
2
3Arc 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.
4
5###Arc is available in three variants
6
7#####Arc
8
9![A screenshot of the Arc theme](http://i.imgur.com/Ph5ObOa.png)
10
11#####Arc-Darker
12
13![A screenshot of the Arc-Darker theme](http://i.imgur.com/NC6dqyl.png)
14
15#####Arc-Dark
16
17![A screenshot of the Arc-Dark theme](http://i.imgur.com/5AGlCnA.png)
18
19
20### Requirements
21
22* Gnome/GTK 3.14, 3.16, 3.18 or 3.20
23* The `gnome-themes-standard` package
24* The murrine engine. This has different names depending on your distro.
25  * `gtk-engine-murrine` (Arch Linux)
26  * `gtk2-engines-murrine` (Debian, Ubuntu, elementary OS)
27  * `gtk-murrine-engine` (Fedora)
28  * `gtk2-engine-murrine` (openSUSE)
29  * `gtk-engines-murrine` (Gentoo)
30
31Main distributions that meet these requirements are
32
33* Arch Linux and Arch Linux based distros
34* Ubuntu 15.04, 15.10 and 16.04 (**Ubuntu 14.04 and 14.10 are not supported**)
35* elementary OS Freya
36* Debian 8, Testing or Unstable
37* Gentoo
38* Fedora 21 - 24
39* openSUSE 13.2, Leap 42.1 and Tumbleweed
40
41Derivatives of these distributions should work, as well.
42
43If your distribution isn't listed, please check the requirements yourself.
44
45### Installation
46
47**Important:** Remove all older versions of the theme from your system before you proceed any further.
48
49    sudo rm -rf /usr/share/themes/{Arc,Arc-Darker,Arc-Dark}
50    rm -rf ~/.local/share/themes/{Arc,Arc-Darker,Arc-Dark}
51    rm -rf ~/.themes/{Arc,Arc-Darker,Arc-Dark}
52
53#### Packages
54
55Prebuilt packages for Ubuntu, Debian, Fedora and openSUSE are available at 
56http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme 
57
58A non-transparent version of the theme is available here 
59http://software.opensuse.org/download.html?project=home%3AHorst3180&package=arc-theme-solid 
60
61**Note:** elementary OS Freya users can install the package for Ubuntu 15.04
62
63--
64
65Arch Linux users can install the theme from the AUR
66
67**Official Releases**: https://aur.archlinux.org/packages/gtk-theme-arc/ 
68
69**Development Releases**: https://aur.archlinux.org/packages/gtk-theme-arc-git/ 
70
71**Note:** If you're having trouble with the AUR packages please email the package maintainer at zach@zach-adams.com before creating an issue.
72
73#### Manual Installation
74
75To build the theme you'll need
76* `autoconf`
77* `automake`
78* `pkg-config` or `pkgconfig` if you use Fedora
79* `libgtk-3-dev` for Debian based distros or `gtk3-devel` for RPM based distros
80* `git` if you want to clone the source directory
81
82If your distributions doesn't ship separate development packages you just need GTK 3 instead of the `-dev` packages.
83
84Install the theme with the following commands
85
86**1. Get the source**
87
88If you want to install the latest version from git, clone the repository with
89
90    git clone https://github.com/horst3180/arc-theme --depth 1 && cd arc-theme
91
92**2. Build and install the theme**
93
94    ./autogen.sh --prefix=/usr
95    sudo make install
96
97Other options to pass to autogen.sh are
98
99    --disable-transparency     disable transparency in the GTK3 theme
100    --disable-light            disable Arc Light support
101    --disable-darker           disable Arc Darker support
102    --disable-dark             disable Arc Dark support
103    --disable-cinnamon         disable Cinnamon support
104    --disable-gnome-shell      disable GNOME Shell support
105    --disable-gtk2             disable GTK2 support
106    --disable-gtk3             disable GTK3 support
107    --disable-metacity         disable Metacity support
108    --disable-unity            disable Unity support
109    --disable-xfwm             disable XFWM support
110
111    --with-gnome=<version>     build the theme for a specific Gnome version (3.14, 3.16, 3.18, 3.20)
112                               Note: Normally the correct version is detected automatically and this
113                               option should not be needed.
114
115After 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 and Xfce-Notify theme.
116
117**Uninstall the theme**
118
119Run
120
121    sudo make uninstall
122
123from the same directory as this README resides in, or
124
125    sudo rm -rf /usr/share/themes/{Arc,Arc-Darker,Arc-Dark}
126
127### Extras
128
129#### Arc Firefox theme
130A theme for Firefox is available at https://github.com/horst3180/arc-firefox-theme
131
132#### Arc icon theme
133The Arc icon theme is available at https://github.com/horst3180/arc-icon-theme
134
135#### Chrome/Chromium theme
136To 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.
137
138#### Plank theme
139To 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.
140Now open the Plank preferences window by executing `plank --preferences` from a terminal and select `Arc-Plank` as the theme.
141
142#### Arc-Dark for Ubuntu Software Center
143The 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.
144
145### Troubleshooting
146
147If 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.
148This is also true for other distros with a different GTK/Gnome version than the one included by default
149
150--
151
152If you get artifacts like black or invisible backgrounds under Unity, disable overlay scrollbars with
153
154    gsettings set com.canonical.desktop.interface scrollbar-mode normal
155
156
157### Bug reporting
158If you find a bug, please report it at https://github.com/horst3180/arc-theme/issues
159
160### Full Preview
161![A full screenshot of the Arc theme](http://i.imgur.com/tD1OBQ3.png)
162<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>
Note: See TracBrowser for help on using the repository browser.