README-Manual.txt

:::::::::::::::::::::::::::::: Vibrancy Colors Icon Theme :::::::::::::::::::::::::::::::::::



:::::::::::::::::::::::: The Official Manual And Release Notes :::::::::::::::::::::::::::::::

::::::::::::::::::::::::::::: Version 2.7 (April 2016+) :::::::::::::::::::::::::::::


Like this theme?

Please Support All These Great Open Source Icon Themes/Projects 
who make up this theme and make it possible:

http://mokaproject.com/about/
http://tiheum.deviantart.com/
https://numixproject.org/
http://nitrux.in/
http://elementaryos.org/ 

Then Come Visit US At: http://www.ravefinity.com/ 
for this theme and more themes like it.

:::::::::::::::::::::About This Theme:::::::::::::::::::::

Vibrancy Colors is a beautiful flattish and "vibrant" icon theme. Vibrancy is a mixture of many, Of the top open source icon themes into a new beautiful icon theme. It is meant to be modern clean and customizable. It was built with RAVEfinity Color GTK Themes in mind or any theme you see fit. And is meant to work nicely with flat gtk themes.

Vibrancy Flat features Vivid and beautiful application icons (A very slightly tweaked version of the Moka Icon Theme) 13 Different Folder Colors Selectable Based on KDE 5's Breeze Folders. Along with support for 5 types of monochrome panels & Tool-bar configurations Based on Faenza & elementary. 2 Non monochrome tool-bars configurations are selectable as "NonMono" Panel stays Monochrome on both however.

14 Colors of Folders are Selectable: Stock Manila Folders ,Blue , Aqua , Graphite , Blue Vivid (Dark), Brown, Green , Green Viva, Purple, Red , Pink, Orange, Teal, Yellow. 

5 Versions are Selectable:
Just play with it if you don't understand what this means, be sure to open gedit or something with a toolbar so you know what is what.

Vibrancy Light - Dark Monochrome Panel Icons For Light Panels. And Dark Monochrome Icons For Toolbar Icons
Vibrancy Dark - Light Monochrome Panel Icons for Dark Panels. And Dark Monochrome Icons For Toolbars Icons.
Vibrancy Full Dark - Light Monochrome Panel Icons for Dark Panels. And Light Monochrome Icons For Toolbars Icons.

Vibrancy-NonMono-Dark- Keeps the Light Monochrome panel icons for a Dark panel theme. but then provides traditional toolbar icons (Color based)
Vibrancy-NonMono-Light- Keeps the Dark Monochrome panel icons for a Light panel theme. but then provides traditional toolbar icons (Color based)


Vibrancy Colors should work on any GTK Desktop On Any distro. but it has not been tested on ones released before then 2014. We did some complex linking and inheriting to make the theme slim and as few files as possible (We got it down from 121,000 files to about 43,000) this may cause issues on some older desktops but most likely not.

Update 2.7 ... More Icons Again!

Update 2.6 More Icons Yet Again! Jeez.

Update 2.5: More Icons!

Update 2.4: Adds lots of new app icons users have requested.

Update 2.3: Fixes for Cinnamon and Gnomeshell battery icons (So they are no longer blury)
Added a few new app icons (Games etc), Fixed broken spotify icon (Note notification is now colorfull, Had to pick monotone or the other.) More enchanemants. Fixed Context menu XFCE Terminal Icon.

Update 2.2.1 Removed some backup files that where causieng GTK Icon Cache Gen to fail. So it now works. Thanks to Fillip For the fix. Other Fixes like better res user icon. 

Update 2.2: New Version April 2015, Despite the small version number bump (2.1 ---> 2.2 ) this release packs alot of enhancments and features and fixes. We have gone through alot of things and made them even better including dozens of little "paper cut" issues reported by users and found by us. Added New GTK3 Monotone Symbolic Icons, Makes GnomeShell , Cinnamon look nicer and Makes the GTK3 browse dialog look slick. Linux Mint and Cinnamon panel icons look better (Network icon and battery.), Replaced Unity Panel Gear With a clean, common and more understandable power button. Fixed small symbolic Hard Drive Icon being non-mono if device mounted (common issue fixed). Added Icons for Web Apps (Mooka), Added Wine Drive C: Custom Folder (Previous was Orange Humanity), Fixes for better looking XFCE menu icons (Zip). Added Icons For mdmflexiserver, Mint Desktop Config to make work better on mint. Enhanched some mimetype icons again. Fixed some action icons being wrong size if smaller variant not avalible (added needed smaller variants). Fixed & Added properly matching suspend and sleep buttons. And alot of other things.      

Update 2.1: Completely overhauled mimetype system. Based on Numix Mimetype icons, With changes by RAVEfinity. Now all proper size SVGs Scale on gtk 3.14+, Added more emblems and enhanced emblems icon system. Other fixes and enhancemnts. Added Full support for folder color extension. (Nemo, Nautulis, Caja, Files extension) Fixes for New XFCE 4.12 (Reboot Icon Fixed Thanks to John for tip) , Added new folder color Green Viva. A darker green for those who'd prefer a calmer shade.

Update 2.0: Awesome Update. This release fixes/patches the theme for a bug in Gnome that would cause Gnome Shell 3.14 to crash when opening a file save dialog. It no longer does that! And Gnome 3.14 works awesome now. This Updates brings full compatibility to Gnome 3.14+. Adds and tweaks a few more icons like PhpStorm, Gnome Music (New Icon). LibreOffice Impress Icon looks less neon. A outdated Impress Icon in 16px fixed.  

Update 1.9: Fixes Symbolic icon sizes in GTK 3.14 and restores better looking symbolic icons in all versions. Among other things.

Update 1.8.1: A few New fixes.

Update 1.7: Fixes a few litte quirks and icons and makes things even nicer. 

Update 1.5: Some New/Restyled Apps Icons (Icons Changed around/recolord), New App Icons for apps not present before, Fixes in Action and status Icon system, No more Blury Icons anywhere, like Sound/Help (Hopefully). Lots of fixes and imporvemnts thanks to user feedback and testing. Enjoy!

Update 1.1: Fixes DOCX Mimetype Icons, Adds Apple(TM) DMG Disk Image Icon, RedShift Mono Icon for dark theme. 

We ARE NOT trying to take much credit for this icon theme as we feel it would be disrespectful to the authors whos work it uses. However please note we did spend alot of time putting it together (Think of us like a linux distro, compiling lots of things and making sure it works and looks good) We did some design, testing, tweaking and fixing issues. Engineering a icon theme like this is not simple as it would seem. It's very complex with all the colors and versions. But the authors of the other icon themes used in this most likely did way more work as they created things from scratch. 

PLEASE SUPPORT THE ORIGINAL AUTHORS:
THIS THEME IS MADE UP OF OTHERS AMAZING OPEN SOURCE HARD WORK:

Do Not credit us for everything, This theme is made up of others beautiful hard work, please support the authors. 
We do not want to hurt anyones endeavors or the community. This is NOT a FORK of anything whatsoever. 
It's just a fusion of some really awesome themes into another awesome theme (We Hope).

Application Icons, Majority Of Icons used in Theme.

Are a slightly modified version of The Faba & Moka Icon Theme 
That is designed and developed by 

(C) 2014 Sam Hewitt 

Please support Sam here Buy Him a Coffee or Donate...
http://mokaproject.com/about/


System Panel Indicators (Monochromes), App Toolbar Icons, Few Others 

Are The Faenza Icons designed and developed by:
(C) 2012-2014 Matthieu James

Please Support Tiheum here:
http://tiheum.deviantart.com/


Mime type Icons 

Are The Numix Square Icon Theme
(C) 2013-2014 Numix Project

Please support the Numix folks here donate or buy something fancy :) :
https://numixproject.org/

Folder Icons.

Are The KDE Breeze Folder Icons.

(C)2014 KDE Visual Group (KDE Open Source Project)
Main Design by: Uri Herrera. (Please Visit: http://nitrux.in/)


Symbols Used On Folders

Are From the elementary icon theme.

elementary Icons & Theme.
(C) 2011-2014 Daniel Foré.

Please support elemntary at:
http://elementaryos.org/ 

Overall Design for this icon theme Vibrancy Flat 
Merged together, tweaked and compiled & some design by the RAVEfinity Project, 

You can visit us At: http://www.ravefinity.com/

(C) 2014-2016 , Jared Sot.


:::::::::::::::::::::Features:::::::::::::::::::::

Vibrancy Colors is a beautiful flat and "vibrant" icon theme. Vibrancy is a mixture of many of the top open source icon themes into a new beautiful theme.
Vibrancy Flat features Vivid and beautiful application icons (A slightly tweaked version of the Moka Icon Theme) 13 Different Folder Colors Selectable Based on KDE 5's Breeze Folders. Along with support for 3 types of monochorme panels & Tool-bar configurations Based on Faenza.

Vibrancy Colors is a fusion (Mix) of many beautiful Open source icons themes into a "Newish" beautiful awesome flat icon theme.

Vibrancy Colors is a mixture of:

Moka Icons (For Application icons & majority of icons, We Slightly Modified a few app icons) 

Numix Square Icon Theme (Mime type Icons)

Faenza Icons (System Panel Indicators (Monochromes), App Toolbar Icons, Few Others )

KDE 5 Breeze Icons (Folder Icons (Modified Color And Symbols , Ported to GTK by RAVEfinity)
 
elementary folder Symbols (Symbols used on folders eg music downloads etc.) 

RAVEfinity Design (Icons Mixed together,crafted,tested and tweaked by RAVEfinity)


:::::::::::::::::::::SPACE REQUIREMENTS:::::::::::::::::::::


85 MB For Entire Install (Uncompressed)


:::::::::::::::::::::Copyrights & Credits:::::::::::::::::::::


This work is based on and Licensed under 2 open source licenses.

License 1, Creative Commons SA, https://creativecommons.org/licenses/by-sa/3.0/us/
License 2, GPL v2 & v3 , http://www.gnu.org/copyleft/gpl.html


Brought to you by(& Based on):


Application Icons, Category Icons (Majority of artwork):

Are The Faba & Moka Icon Theme that is designed and developed by 

(C) 2014 Sam Hewitt <hewittsamuel@gmail.com>

Please support Sam here...
http://mokaproject.com/about/
(License, Creative Commons SA, https://creativecommons.org/licenses/by-sa/3.0/us/ )


System Panel Indicators (Monochromes), App Toolbar Icons, Few Others 

Are The Faenza Icons designed and developed by:
(C) 2012-2014 Matthieu James <matthieu.james@gmail.com>

Please Support Tiheum here:
http://tiheum.deviantart.com/
(License, Creative Commons SA, https://creativecommons.org/licenses/by-sa/3.0/us/ )


Mime type Icons 

Are The Numix Square Icon Theme
(C) 2013-2014 Numix Project

Please support the Numix folks here:
https://numixproject.org/
(License, GPL , http://www.gnu.org/copyleft/gpl.html)


Folder Icons.

Are The KDE Breeze Folder Icons.

(C)2014 KDE Visual Group (KDE Open Source Project)
Main Design by: Uri Herrera. (No Email or URL Provided in copyright & about file, We will add if found.)
(License, Creative Commons SA, https://creativecommons.org/licenses/by-sa/3.0/us/ )
Please support kde at kde.org

Symbols Used On Folders

Are From the elementary icon theme.

elementary Icons & Theme.
Daniel Foré <Daniel.p.Fore@gmail.com>

Please support elemntary at:
http://elementaryos.org/ 

Overall Design for this icon theme Vibrancy Flat 
Merged together, tweaked and compiled by the RAVEfinity Project, 

You can visit us At: http://www.ravefinity.com/

(C) 2014 , Jared Sot. <ravefinity@gmail.com>
(License, Creative Commons SA, https://creativecommons.org/licenses/by-sa/3.0/us/)


:::::::::::::::::::::ABOUT THEMES :::::::::::::::::::::


Most GTK 2 & 3 themes  or Icon Themes for Linux (BSD etc) are distributed in a tar.gz or zip format. by default. (Or more specifically  Source)

Some themes are available in .deb packages or rpm etc.. See our website to download them! If you get one in those formats you can safely install it (By double clicking on it) avoiding the need for manual installation discussed here.

This guide covers manually installing themes from SOURCE or tar.gz files! despite the "Scary name" there is no compiling or difficult things needed to a install a theme this way. Believe it or not the only thing you have to do is copy the theme files into the proper folder and your desktop should automatically recognize them!

Heres how we do that...
Thats being said just install and activate it on your desktop as shown bellow...

(!) Always back up your data and use these instructions at own risk! its not ours nor our contributors fault if anything goes wrong.
We have taken great strides to provide clear concise and safe instructions! But as always Do This at your own risk ! No Warranty!


:::::::::::::::::::::How to Install:::::::::::::::::::::


(!) THIS IS FOR MANUALLY INSTALLING THE THEME IF YOU OBTAINED IT IN A TAR.GZ FILE.
IF YOU INSTALLED IT FROM OUR PPA .DEB, RPM ECT YOU CAN SAFELY SKIP TO THE NEXT SECTION "ACTIVATING THE THE THEME" (IT'S ALREADY INSTALLED)

IF YOU'D LIKE TO GET IT OR INSTALL IT THAT WAY 
SIMPLY VISIT: http://www.ravefinity.com/

:::: Install The Icon Theme. *System Wide* Recommended ::::

(Note: this Method requires Root or SUDO privileges)

YOU DO NOT NEED TO INSTALL THIS WAY IF YOU USE OUR OFFICAL PPA OR UBUNTU,MINT OR DEBIAN .DEB PACKAGES, SIMPLEY CLICK DOWNLOAD CLICK , AND CLICK INSTALL!

Overview of what we need to do:To Intsall any Icon theme You Simply Extract the complete package you just downloaded the "ThemeName.tar.gz" (Folders and all)
to the themes folder for your entire system..."/usr/share/Icons/"

(Open A Terminal by Pressing Ctrl+Alt+T or by browsing for it on your menu)

1.) Open a terminal and type: sudo file-roller (Then type your password when asked)
-Fedora/Redhat Users Without sudo, type: "su -c file-roller" (Then type the root password)

4.) Now You will see the File Roller Archiver application...

Click "File -> Open" Then Browse for the package you just downloaded: "IconThemeName.tar.gz". Then click open.

5.) Once You've opened the "IconThemeName.tar.gz" file,

Select "Extract". Then Browse to the fallowing folder:"/usr/share/Icons/" Then click ok!

6.)The  Theme Should now be installed! Now all you must do is select the Theme VIA your desktops theme manager! (See other help section on how to do this)

Please Note: If this themes comes with a GTK theme please install that separately.

Manually Install The Icon Theme.  *For Your User Account Only* (Meathod 2)

NOTE: This is NOT how you install GTK Themes see that dedicated section on that.


:::: Install The Theme for *your user account only* ::::

YOU DO NOT NEED TO INSTALL THIS WAY IF YOU USE OUR OFFICAL PPA OR UBUNTU,MINT OR DEBIAN .DEB PACKAGES, SIMPLEY CLICK DOWNLOAD CLICK , AND CLICK INSTALL!

1.) Click to Open Up the package file you just downloaded... "IconThemeName.tar.gz"

2.) Once Open, Click the "Extract" Button... Then Browse to: /Home/YourUserName/.Icons

(!)To see the folder (it's a hidden one!) press ctrl+h in this file browser window to view hidden folders. the folder we want to install it in is ".themes" in your home directory.

3.) Extract the complete package "IconThemeName.tar.gz" file (Folders and all)
to the ".Icons" folder in your home directory.

4.) Select it VIA your Theme Manager! Please See Bellow...

(!) This will install the theme for the current user only , Evey user will have to do this on there own!, Thats why we recommend the system wide method (Above) 


:::::::::::::::::::::Using Your New Theme:::::::::::::::::::::


Once a theme is installed (See Previous Section on how to do so)
All you must do is activate it or tell your desktop to use it instead of the default or current theme.

Start using your new icon theme as fallows...


::::The On Cinnamon desktop::::

1.) Locate and start the "System Settings" It's A Grey Gear Icon. 

Menu -> The Gears Icon On The Side. Under Firefox and The Package Manager.

2.) Click On The Themes Icon

3.) Click On The Other Settings Tab.

4.) Select Desired Version Of Icons From Icons Drop Down Box.

5.) Have Fun!

::::On Gnome 3 desktops::::


1.) Locate and start the "unity-tweak-tool" (Sometimes labeled "Advanced Settings") in your menu. (Install it if needed)

Or if you don't have that use

1 alt.) Locate and start the "Gnome Tweak Tool" (Sometimes labeled "Advanced Settings") in your menu. (Install it if needed)

How-to Install this tool:

Ubuntu,Debian & Mint
Install via searching for "unity-tweak-tool" in the Software Center or Synaptic Package manger or simply type: sudo apt-get install gnome-tweak-tool ,in a terminal or Run Command

Or if you don't have that

Install via searching for "unity-tweak-tool" in the Software Center or Synaptic Package manger or simply type: sudo apt-get install gnome-tweak-tool ,in a terminal or Run Command


Fedora and Redhat
Install via searching for "gnome-tweak-tool" in Add/Remove Software or type: yum install gnome-tweak-tool ,in a terminal or Run Command

Start using theme via "Unity Tweak Tool"

(In Unity:)
Get to your menu of applications by Clicking the Ubuntu Logo or pressing the "Super Key" eg. The Windows(TM) Logo Key

Now simply navigate to the "settings" or "system tools" application category in your menu, or type "Unity Tweak" in the unity search box and launch the application.

3.) Once the "Unity Tweak Tool" application is open...
Select the "Icons" option from the grid.

4.) Now select your desired version of RAVE-X from the list boxes.
.. Your Done!


(Alternate method) Start using theme via "Gnome Tweak Tool" (Sometimes labeled "Advanced Settings")

(In Unity:)
Get to your menu of applications by Clicking the Ubuntu Logo or pressing the "Super Key" eg. The Windows(TM) Logo Key

(In Gnome 3:)
Get to your menu by clicking activities then clicking "applications" or pressing the "Super Key" eg. The Windows(TM) Logo Key.

Now simply navigate to the "settings" or "system tools" application category in your menu, or type "Gnome Tweak Tool" in the search box and launch the application.

3.) Once the "Gnome Tweak Tool" application is open...
Select the "Icons" option from the list of options on the left.

4.) Now select your desired version of Vibrancy Flat from the Icons Tab
Click apply.. Your Done!

(!) Now You may need to login and log back out for the theme to display correctly or take effect. (Thats How GTK 3 and Gnome 3 work for now)


:::::::::::::::::::::On Gnome 2/MATE:::::::::::::::::::::


Simply select your desired theme, GTK2 Theme , and Window Border on your Desktops Theme Manager:

-On Gnome2, Mate and Unity Desktops (11.04 Only) Do this-

1.) Right Click on the desktop

2.) Select Change Background

3.) Click on the "Themes tab"

4.) Click Customize.

5.) Select Your Desired Theme from the List In the: "Icons" Tab.

Thats All!

(!) Remember to select the Theme you want from each of these tabs noted.
(*) An alternate way to get to this dialog is to goto System -> Preferences -> Appearance , Then continue from step 3.. (above)


:::::::::::::::::::::On XFCE Desktops:::::::::::::::::::::


1.) Click On The "XFCE Menu".  (Should be On the far left of either the top or bottom of your desktop.)

2.) Click On The "Settings Menu"  Then --> "XFCE Settings Manager"

3.) Now Click The "Appearance" Category.

4.) Now Select Your Desired theme from the List!, In the "Icons" tab.

5.) Once Done you may click Close ! :)


(!) In case XFCE Settings Manager is not Installed (It really should be, because it's pretty cool), You can also get to the same locations above VIA Clicking:

 "XFCE Menu --> Settings Menu" --> "Appearance"      (then See Step 4)


:::::::::::::::::::::On LXDE Desktops:::::::::::::::::::::


1.) Click On the "Start" Icon (The Circular Icon in the Taskbar/Panel in far left of your screen.)

2.) Select The "Preferences Menu", Then --> "Customize Look and Feel" Menu Item

3.) Now Select Your Desired Icon theme From the List In the: "Icons" Tab And Click Apply.

On OpenBox Desktops

Openbox, out of the box does not have a GUI fronted option to switch your GTK-Theme and Icons.
However most prebuilt openbox desktops Such as CrunchBang(Openbox Edition), ETC will will include the lxappearance utility. If you don't have this utility you should install it via your package manager.

Once it is installed, You can launch it via the command line or run command dialog...

1.) Right click on your Openbox desktop and Find the "lxappearance" Application in your openbox menu. Or Open a terminal or run command prompt and type: lxappearance (and press  enter)

2.) Now Select Your Desired Icon theme From the List In the: "Icons" Tab And Click Apply. 


-------------------------------------------------------------------------------------------------------------------------------------------------------------
Thats All! - Written by Jared Sot. (Please forgive the spelling errors. It's a lot of work to create a theme and complete documentation.)