mirror of
https://github.com/PapirusDevelopmentTeam/papirus-icon-theme.git
synced 2024-10-19 09:40:47 -04:00
316 lines
12 KiB
Markdown
316 lines
12 KiB
Markdown
<p align="center">
|
|
<img src="https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/preview.png" alt="preview"/>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img alt="apps" src="https://img.shields.io/badge/apps_icons-2700%2B-5294e2.svg?style=flat-square"/>
|
|
<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"/>
|
|
</p>
|
|
|
|
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).
|
|
|
|
Papirus icon theme is available in four variants:
|
|
|
|
- Papirus (for a light theme with a dark panel)
|
|
- Papirus Dark
|
|
- Papirus Light
|
|
- ePapirus (for elementary OS and Pantheon Desktop)
|
|
|
|
## Installation
|
|
|
|
### Ubuntu and derivatives
|
|
|
|
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).
|
|
|
|
### Debian and derivatives
|
|
|
|
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
|
|
```
|
|
|
|
|
|
### Papirus Installer
|
|
|
|
Use the scripts to install the latest version directly from this repo (independently on 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-papirus-root.sh | sh
|
|
```
|
|
#### HOME directory for GTK
|
|
|
|
```
|
|
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-gtk.sh | sh
|
|
```
|
|
|
|
#### HOME directory for KDE
|
|
|
|
```
|
|
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/install-papirus-home-kde.sh | sh
|
|
```
|
|
|
|
**NOTE:** Qt4 apps require `libqt4-svg` to work correctly.
|
|
|
|
#### Remove
|
|
|
|
```
|
|
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-icon-theme/master/remove-papirus.sh | sh
|
|
```
|
|
|
|
### Unofficial packages
|
|
|
|
Packages in this section are not part of the official repositories. If you have a trouble or a question please contact with package maintainer.
|
|
|
|
| **Distro** | **Maintainer** | **Package** |
|
|
|:-----------|:------------------|:------------|
|
|
| Arch Linux | Edgard Castro | [papirus-icon-theme-git](https://aur.archlinux.org/packages/papirus-icon-theme-git/) <sup>AUR</sup> |
|
|
| 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> |
|
|
| Fedora | Dirk Davidis | [papirus-icon-theme](https://copr.fedorainfracloud.org/coprs/dirkdavidis/papirus-icon-theme/) <sup>copr</sup> |
|
|
| Manjaro | Nikola Yanev | [papirus-icon-theme](http://download.tuxfamily.org/gericom/README.html) |
|
|
| 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> |
|
|
| Solus | Joshua Strobl | `sudo eopkg install papirus-icon-theme` |
|
|
|
|
**NOTE:** If you maintainer and want be in the list please create an issue or send a pull request.
|
|
|
|
## Hardcoded tray icons
|
|
|
|
Papirus icon theme now supports [Hardcode-Tray](https://github.com/bil-elmoussaoui/Hardcode-Tray) script
|
|
|
|
**NOTE:** To get Papirus to work right with Hardcode-Tray, use the hardcode-tray option `--conversion-tool Inkscape`:
|
|
|
|
```
|
|
hardcode-tray --conversion-tool Inkscape
|
|
```
|
|
|
|
![hardcode-tray](http://i.imgur.com/6hFm6aj.png)
|
|
|
|
## 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](http://i.imgur.com/oM1qhQH.png)
|
|
|
|
**NOTE:** Non-KDE apps don't support KDE colorscheme on the system tray, but you can replace color by manually.
|
|
|
|
<details>
|
|
<summary>What colors are used for monochrome icons on KDE?</summary>
|
|
|
|
**Papirus**:
|
|
- actions, devices, places
|
|
- class: **ColorScheme-Text** color: `#5c616c`
|
|
- class: **ColorScheme-Highlight** color: `#5294e2`
|
|
- panel
|
|
- class: **ColorScheme-ButtonBackground** color: `#d3dae3`
|
|
- class: **ColorScheme-Highlight** color: `#5294e2`
|
|
|
|
**Papirus-Dark**:
|
|
- actions, devices, places and panel
|
|
- class: **ColorScheme-Text** color: `#d3dae3`
|
|
- class: **ColorScheme-Highlight** color: `#5294e2`
|
|
|
|
**Papirus-Light**:
|
|
- actions, devices, places and panel
|
|
- class: **ColorScheme-Text** color: `#5c616c`
|
|
- class: **ColorScheme-Highlight** color: `#5294e2`
|
|
</details>
|
|
|
|
## Folder's color
|
|
|
|
Papirus has [Folder colors](http://foldercolor.tuxfamily.org/) support that allows you to change a global color of folders or just one of them.
|
|
|
|
Available colors:
|
|
|
|
![Folder Color Preview](http://i.imgur.com/JSIa5WD.png)
|
|
|
|
For KDE, colors of individual folders can be changed using [dolphin-folder-color](https://github.com/audoban/dolphin-folder-color)
|
|
<details>
|
|
<summary>Caveats for using dolphin-folder-color</summary>
|
|
|
|
- The flags of the `kdialog` command used by the scripts varies by version. Some newer versions lack the `--caption` and `--geometry` flags. You may need to edit the script files manually so that they can be successfully run.
|
|
- Papirus icon theme does not have the same color set as the default Breeze theme, so one or two of the colors may not work.
|
|
|
|
</details>
|
|
|
|
Currently, there is no easy way to change the global color of folders in KDE. You may edit the themes by yourself if you wish.
|
|
|
|
## 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)
|
|
- [Papirus themes for Claws Mail](https://github.com/PapirusDevelopmentTeam/papirus-claws-mail-theme)
|
|
|
|
## Recommendations
|
|
|
|
- For GTK, better use icons alongside GTK theme [Arc Theme](https://github.com/horst3180/arc-theme)
|
|
- For KDE, better use alongside [Arc KDE](https://github.com/PapirusDevelopmentTeam/arc-kde)
|
|
|
|
## Manual fixes
|
|
|
|
<details>
|
|
<summary>For Cinnamon users</summary>
|
|
|
|
For Cinnamon users who want use Papirus icon theme with [arc-theme](https://github.com/horst3180/arc-theme), we recommend the following combinations:
|
|
|
|
**light theme**
|
|
|
|
- Window borders `Arc` or `Arc-Darker`
|
|
- Icons `ePapirus`
|
|
- Controls `Arc` or `Arc-Darker`
|
|
- Desktop `Arc` or `Arc-Dark`
|
|
|
|
**dark theme**
|
|
|
|
- Window borders `Arc-Dark`
|
|
- Icons `Papirus-Dark`
|
|
- Controls `Arc-Dark`
|
|
- Desktop `Arc-Dark` with an another color for tray icons:
|
|
|
|
```
|
|
sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/cinnamon/cinnamon.css
|
|
```
|
|
|
|
![Cinnamon Arc-Dark theme fix](http://i.imgur.com/XXejgtD.png)
|
|
|
|
Also, increase panel size with `Allow Cinnamon to scale panel text and icons according to the panel height` option because Papirus contains only 22px and 24px panel's icons.
|
|
</details>
|
|
|
|
<details>
|
|
<summary>For GNOME 3 users</summary>
|
|
|
|
For Gnome users who want use Papirus icon theme with [arc-theme](https://github.com/horst3180/arc-theme), we recommend
|
|
use [TopIcons Plus](https://extensions.gnome.org/extension/1031/topicons/) extension with icon size **22px** or **24px**
|
|
|
|
And change icons color for panel:
|
|
```
|
|
sudo sed -i.orig 's/white/#d3dae3/g' /usr/share/themes/Arc-Dark/gnome-shell/gnome-shell.css
|
|
```
|
|
![Gnome Arc-Dark theme fix](http://i.imgur.com/5Mb2HRs.png)
|
|
|
|
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>
|
|
|
|
<details>
|
|
<summary>For Unity users</summary>
|
|
|
|
For Unity users, we recommend installing patched [Notify-OSD](https://launchpad.net/~leolik/+archive/ubuntu/leolik) and change an 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](http://i.imgur.com/hjTpvca.png)
|
|
|
|
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>
|
|
|
|
<details>
|
|
<summary>For Xfce users</summary>
|
|
|
|
Here is a few recommendation for Xfce users.
|
|
|
|
#### 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>
|
|
|
|
## Icon request
|
|
|
|
- Application name
|
|
- Icon name (see desktop-file option **Icon** on `/usr/share/applications`)
|
|
- Original icon image
|
|
|
|
## Contribute
|
|
|
|
We welcome user contributions. If you don't know where to start, we've compiled a list of things they 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](tools/work) you find a step-by-step guide, an environment, and tools that help you:
|
|
|
|
- [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)
|
|
- convert your icon to all variants the theme
|
|
|
|
We are waiting for your pull requests and would love to see this icon theme become as complete as possible.
|
|
|
|
## Donate
|
|
|
|
<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>
|
|
|
|
BTC: `1HwE62Zb8PyyY1XAR6Ykweix2ht8NAjvf5`
|
|
|
|
## License
|
|
|
|
GNU LGPL v3.0
|