2016-06-15 02:12:40 -04:00
< p align = "center" >
2016-11-27 07:49:57 -05:00
< img src = "https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/preview.png" alt = "preview" / >
2016-06-15 02:12:40 -04:00
< / p >
2016-11-29 06:40:43 -05:00
2016-11-29 08:33:13 -05:00
< p align = "center" >
2017-09-01 01:51:25 -04:00
< img alt = "apps" src = "https://img.shields.io/badge/apps_icons-3000%2B-5294e2.svg?style=flat-square" / >
2017-02-25 18:03:06 -05:00
< img alt = "actions" src = "https://img.shields.io/badge/actions_icons-1700%2B-5294e2.svg?style=flat-square" / >
< img alt = "panel" src = "https://img.shields.io/badge/panel_icons-1600%2B-5294e2.svg?style=flat-square" / >
< img alt = "places" src = "https://img.shields.io/badge/places_icons-880%2B-5294e2.svg?style=flat-square" / >
2016-11-29 08:33:13 -05:00
< / p >
2016-11-29 06:27:27 -05:00
2017-02-25 18:03:06 -05:00
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 ).
2017-09-24 01:42:56 -04:00
Papirus icon theme is available in six variants:
2017-02-25 18:03:06 -05:00
2017-09-24 01:42:56 -04:00
- Papirus (for Arc Darker)
- Papirus Dark (for Arc Dark)
2017-10-04 05:10:02 -04:00
- Papirus Light (light theme with Breeze colors)
2017-09-24 01:42:56 -04:00
- Papirus Adapta (for Adapta)
- Papirus Adapta Nokto (for Adapta Nokto)
2017-02-25 18:03:06 -05:00
- ePapirus (for elementary OS and Pantheon Desktop)
## Installation
2017-06-13 14:42:17 -04:00
### Ubuntu and derivatives
2017-02-25 18:03:06 -05:00
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 ).
2017-06-13 14:42:17 -04:00
### Debian and derivatives
2017-06-10 09:44:26 -04:00
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
```
2017-06-13 14:42:17 -04:00
### Papirus Installer
2017-02-25 18:03:06 -05:00
2017-09-22 13:12:21 -04:00
Use the scripts to install the latest version directly from this repo (independently of your distro):
2017-02-25 18:03:06 -05:00
**NOTE:** Use the same script to update icon themes.
2017-08-20 02:45:41 -04:00
#### ROOT directory (recommended)
2016-10-26 03:56:01 -04:00
2016-06-05 18:29:32 -04:00
```
2016-11-27 07:49:57 -05:00
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-root.sh | sh
2016-06-15 02:12:40 -04:00
```
2017-02-25 18:03:06 -05:00
#### HOME directory for GTK
2016-11-11 05:21:32 -05:00
```
2016-11-27 07:49:57 -05:00
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-gtk.sh | sh
2016-11-11 05:21:32 -05:00
```
2016-11-27 07:49:57 -05:00
2017-02-25 18:03:06 -05:00
#### HOME directory for KDE
2016-11-27 07:49:57 -05:00
```
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-kde.sh | sh
```
2017-02-25 18:03:06 -05:00
**NOTE:** Qt4 apps require `libqt4-svg` to work correctly.
#### Remove
2016-11-10 08:21:14 -05:00
2016-11-11 06:08:58 -05:00
```
2016-11-27 07:49:57 -05:00
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/remove-papirus.sh | sh
2016-11-11 06:08:58 -05:00
```
2017-06-13 14:42:17 -04:00
### Unofficial packages
2017-01-18 11:22:36 -05:00
2017-09-22 13:12:21 -04:00
Packages in this section are not part of the official repositories. If you have a problem or a question, please contact the package maintainer.
2017-01-10 07:48:04 -05:00
2017-08-19 08:23:46 -04:00
| **Distro** | **Maintainer** | **Package** |
| :--------- | :---------------- | :--------------------------------------- |
2017-03-04 17:49:00 -05:00
| Arch Linux | Edgard Castro | [papirus-icon-theme-git ](https://aur.archlinux.org/packages/papirus-icon-theme-git/ ) < sup > AUR</ sup > |
2017-03-06 15:06:29 -05:00
| Arch Linux | Josip Ponjavic | [papirus-icon-theme-git ](https://software.opensuse.org/download.html?project=home:metakcahura&package=papirus-icon-theme-git ) < sup > OBS [[link ](https://build.opensuse.org/package/show/home:metakcahura/papirus-icon-theme-git )]</ sub > |
2017-03-04 17:49:00 -05:00
| Fedora | Dirk Davidis | [papirus-icon-theme ](https://copr.fedorainfracloud.org/coprs/dirkdavidis/papirus-icon-theme/ ) < sup > copr</ sup > |
2017-02-20 04:27:53 -05:00
| Manjaro | Nikola Yanev | [papirus-icon-theme ](http://download.tuxfamily.org/gericom/README.html ) |
2017-03-04 17:49:00 -05:00
| openSUSE | Konstantin Voinov | [papirus-icon-theme ](https://software.opensuse.org/download.html?project=home:kill_it&package=papirus-icon-theme ) < sup > OBS [[link ](https://build.opensuse.org/package/show/home:kill_it/papirus-icon-theme )]</ sub > |
2017-08-19 08:23:46 -04:00
| Solus | Joshua Strobl | `sudo eopkg install papirus-icon-theme` |
2017-01-10 07:48:04 -05:00
2017-09-22 13:12:21 -04:00
**NOTE:** If you are a maintainer and want to be in the list, please create an issue or make a pull request.
2017-06-13 05:49:38 -04:00
2017-08-24 16:17:09 -04:00
## Hardcoded icons
2016-10-26 03:57:18 -04:00
2017-09-22 13:12:21 -04:00
Some software uses an absolute path instead of the icon name in a .desktop file or in the source code which makes them unthemable.
2017-08-24 16:17:09 -04:00
### Hardcoded application icons
2017-09-22 13:12:21 -04:00
To deal with hardcoded application icons we recommend using [harcode-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 [harcode-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.
2017-08-24 16:17:09 -04:00
### 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 ).
2016-10-26 03:56:01 -04:00
2017-09-21 05:09:38 -04:00
**NOTE:** To get Papirus to work right with Hardcode-Tray, use the hardcode-tray option `--conversion-tool RSVGConvert` :
2017-02-25 18:03:06 -05:00
2016-12-13 04:06:59 -05:00
```
2017-09-24 01:58:42 -04:00
sudo -E hardcode-tray --conversion-tool RSVGConvert --size 22 --theme Papirus
2016-12-29 21:13:59 -05:00
```
2017-10-02 14:09:57 -04:00
2017-09-24 01:58:42 -04:00
**Size recommendations:**
- Unity 22px
- KDE 22px
2017-10-02 14:09:57 -04:00
- GNOME 22px ([see](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info)
2017-09-24 02:01:16 -04:00
- XFCE 24px ([see](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info)
2017-09-24 01:58:42 -04:00
- Pantheon 24px
2017-02-25 18:03:06 -05:00
2017-04-30 16:59:26 -04:00
![hardcode-tray ](http://i.imgur.com/6hFm6aj.png )
2016-11-08 05:26:56 -05:00
2017-06-13 14:42:17 -04:00
## KDE colorscheme
2017-02-25 18:03:06 -05:00
Support for monochrome icons for KDE colorscheme is now available:
2017-01-04 05:13:55 -05:00
- Papirus - for dark plasma theme & light color scheme
2017-01-05 04:47:27 -05:00
- Papirus Dark - for dark plasma theme & color scheme
- Papirus Light - for light plasma theme & color scheme
2016-12-08 06:59:59 -05:00
2017-04-30 16:59:26 -04:00
![kde-color-scheme ](http://i.imgur.com/oM1qhQH.png )
2016-11-22 01:35:42 -05:00
2017-09-22 13:12:21 -04:00
**NOTE:** Non-KDE apps don't support KDE colorscheme on the system tray, but you can replace color manually.
2017-02-25 18:03:06 -05:00
2017-06-13 14:42:17 -04:00
## Folder's color
2016-12-29 22:14:37 -05:00
2017-09-22 15:20:22 -04:00
Papirus has [Folder Color ](http://foldercolor.tuxfamily.org/ ) v0.0.80+ support that allows you to change a color of a folder.
2017-01-05 04:47:27 -05:00
2017-02-25 18:03:06 -05:00
Available colors:
2017-10-06 06:29:09 -04:00
![Folder Color Preview ](https://i.imgur.com/HIMQArn.png )
2017-02-25 18:03:06 -05:00
2017-09-22 15:20:22 -04:00
For KDE, colors of individual folders can be changed using [dolphin-folder-color ](https://github.com/audoban/dolphin-folder-color ).
2017-09-22 15:12:37 -04:00
2017-10-05 12:13:09 -04:00
**NOTE:** Currently, there is no easy way to change the global color of folders. You may edit the themes by yourself if you wish.
2017-05-15 11:45:57 -04:00
2017-02-25 18:03:06 -05:00
## 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 )
2017-06-23 15:35:58 -04:00
- [Papirus themes for Claws Mail ](https://github.com/PapirusDevelopmentTeam/papirus-claws-mail-theme )
2017-09-20 16:14:14 -04:00
- [Papirus theme for aMule ](https://github.com/PapirusDevelopmentTeam/papirus-amule-theme )
2017-02-25 18:03:06 -05:00
## Recommendations
2017-09-24 01:42:56 -04:00
- 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 )
2016-11-22 01:35:42 -05:00
2017-02-25 18:03:06 -05:00
## Manual fixes
< details >
< summary > For Cinnamon users< / summary >
2017-09-24 08:35:56 -04:00
For Cinnamon users who want to use Papirus icon theme with [arc-theme ](https://github.com/horst3180/arc-theme ) we recommend fix color icons on panel:
2017-02-25 18:03:06 -05:00
2016-12-10 09:51:32 -05:00
```
2016-12-10 13:03:21 -05:00
sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/cinnamon/cinnamon.css
2016-12-10 09:51:32 -05:00
```
2017-04-30 16:59:26 -04:00
![Cinnamon Arc-Dark theme fix ](http://i.imgur.com/XXejgtD.png )
2017-02-25 18:03:06 -05:00
2017-10-02 14:09:57 -04:00
To deal with blurred panel icons, increase the panel size up to 30px in `Systems Settings` → `Panel` (see [screenshot ](https://i.imgur.com/oToRBYv.png )).
2017-02-25 18:03:06 -05:00
< / details >
2017-07-11 02:14:56 -04:00
< details >
< summary > For GNOME 3 users< / summary >
2017-10-02 14:09:57 -04:00
For GNOME users who want use Papirus icon theme with [arc-theme ](https://github.com/horst3180/arc-theme ), we recommend change icons color for panel:
2017-07-11 02:14:56 -04:00
```
sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/gnome-shell/gnome-shell.css
```
2017-10-02 14:09:57 -04:00
![GNOME Arc-Dark theme fix ](http://i.imgur.com/5Mb2HRs.png )
2017-07-11 02:14:56 -04:00
Also, we recommend using [AppIndicator/KStatusNotifierItem Support ](https://extensions.gnome.org/extension/615/appindicator-support/ ) extension for appindicator-apps, because patched version of sni-qt for hardcode-tray doesn't work without that on gnome-shell.
To fix tiny icons size of the extension use the following command (details [rgcjonas/gnome-shell-extension-appindicator#68 ](https://github.com/rgcjonas/gnome-shell-extension-appindicator/issues/68 )):
```
sed -i.orig '/indicator, icon_size/a icon_size += 8;' ~/.local/share/gnome-shell/extensions/appindicatorsupport@rgcjonas.gmail.com/appIndicator.js
```
< / details >
2017-02-25 18:03:06 -05:00
< details >
< summary > For Unity users< / summary >
2016-12-10 09:51:32 -05:00
2017-09-22 13:12:21 -04:00
For Unity users, we recommend installing patched [Notify-OSD ](https://launchpad.net/~leolik/+archive/ubuntu/leolik ) and changing the icon size to 33px.
2016-12-18 23:56:27 -05:00
2017-02-25 18:03:06 -05:00
*~/.notify-osd* file:
2016-12-10 09:51:32 -05:00
```
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
```
2017-02-25 18:03:06 -05:00
2017-04-30 16:59:26 -04:00
![notify-fix ](http://i.imgur.com/hjTpvca.png )
2016-12-10 09:51:32 -05:00
2017-02-25 18:03:06 -05:00
Also, you can change [Unity launcher icon ](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/tree/master/Papirus/extra/unity ) and [unity-tweak-tool icons ](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/tree/master/Papirus/extra/unity-tweak-tool ). Look into the extra folder in the icon theme.
< / details >
2017-04-30 16:33:34 -04:00
< details >
< summary > For Xfce users< / summary >
2017-09-22 13:12:21 -04:00
Here are a few recommendations for Xfce users.
2017-04-30 16:33:34 -04:00
#### Thunar File Manager
Go to `Edit` → `Preferences...` . Click on `Side Pane` tab. Under `Side Pane` , look for `Icon Size` and set to `Very Small` .
![thunar-prefecences ](http://i.imgur.com/Iu1TIEa.png )
#### Notification Area
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)` to `24`
- Uncheck `Show frame`
![xfce4-notification-area ](http://i.imgur.com/MopCZBZ.png )
< / details >
2017-02-25 18:03:06 -05:00
## Icon request
2016-12-10 09:51:32 -05:00
2016-11-24 01:39:22 -05:00
- Application name
- Icon name (see desktop-file option **Icon** on `/usr/share/applications` )
- Original icon image
2017-02-25 18:03:06 -05:00
## Contribute
2017-09-22 13:12:21 -04:00
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:
2017-02-25 18:03:06 -05:00
- new icons for missing applications
- symbolic links to an existing icon
- resolving open issues
- spelling, grammar, phrasing
- improvements to our scripts
2017-09-22 13:12:21 -04:00
Inside [tools/work ](tools/work ) you will find a step-by-step guide, an environment, and tools that will help you:
2017-02-25 18:03:06 -05:00
- [create a new icon ](tools/work#create-a-new-icon ) from template
- [make a symlink to an existing icon ](tools/work#make-symlinks-to-an-existing-icon )
- [edit an existing icon ](tools/work#edit-an-existing-icon )
2017-09-22 13:12:21 -04:00
- convert your icon to all variants of the theme
2017-02-25 18:03:06 -05:00
We are waiting for your pull requests and would love to see this icon theme become as complete as possible.
## Donate
2016-12-11 02:54:15 -05:00
2016-10-26 03:56:01 -04:00
< span class = "paypal" > < a href = "https://www.paypal.me/varlesh" title = "Donate to this project using Paypal" > < img src = "https://www.paypalobjects.com/webstatic/mktg/Logo/pp-logo-100px.png" alt = "PayPal donate button" / > < / a > < / span >
2017-02-25 18:03:06 -05:00
BTC: `1HwE62Zb8PyyY1XAR6Ykweix2ht8NAjvf5`
2017-02-19 17:19:25 -05:00
2017-02-25 18:03:06 -05:00
## License
2016-11-24 01:52:33 -05:00
2017-02-25 18:03:06 -05:00
GNU LGPL v3.0