Papirus is a free and open source SVG icon theme for Linux, based on [Paper Icon Set](https://github.com/snwh/paper-icon-theme) with a lot of new icons and a few extras, like [Hardcode-Tray support](#hardcoded-tray-icons), [KDE colorscheme support](#kde-colorscheme), [Folder Color support](#folders-color), and [others](#extras). Papirus icon theme is available in six variants: - Papirus (for Arc Darker) - Papirus Dark (for Arc Dark) - Papirus Light (light theme with Breeze colors) - Papirus Adapta (for Adapta) - Papirus Adapta Nokto (for Adapta Nokto) - ePapirus (for elementary OS and Pantheon Desktop) ## Installation ### Ubuntu and derivatives You can install Papirus from our official [PPA](https://launchpad.net/~papirus/+archive/ubuntu/papirus): ``` sudo add-apt-repository ppa:papirus/papirus sudo apt-get update sudo apt-get install papirus-icon-theme ``` or download .deb packages from [here](https://launchpad.net/~papirus/+archive/ubuntu/papirus/+packages?field.name_filter=papirus-icon-theme). ### Debian and derivatives Debian users also can install Papirus from our [PPA](https://launchpad.net/~papirus/+archive/ubuntu/papirus), but the commands will differ: ``` sudo tee /etc/apt/sources.list.d/papirus-ppa.list << EOF deb http://ppa.launchpad.net/papirus/papirus/ubuntu xenial main EOF sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com E58A9D36647CAE7F sudo apt-get update sudo apt-get install papirus-icon-theme ``` ### Papirus Installer Use the scripts to install the latest version directly from this repo (independently of your distro): **NOTE:** Use the same script to update icon themes. #### ROOT directory (recommended) ``` wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-root.sh | sh ``` #### HOME directory for GTK ``` wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-gtk.sh | sh ``` #### HOME directory for KDE ``` wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-kde.sh | sh ``` **NOTE:** Qt4 apps require `libqt4-svg` to work correctly. #### Remove ``` wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/remove-papirus.sh | sh ``` ### Unofficial packages Packages in this section are not part of the official repositories. If you have a problem or a question, please contact the package maintainer. | **Distro** | **Maintainer** | **Package** | | :--------- | :---------------- | :--------------------------------------- | | Arch Linux | Felix Yan | `sudo pacman -S papirus-icon-theme` [[link](https://www.archlinux.org/packages/community/any/papirus-icon-theme/)] | | Arch Linux | Edgard Castro | [papirus-icon-theme-git](https://aur.archlinux.org/packages/papirus-icon-theme-git/) AUR | | Fedora | Dirk Davidis | [papirus-icon-theme](https://copr.fedorainfracloud.org/coprs/dirkdavidis/papirus-icon-theme/) copr | | Manjaro | Nikola Yanev | [papirus-icon-theme](http://download.tuxfamily.org/gericom/README.html) | | openSUSE | Konstantin Voinov | [papirus-icon-theme](https://software.opensuse.org/download.html?project=home:kill_it&package=papirus-icon-theme) OBS [[link](https://build.opensuse.org/package/show/home:kill_it/papirus-icon-theme)] | | Solus | Joshua Strobl | `sudo eopkg install papirus-icon-theme` | **NOTE:** If you are a maintainer and want to be in the list, please create an issue or make a pull request. ## Hardcoded icons Some software uses an absolute path instead of the icon name in a .desktop file or in the source code which makes them unthemable. ### Hardcoded application icons To deal with hardcoded application icons we recommend using [hardcode-fixer](https://github.com/Foggalong/hardcode-fixer). Papirus supports most of the applications in the [list](https://github.com/Foggalong/hardcode-fixer/blob/master/tofix.csv). If [hardcode-fixer](https://github.com/Foggalong/hardcode-fixer) doesn't support your favorite app yet, please open an issue [here](https://github.com/Foggalong/hardcode-fixer/issues) or edit your .desktop file manually. ### Hardcoded tray icons To fix hardcoded tray icons Papirus supports [Hardcode-Tray](https://github.com/bil-elmoussaoui/Hardcode-Tray) script. A list of supported applications is available [here](https://github.com/bil-elmoussaoui/Hardcode-Tray/tree/master/data/database). **NOTE:** To get Papirus to work right with Hardcode-Tray, use the hardcode-tray option `--conversion-tool RSVGConvert`: ``` sudo -E hardcode-tray --conversion-tool RSVGConvert --size 22 --theme Papirus ``` **Size recommendations:** - Unity 22px - KDE 22px - GNOME 22px ([see](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info) - XFCE 24px ([see](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info) - Pantheon 24px ![hardcode-tray](http://i.imgur.com/6hFm6aj.png) **BUGS ON Plasma Desktop**: KDE Developers don't want fix wrong rendering tray icons for non-Qt apps (libappindicator, mono and etc...). After applying hardcode-tray - icons will be blurred! See more info [here](https://bugs.kde.org/show_bug.cgi?id=366062) and please vote for this bug. ## KDE colorscheme Support for monochrome icons for KDE colorscheme is now available: - Papirus - for dark plasma theme & light color scheme - Papirus Dark - for dark plasma theme & color scheme - Papirus Light - for light plasma theme & color scheme ![kde-color-scheme](http://i.imgur.com/oM1qhQH.png) **NOTE:** Non-KDE apps don't support KDE colorscheme on the system tray, but you can replace color manually. ## Folder's color Papirus has [Folder Color](http://foldercolor.tuxfamily.org/) v0.0.80+ support that allows you to change a color of a folder. Available colors: ![Folder Color Preview](https://i.imgur.com/eX534ao.png) For KDE, colors of individual folders can be changed using [dolphin-folder-color](https://github.com/audoban/dolphin-folder-color). Also, you can use our [papirus-folders](https://github.com/PapirusDevelopmentTeam/papirus-folders) script to apply the color of folders system-wide. ## Extras - [Papirus theme for LibreOffice](https://github.com/PapirusDevelopmentTeam/papirus-libreoffice-theme) - [Papirus themes for FileZilla](https://github.com/PapirusDevelopmentTeam/papirus-filezilla-themes) - [Papirus theme for SMPlayer](https://github.com/PapirusDevelopmentTeam/papirus-smplayer-theme) - [Papirus themes for Claws Mail](https://github.com/PapirusDevelopmentTeam/papirus-claws-mail-theme) - [Papirus theme for aMule](https://github.com/PapirusDevelopmentTeam/papirus-amule-theme) ## Recommendations - For GTK, better use icons alongside GTK theme [Arc Themes](https://github.com/horst3180/arc-theme) or [Adapta Themes](https://github.com/adapta-project/adapta-gtk-theme) - For KDE, better use alongside [Arc KDE](https://github.com/PapirusDevelopmentTeam/arc-kde) or [Adapta KDE](https://github.com/PapirusDevelopmentTeam/adapta-kde) ## Manual fixes