PapirusDevelopmentTeam/papirus-icon-theme

Papirus is a free and open source SVG icon theme for Linux, based on Paper Icon Set with a lot of new icons and a few extras, like Hardcode-Tray support, KDE colorscheme support, Folder Color support, and a few others.

Android version available here.

Papirus icon theme is available in five variants:

• Papirus (base variant)
• Papirus Dark (for dark themes)
• Papirus Light (for light themes)

Contents

• Installation
  • Ubuntu and derivatives
  • Papirus Installer
  • Snap
  • Third-party packages
• Hardcoded icons
  • Hardcoded application icons
  • Hardcoded tray icons
  • Steam runtime icons
• KDE colorscheme
• Folder color
• Extras
• Recommendations
• Manual fixes
• Icon request
• Contributing
• Donate
• License

Installation

Ubuntu and derivatives

You can install Papirus from our official PPA:

sudo add-apt-repository ppa:papirus/papirus
sudo apt-get update
sudo apt-get install papirus-icon-theme  # Papirus, Papirus-Dark, and Papirus-Light

or download .deb packages from here.

[!NOTE] Now the daily builds of the papirus-icon-themes package are placed in ppa:papirus/papirus-dev.

Papirus Installer

Use the script to install the latest version directly from the master branch of this repo (this method does not depend on your distribution).

Find the install script here or proceed with command-line instructions below.

You can set environment variables to control WHERE, WHAT, and FROM WHERE you install Papirus:

• DESTDIR - the destination directory for installing icon themes (Defaults to DESTDIR=/usr/share/icons)
• EXTRA_THEMES - additional icon themes that you want to install alongside the base Papirus icon theme (Defaults to EXTRA_THEMES="Papirus-Dark Papirus-Light")
• TAG - a branch or tag if you want to install a specific version of the icon theme (Defaults to TAG=master)

[!IMPORTANT] Use the exact same command to update icon themes.

ROOT directory (recommended)

wget -qO- https://git.io/papirus-icon-theme-install | sh

HOME directory for GTK

wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="$HOME/.icons" sh

HOME directory for KDE

wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="$HOME/.local/share/icons" sh

*BSD systems

wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="/usr/local/share/icons" sh

Uninstall

Use this interactive script to completely remove Papirus icon theme from your system.

wget -qO- https://git.io/papirus-icon-theme-uninstall | sh

Snap

Third-party packages

Packages listed in this section are third-party packages. If you have a problem or a question, please contact the package maintainer.

Please note that some packages in the list may be outdated, open Repology to find out package versions.

[!NOTE] If you are a maintainer and want to be on this list, please create an issue or make a pull request.

Hardcoded icons

Some software uses an absolute path instead of an 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. Papirus supports most of the applications in the list. If hardcode-fixer doesn't support your favorite app yet, please open an issue here or edit your .desktop file manually.

Hardcoded tray icons

To fix hardcoded tray icons Papirus supports Hardcode-Tray script. A list of supported applications is available here.

[!IMPORTANT] 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 for more info)
• XFCE: 22px (see for more info)
• Pantheon: 24px
• Cinnamon: 16px
• LXQt: 16px

[!NOTE] Some Electron-based applications have blurred tray icon on KDE (see bug report). To solve this issue pass the following environment variable to the app: XDG_CURRENT_DESKTOP=Unity wire-desktop

Steam runtime icons

To fix icons of running Steam games, you can use the Steam Icons Fixer script, that will apply all available icons from our icon theme to your installed games.

KDE colorscheme

[!NOTE] This is probably depreciated with Plasma 6. Choose Papirus variant according to your color scheme because some symbolic icons are not recolorable.

Support for monochrome icons for KDE colorscheme is now available:

• Papirus - for dark Plasma theme (light panel icons) & light color scheme (dark action icons)
• Papirus Dark - for dark plasma theme & color scheme (all icons are light)
• Papirus Light - for light plasma theme & color scheme (all icons are dark)

Folder color

Papirus has Folder Color v0.0.80+ support that allows you to change a color of a folder.

Available colors:

For KDE, colors of individual folders can be changed using dolphin-folder-color.

Also, you can use our papirus-folders script to change the color of folders system-wide.

Extras

• Papirus themes for FileZilla
• Papirus theme for SMPlayer
• Papirus themes for Claws Mail
• Papirus themes for Thunderbird
• Papirus theme for aMule

Recommendations

• Papirus users are expected to have Breeze installed if they use Plasma and/or any KDE applications

• We recommend the following GTK themes to use with Papirus icons:

  • Arc theme
  • Materia theme

• For KDE Plasma 5, our recommendations are:

  • Arc KDE
  • Materia KDE

Manual fixes

mkdir -p ~/.local/share/applications/
cp /usr/share/applications/io.elementary.appcenter.desktop ~/.local/share/applications/
desktop-file-edit --set-icon=pop-shop ~/.local/share/applications/io.elementary.appcenter.desktop

sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/cinnamon/cinnamon.css

gsettings set org.pantheon.desktop.wingpanel use-transparency false

echo "export GTK_THEME=elementary" >> ~/.profile

Icon request

Requirements:

• Application name
• Icon name (see the application's desktop file property Icon in /usr/share/applications)
• Original icon image, an icon that is used by the upstream
• Does it have system tray icons? Provide tray icon names. Are they hardcoded (i.e. referenced by a file path instead of an icon name)?
• Small description and/or a link to the official webpage/repository of the project

[!WARNING] We do NOT support Windows/Wine/Proton/Crossover or other NON-NATIVE Linux apps & games. However, pull requests adding those will be considered.

Contributing

We welcome user contributions. If you don't know where to start, we've compiled a list of things we would like to see in new pull requests:

• new icons for missing applications
• symbolic links to existing icons
• resolving open issues
• improving our documentation
• spelling, grammar, phrasing improvements
• improvements to our scripts

Inside tools/work you will find:

• extensive design notes for the Papirus icon theme
• a working environment
• template files you can adapt for new icons
• scripts and tools for automating the entire design workflow:
  • creating new icons
  • editing existing icons
  • symlinks to existing icons
  • preparing/cleaning edited icons so they're ready to commit
  • testing that the theme is right before you commit
• a step-by-step guide to the scripted workflow

We are waiting for your pull requests and would love to see this icon theme become as complete as possible.

How to design icons

• detailed icon design notes
• our wiki, which dives deeper into various topics

Donate

If you would like to support the development by making a one-time donation or by becoming a supporter, please visit our page on Buy Me a Coffee.

License

Papirus icon theme is a free and open source project distributed under the terms of the GNU General Public License, version 3. See the LICENSE file for details.

Every logo in this icon theme is owned by the respective trademark holder. We have not received approval to create these logos from any of the trademark owners, and the existence of an icon in this repository is in no way supported by the trademark owner.

Where possible, we stayed true to the branding and official guidelines.

If you are a trademark holder or an application owner for one of these applications and disapprove of the icons we have created for your application, please open an issue in this repository.