README.md

Adapta

An adaptive Gtk+ theme based on Material Design Guidelines. Lots of elements were forked from Flat-Plat at the start.

Adapta:

• Light/Dark variant Gtk+ 3.20/3.18 theme
• Light/Dark variant Budgie-Desktop theme
• Light variant Gtk+ 2.0 theme
• Light variant Gnome-Shell theme
• Light variant Cinnamon theme

Adapta-Nokto:

• Light/Dark variant Gtk+ 3.20/3.18 theme
• Light/Dark variant Budgie-Desktop theme
• Dark variant Gtk+ 2.0 theme
• Dark variant Gnome-Shell theme
• Dark variant Cinnamon theme

Note: Both also includes common GNOME-Flashback, Unity7 and XFce4 theming.

Elements

Required Components

Adapta supports Gtk+ 3.20.x and 3.18.x

* Gtk+-3.0             >= 3.20.1  (or  3.18.9)
* Gtk+-2.0             >= 2.24.30
* gtk2-engines-pixbuf  >= 2.24.30
* gtk2-engines-murrine >= 0.98.1

Supported Desktop Environments

* GNOME           >= 3.20 (or 3.18)
* GNOME-Flashback >= 3.20.1 (or 3.18.2)
* Budgie-Desktop  >= 10.2.5
* Cinnamon        >= 3.0.1 (or 2.8.6)
* Unity           >= 7.4.0
* XFce4           >= 4.12.2

Unsupported Gtk+ Based Desktops

• Mate
• Pantheon

Installation from PPA (Ubuntu 16.04 LTS and 16.10)

1. Run

sudo apt-add-repository ppa:tista/adapta -y
sudo apt update
sudo apt install adapta-gtk-theme

2. select Adapta or Adapta-Nokto via proper tools.

Note:

• Adapta-Nokto is for dark variant theming:

  • Adapta + global dark theme = off make all light variant.
  • Adapta + global dark theme = on make dark variant Gtk+3 and light variant Gtk+2.
  • Adapta-Nokto + global dark theme = off make light variant Gtk+3 and dark variant Gtk+2.
  • Adapta-Nokto + global dark theme = on make dark variant.

• For Gtk+ 3.18.x users, there's no need to upgrade Gnome-Tweak-Tool to 3.20.0 since Adapta revived gtk-3.0 directory.

• In Xeinal, Gtk+ 3.21.x support is disabled (Yakkety package enabled it as default though).

• When updating package, Adapta automatically does cleaning up pre-installed directories.

Installation from Git Source

1. If previous version was installed/existed, remove them at first.

sudo rm -rf /usr/share/themes/{Adapta,Adapta-Nokto}
rm -rf ~/.local/share/themes/{Adapta,Adapta-Nokto}
rm -rf ~/.themes/{Adapta,Adapta-Nokto}

2. Check build-requirements: Today Adapta bundles neither pre-generated stylesheets nor PNG images. So users and/or contirbutors should generate proper CSSs and PNGs at build-time.

* autoconf
* automake
* inkscape
* libglib-2.0-dev (glib2)         >= 2.48.0
* libxml2-utils (libxml2)
* pkg-config (pkgconfig)
* ruby-bundler (rubygem-bundler)  >= 1.11
* ruby-sass (rubygem-sass)        >= 3.4.21

Note:

• Adapta employs Gem generator for SASS/SCSS via bundle and sass.
• Adapta uses inkscape to generate installable PNG files.
• Adapta uses glib-compile-resources to compile gresource file for Gnome-Shell.

3. Build and install system-wide:

./autogen.sh
make
sudo make install

Note:

• Default prefix is /usr.
• Adapta-Nokto dark variant is installed as default.
• make generates proper CSSs and PNGs to be installed. And it will take about 5min to 15min to build, for example, Ubuntu's build-server actually does 10min...
• sudo make install installs multiple versioned theme and Gtk+ automatically selects proper versioned one when running.

4. If users want to speed up with concurrency-build, please pass this specific options to autogen.sh:

--enable-parallel       enable parallel-build support

Note:

• This feature requires GNU parallel, so please add parallel to build-requirements. Parallel can execute multiple scripts and binaries to be suitable for multi-threading. Especially it could shorten the rendering-time via Inkscape and generation-time via sass.
• -jN option to be passed to GNU make is surely usable though, but Adapta employes parallel meanwhile...
• This feature should not be applied when packaging on remote/shared build-servers.

5. If users want to disable some DE supports, please pass these specific options to autogen.sh:

--disable-cinnamon      disable cinnamon support
--disable-flashback     disable flashback support
--disable-unity         disable unity support
--disable-xfce          disable xfce support

Note:

• Installer installs GNOME/Budgie-Desktop support even if all of options above were applied.
• Cinnamon/Unity support hooks metacity-1 directory even if GNOME-Flashback support was disabled.

6. If users want to enable next Gtk+ release support, please pass this option:

--enable-gtk_next       enable Gtk+ 3.21.x support

Note:

• As default, Gtk+ 3.21.x support is disabled.

7. If users want to change default 5 Key-Colors, please pass these options:

--with-selection_color        Primary color for 'selected-items' (Default: #00BCD4 = Cyan500)
--with-second_selection_color Primary color for 'select' effects (Default: #4DD0E1 = Cyan300)
--with-accent_color           Secondary color for notifications and OSDs (Default: #4DB6AC = Teal300)
--with-suggestion_color       Secondary color for 'suggested' buttons (Default: #009688 = Teal500)
--with-destruction_color      Tertiary color for 'destructive' buttons (Default: #FF5252 = RedA200)

Note:

• Color-codes are defined as # + 6HEXs (Standard RGB definitions in HTML codes). And uppercases are strongly recommended in Adapta code-base.

• Material Desing Color Palette is here: External Link

• Example) If you would like to use 'Teal500' as selection_color, try this:

  ./autogen.sh --with-selection_color=#009688 --with-second_selection_color=#4DB6AC

  This can switch to almost-Teal key colors.

• Basically selection_color and suggestion_color should be with 500 colors, and second_selection_color and accent_color should be with 300 colors.

• While doing make, Adapta changes those 5 colors in all stylesheets and images, and make clean cleans up all generated files from source directories.

Extra Browser Support

If users want to try experimental browser specific theming, please pass this option:

--enable-chrome         enable Chrome(ium) support

The compressed crx files will be installed into Adapta/chrome and Adapta-Nokto/chrome.

Note:

• Today Chrome(ium) theming is supported only.

• Vivaldi can make custom themes via settings like these:

  Background: #FAFBFC (#3E515A)
  Foreground: #263238 (#ECEFF1)
  Highlight:  #00BCD4
  Accent:     #2A373E
  Accent Color from Active Page: [ ]
  Apply Accent Color to Window:  [x]
  Transparent Tabs:              [x]
  Corner Rounding:               2px
  

Extra Dock Support

If users want to try "Plank" theming, please pass this option:

--enable-plank         enable Plank support

Then select Gtk+ via plank --preferences.

Note:

• Both Adapta and Adapta-Nokto shares same theming.
• Don't expect too much. Plank is NOT themeable widget for me!

Official Wallpaper of Adapta

Raw image is here.

• Resolution: 3840 x 2160 (4K = 2160p)
• Created with Gimp and Inkscape
• License under GPLv2

I mainly use it when running Budgie, and it might be suitable for night owls...

Work in Progress

• Conversion to Gtk+ 3.22

TODO

• Prepare for Steam theming (priority: Low)
• Add Firefox specific theming (priority: undecided)

Public License

GPLv2

Note: SVG files are licensed under CC BY-SA 3.0

Special Thanks to

Nana-4, the developer of Flat-Plat.