Papirus icon theme for Linux
Clone or download

README.md

preview

apps actions panel places

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 others.

Papirus icon theme is available in four variants:

  • Papirus
  • Papirus Dark
  • Papirus Light
  • ePapirus (for elementary OS and Pantheon Desktop)

Contents

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

or download .deb packages from here.

Debian and derivatives

Debian users also can install Papirus from our PPA, but the commands will differ:

sudo sh -c "echo 'deb http://ppa.launchpad.net/papirus/papirus/ubuntu bionic main' > /etc/apt/sources.list.d/papirus-ppa.list"

sudo apt-get install dirmngr
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.sh | sh

HOME directory for GTK

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install.sh | DESTDIR="$HOME/.icons" sh

HOME directory for KDE

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install.sh | DESTDIR="$HOME/.local/share/icons" sh

*BSD systems

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install.sh | env DESTDIR="/usr/local/share/icons" sh

NOTE: Qt4 apps require libqt4-svg to work correctly.

Uninstall

wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/uninstall.sh | sh

Third-party 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
ALT Linux Andrey Cherepanov apt-get install papirus-icon-theme [link]
Arch Linux Felix Yan sudo pacman -S papirus-icon-theme [link]
Arch Linux Edgard Castro papirus-icon-theme-git AUR
Debian 10+ Yangfl sudo apt install papirus-icon-theme [sid]
Fedora Dirk Davidis papirus-icon-theme copr
Manjaro Nikola Yanev papirus-icon-theme
openSUSE Konstantin Voinov papirus-icon-theme OBS [link]
openSUSE Matthias Eliasson papirus-icon-theme official
ROSA Linux Vladimir Penchikov sudo urpmi papirus-icon-theme
Solus Joshua Strobl sudo eopkg install papirus-icon-theme
Ubuntu 18.04+ Yangfl sudo apt 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. 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.

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 for more info)
  • XFCE 22px (see for more info)
  • Pantheon 24px
  • Cinnamon 16px

hardcode-tray

BUG on KDE with libappindicator: Some applications have wrong rendering by default on KDE. For solve this run application with Unity environment option.

For example:

XDG_CURRENT_DESKTOP=Unity wire-desktop

See more info here 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

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 v0.0.80+ support that allows you to change a color of a folder.

Available colors:

Folder Color Preview

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

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

Extras

Recommendations

Manual fixes

For Cinnamon users

For Cinnamon users who want to use Papirus icon theme with Arc theme we recommend fix color icons on panel:

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

Cinnamon Arc-Dark theme fix

To deal with blurred panel icons, increase the panel size up to 30px in Systems SettingsPanel (see screenshot).

For GNOME Shell users

For GNOME users who want use Papirus icon theme with Arc theme, we recommend change icons color for panel:

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

Translucent panel on Adapta Nokto Gnome Shell theme:

sudo sed -i.orig '/panel:overview/ s/rgba(19, 25, 28, 0.01)/rgba(19, 25, 28, 0.7)/g' /usr/share/themes/Adapta-Nokto/gnome-shell/gnome-shell.css

Also, we recommend install the following extensions:

¹ On Ubuntu 18.04+ it is pre-installed.

For Unity users

For Unity users, we recommend installing patched Notify-OSD and changing the icon size to 33px.

~/.notify-osd file:

slot-allocation = dynamic
bubble-expire-timeout = 10sec
bubble-vertical-gap = 10px
bubble-horizontal-gap = 10px
bubble-corner-radius = 24px
bubble-icon-size = 33px
bubble-gauge-size = 6px
bubble-width = 240px
bubble-background-color = 2f343f
bubble-background-opacity = 95%
text-margin-size = 10px
text-title-size = 100%
text-title-weight = bold
text-title-color = adb7bf
text-title-opacity = 100%
text-body-size = 90%
text-body-weight = normal
text-body-color = eaeaea
text-body-opacity = 100%
text-shadow-opacity = 50%
location = 1
bubble-prevent-fade = 1
bubble-close-on-click = 1
bubble-as-desktop-bg = 0

notify-fix

Also, you can change Unity launcher icon and unity-tweak-tool icons. Look into the extra folder in the icon theme.

For Xfce users

Here are a few recommendations for Xfce users.

Thunar File Manager

Go to EditPreferences.... Click on Side Pane tab. Under Side Pane, look for Icon Size and set to Very Small.

thunar-prefecences

Notification Area

Go to Settings ManagerPanelItems tab. Select Notification Area item and click on Edit currently selected item button. Under Appearance set the following options:

  • Set Maximum icon size (px) to 24
  • Uncheck Show frame

xfce4-notification-area

For elementary/Pantheon users

With light wallpaper, we recommend disable use-transparency option on wingpanel:

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

Icon request

  • Application name
  • Icon name (see desktop-file option Icon on /usr/share/applications)
  • Original icon image
  • Small description and/or a link to the official webpage

NOTE: We do NOT support Windows/Wine/Crossover or other NOT native Linux-apps. This also applies to discontinued projects!!

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 your pull request:

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

Inside tools/work you will find a step-by-step guide, an environment, and tools that will help you:

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

Donate

You can support this open source project by making a voluntary payment:

License

Papirus icon theme distributed under the terms of the GNU General Public License, version 3. See the LICENSE file for details.