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)
- ePapirus (for elementary OS and Pantheon Desktop, light theme)
- ePapirus Dark (for elementary OS and Pantheon Desktop, dark theme)
- Installation
- Hardcoded icons
- KDE colorscheme
- Folder color
- Extras
- Recommendations
- Manual fixes
- Icon request
- Contributing
- Donate
- License
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
sudo apt-get install epapirus-icon-theme # ePapirus, and ePapirus-Dark for elementaryOS onlyor download .deb packages from here.
Note
Now the daily builds of the papirus-icon-themes package are placed in ppa:papirus/papirus-dev.
Debian users can also install Papirus from our PPA, but the command line instructions differ:
sudo sh -c "echo 'deb http://ppa.launchpad.net/papirus/papirus/ubuntu jammy main' > /etc/apt/sources.list.d/papirus-ppa.list"
sudo wget -qO /etc/apt/trusted.gpg.d/papirus-ppa.asc 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x9461999446FAF0DF770BFC9AE58A9D36647CAE7F'
sudo apt-get update
sudo apt-get install papirus-icon-themeUse 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 toDESTDIR=/usr/share/icons)EXTRA_THEMES- additional icon themes that you want to install alongside the base Papirus icon theme (Defaults toEXTRA_THEMES="ePapirus ePapirus-Dark Papirus-Dark Papirus-Light")TAG- a branch or tag if you want to install a specific version of the icon theme (Defaults toTAG=master)
Important
Use the exact same command to update icon themes.
wget -qO- https://git.io/papirus-icon-theme-install | sh
wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="$HOME/.icons" sh
wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="$HOME/.local/share/icons" sh
wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="/usr/local/share/icons" sh
Use this interactive script to completely remove Papirus icon theme from your system.
wget -qO- https://git.io/papirus-icon-theme-uninstall | sh
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.
| Distro | Maintainer | Package |
|---|---|---|
| Alpine Linux | David Demelier | sudo apk add papirus-icon-theme [link] |
| ALT Linux | Andrey Cherepanov | apt-get install papirus-icon-theme [link] |
| Arch Linux | Felix Yan | sudo pacman -S papirus-icon-theme community |
| Arch Linux | Mark Wagie | papirus-icon-theme-git AUR |
| Debian 9+ | Yangfl | sudo apt install papirus-icon-theme |
| Debian | only_vip | papirus-icon-theme MPR |
| Fedora 27+ | Robert-André Mauchin | sudo dnf install papirus-icon-theme |
| FreeBSD | Hiroki Tagato | papirus-icon-theme freshports |
| Gentoo | Marco Scardovi | sudo emerge -a papirus-icon-theme |
| NixOS | Nixpkgs Contributors | nix-env -iA nixos.papirus-icon-theme |
| OpenBSD | David Demelier | doas pkg_add papirus-icon-theme |
| openSUSE | Matthias Eliasson | papirus-icon-theme official |
| ROSA Linux | Vladimir Penchikov | sudo urpmi papirus-icon-theme |
| Solus | Joshua Strobl | sudo eopkg it papirus-icon-theme |
| Ubuntu 18.04+ | Yangfl | sudo apt install papirus-icon-theme |
| Void Linux | Giuseppe Fierro | sudo xbps-install -S papirus-icon-theme |
Note
If you are a maintainer and want to be on this list, please create an issue or make a pull request.
Some software uses an absolute path instead of an icon name in a .desktop file or in the source code which makes them unthemable.
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.
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: 24px
- 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
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.
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)
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.
- Papirus themes for FileZilla
- Papirus theme for SMPlayer
- Papirus themes for Claws Mail
- Papirus themes for Thunderbird
- Papirus theme for aMule
-
Papirus users are expected to have Breeze installed if they use Plasma and/or any KDE applications
-
The same applies to ePapirus and the Elementary icon theme when using the Pantheon desktop, as the icon parity between the themes are not full
-
We recommend the following GTK themes to use with Papirus icons:
-
For KDE Plasma 5, our recommendations are:
For Pop!_OS users
For Pop!_OS users who want to use the Pop!_Shop icon (instead of the default Elementary Appcentre icon):
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
For Cinnamon users
For Cinnamon users who want to use Papirus icon theme with Arc theme we recommend fixing the color icons on panel:
sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/cinnamon/cinnamon.css
To deal with blurry panel icons, increase the panel size to 30px in Systems Settings → Panel (see the screenshot).
For GNOME Shell users
For GNOME users we recommend installing the following extensions:
- (K)StatusNotifierItem/AppIndicator Support ¹ — This extension integrates AppIndicators.
- Dash to Dock ¹
- No Symbolic Icons
- Status Area Horizontal Spacing
¹ On Ubuntu 18.04+ it is pre-installed.
For Xfce users
Here are a few recommendations for Xfce users.
Go to Edit → Preferences.... Click on Side Pane tab. Under Side Pane, look for Icon Size and set to Very Small.
Go to Settings Manager → Panel → Items tab. Select Notification Area item and click on Edit currently selected item button. Under Appearance set the following options:
- Set
Maximum icon size (px)to24 - Uncheck
Show frame
For elementary/Pantheon users
With light wallpaper, we recommend disabling the use-transparency option on wingpanel:
gsettings set org.pantheon.desktop.wingpanel use-transparency false
For better representation we recommend using only the light eGTK Theme:
echo "export GTK_THEME=elementary" >> ~/.profile
Restart the system to apply new changes .
For LXQt users
Here are a few recommendations for LXQt users.
Go to Edit → Preferences. Click on Display section. On Icons category change size to 16x16 for Size of side pane icons.
Configure Panel and set 16px for Icon size.
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
Example
- App Name: Forkgram
- Icon Name: forkgram
- Description: Forkgram is the fork of the official Telegram Desktop application
- Webpage (optional): https://github.com/Forkgram/tdesktop
- Original Icon:
Warning
We do NOT support Windows/Wine/Proton/Crossover or other NON-NATIVE Linux apps & games. However, pull requests adding those will be considered.
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.
- detailed icon design notes
- our wiki, which dives deeper into various topics
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.
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.
