Shell sed Makefile
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

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 six variants:

  • Papirus (for Arc / 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:

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 xenial main' > /etc/apt/sources.list.d/papirus-ppa.list"

sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com E58A9D36647CAE7F
sudo apt-get update
sudo apt-get install papirus-icon-theme

NOTE: If you get a error like this when running the 2nd command:

gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory
gpg: connecting dirmngr at '/tmp/apt-key-gpghome.n6DTgEC7J8/S.dirmngr' failed: No such file or directory
gpg: keyserver receive failed: No dirmngr

You need to run sudo apt-get install dirmngr and try running the 2nd command again.

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 | 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
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 Themes / new upstream Arc Themes 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 3 users

For GNOME users who want use Papirus icon theme with Arc Themes / new upstream Arc Themes, 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 using AppIndicator/KStatusNotifierItem Support extension for appindicator-apps, because patched version of sni-qt for hardcode-tray doesn't work without that on gnome-shell.

And:

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 use non-transparency 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!!

Contribute

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 is licensed under GNU GPL v3.0