mirror of
https://github.com/PapirusDevelopmentTeam/papirus-icon-theme.git
synced 2024-10-18 09:10:34 -04:00
337 lines
14 KiB
Markdown
337 lines
14 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/github/search/PapirusDevelopmentTeam/papirus-icon-theme/extension:svg%20path:Papirus/48x48/apps?label=apps%20icons&style=flat-square&colorB=5294e2"/>
|
|
<img alt="actions" src="https://img.shields.io/github/search/PapirusDevelopmentTeam/papirus-icon-theme/extension:svg%20path:Papirus/22x22/actions?label=actions%20icons&style=flat-square&colorB=5294e2"/>
|
|
<img alt="panel" src="https://img.shields.io/github/search/PapirusDevelopmentTeam/papirus-icon-theme/extension:svg%20path:Papirus/22x22/panel?label=panel%20icons&style=flat-square&colorB=5294e2"/>
|
|
<img alt="places" src="https://img.shields.io/github/search/PapirusDevelopmentTeam/papirus-icon-theme/extension:svg%20path:Papirus/48x48/places?label=places%20icons&style=flat-square&colorB=5294e2"/>
|
|
<img alt="mimetypes" src="https://img.shields.io/github/search/PapirusDevelopmentTeam/papirus-icon-theme/extension:svg%20path:Papirus/48x48/mimetypes?label=mimetypes%20icons&style=flat-square&colorB=5294e2"/>
|
|
</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
|
|
- Papirus Dark
|
|
- Papirus Light
|
|
- ePapirus (for elementary OS and Pantheon Desktop)
|
|
|
|
## Contents
|
|
|
|
- [Installation](#installation)
|
|
- [Ubuntu and derivatives](#ubuntu-and-derivatives)
|
|
- [Debian and derivatives](#debian-and-derivatives)
|
|
- [Papirus Installer](#papirus-installer)
|
|
- [Third-party packages](#third-party-packages)
|
|
- [Hardcoded icons](#hardcoded-icons)
|
|
- [Hardcoded application icons](#hardcoded-application-icons)
|
|
- [Hardcoded tray icons](#hardcoded-tray-icons)
|
|
- [Steam runtime icons](#steam-runtime-icons)
|
|
- [KDE colorscheme](#kde-colorscheme)
|
|
- [Folder's color](#folders-color)
|
|
- [Extras](#extras)
|
|
- [Recommendations](#recommendations)
|
|
- [Manual fixes](#manual-fixes)
|
|
- [Icon request](#icon-request)
|
|
- [Contributing](#contributing)
|
|
- [Donate](#donate)
|
|
- [License](#license)
|
|
|
|
## 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).
|
|
|
|
**NOTE:** Now the daily builds of the papirus-icon-themes package are placed in [`ppa:papirus/papirus-dev`](https://launchpad.net/~papirus/+archive/ubuntu/papirus-dev).
|
|
|
|
### 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 sh -c "echo 'deb http://ppa.launchpad.net/papirus/papirus/ubuntu focal 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://git.io/papirus-icon-theme-install | sh
|
|
```
|
|
|
|
#### HOME directory for GTK
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-icon-theme-install | DESTDIR="$HOME/.icons" sh
|
|
```
|
|
|
|
#### HOME directory for KDE
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-icon-theme-install | DESTDIR="$HOME/.local/share/icons" sh
|
|
```
|
|
|
|
#### \*BSD systems
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-icon-theme-install | env DESTDIR="/usr/local/share/icons" sh
|
|
```
|
|
|
|
#### Uninstall
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-icon-theme-uninstall | sh
|
|
```
|
|
|
|
### Third-party packages
|
|
|
|
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](https://repology.org/project/papirus-icon-theme/versions) to find out package versions.
|
|
|
|
| **Distro** | **Maintainer** | **Package** |
|
|
| :------------ | :------------------- | :--------------------------------------- |
|
|
| ALT Linux | Andrey Cherepanov | `apt-get install papirus-icon-theme` <sup>[[link](https://packages.altlinux.org/en/Sisyphus/srpms/papirus-icon-theme)]</sup> |
|
|
| Arch Linux | Felix Yan | `sudo pacman -S papirus-icon-theme` <sup>community</sup> |
|
|
| Arch Linux | Mohammadreza Abdollahzadeh | [papirus-icon-theme-git](https://aur.archlinux.org/packages/papirus-icon-theme-git/) <sup>AUR</sup> |
|
|
| Debian 9+ | Yangfl | `sudo apt install papirus-icon-theme` |
|
|
| Fedora 27+ | Robert-André Mauchin | `sudo dnf install papirus-icon-theme` |
|
|
| Fedora | Dirk Davidis | [papirus-icon-theme](https://copr.fedorainfracloud.org/coprs/dirkdavidis/papirus-icon-theme/) <sup>copr</sup> |
|
|
| FreeBSD | Hiroki Tagato | [papirus-icon-theme](https://www.freshports.org/x11-themes/papirus-icon-theme) <sup>freshports</sup> |
|
|
| Gentoo | Mikle Kolyada | `sudo emerge -a papirus-icon-theme` |
|
|
| NetBSD | Nia Alarie | [papirus-icon-theme](http://pkgsrc.se/graphics/papirus-icon-theme) <sup>pkgsrc</sup> |
|
|
| NixOS | Nixpkgs Contributors | `nix-env -iA nixos.papirus-icon-theme` |
|
|
| 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> |
|
|
| openSUSE | Matthias Eliasson | [papirus-icon-theme](https://software.opensuse.org/package/papirus-icon-theme) <sup>official</sup> |
|
|
| 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 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](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 [hardcode-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.
|
|
|
|
### 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).
|
|
|
|
**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](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info)
|
|
- XFCE 22px ([see](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme#manual-fixes) for more info)
|
|
- Pantheon 24px
|
|
- Cinnamon 16px
|
|
- LXQt 16px
|
|
|
|
|
|
|
|
|
|
**NOTE**: Some Electron-based applications have blurred tray icon on KDE (see [bug report](https://bugs.kde.org/show_bug.cgi?id=366062)). To solve this issue pass the following environment variable to the app: `XDG_CURRENT_DESKTOP=Unity wire-desktop`
|
|
|
|
### Steam runtime icons
|
|
|
|
To fix icons of running Steam games, you can use [Steam Icons Fixer](https://github.com/BlueManCZ/SIF) script, that will connect all icons available from our icon theme with your installed games.
|
|
|
|
## 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
|
|
|
|
|
|
|
|
**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](http://foldercolor.tuxfamily.org/) 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](https://github.com/audoban/dolphin-folder-color).
|
|
|
|
Also, you can use our [papirus-folders](https://github.com/PapirusDevelopmentTeam/papirus-folders) script to apply the color of folders system-wide.
|
|
|
|
## 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)
|
|
- [Papirus themes for Thunderbird](https://github.com/PapirusDevelopmentTeam/thunderbird-theme-papirus)
|
|
- [Papirus theme for aMule](https://github.com/PapirusDevelopmentTeam/papirus-amule-theme)
|
|
|
|
## Recommendations
|
|
|
|
- Recommended use Papirus icons alongside one of the following GTK themes:
|
|
- [Arc theme](https://github.com/jnsh/arc-theme)
|
|
- [Materia theme](https://github.com/nana-4/materia-theme)
|
|
- For KDE, our recommendation is:
|
|
- [Arc KDE](https://github.com/PapirusDevelopmentTeam/arc-kde)
|
|
- [Materia KDE](https://github.com/PapirusDevelopmentTeam/materia-kde)
|
|
|
|
## Manual fixes
|
|
|
|
<details>
|
|
<summary>For Cinnamon users</summary>
|
|
|
|
For Cinnamon users who want to use Papirus icon theme with [Arc theme](https://github.com/jnsh/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
|
|
```
|
|
|
|
|
|
|
|
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)).
|
|
</details>
|
|
|
|
<details>
|
|
<summary>For GNOME Shell users</summary>
|
|
|
|
For GNOME users we recommend install the following extensions:
|
|
|
|
- [(K)StatusNotifierItem/AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/) **¹** — This extension integrates AppIndicators.
|
|
- [Dash to Dock](https://extensions.gnome.org/extension/307/dash-to-dock/) **¹**
|
|
- [No Symbolic Icons](https://extensions.gnome.org/extension/1304/no-symbolic-icons/)
|
|
- [Status Area Horizontal Spacing](https://extensions.gnome.org/extension/355/status-area-horizontal-spacing/)
|
|
|
|
**¹** On Ubuntu 18.04+ it is pre-installed.
|
|
</details>
|
|
|
|
<details>
|
|
<summary>For Xfce users</summary>
|
|
|
|
Here are a few recommendations 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`.
|
|
|
|
|
|
|
|
#### 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`
|
|
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary>For elementary/Pantheon users</summary>
|
|
|
|
With light wallpaper, we recommend disable `use-transparency` option on wingpanel:
|
|
|
|
```
|
|
gsettings set org.pantheon.desktop.wingpanel use-transparency false
|
|
```
|
|
|
|
For better representation we recommend use only light eGTK Theme:
|
|
|
|
```
|
|
echo "export GTK_THEME=elementary" >> ~/.profile
|
|
```
|
|
Restart System.
|
|
</details>
|
|
|
|
<details>
|
|
<summary>For LXQt users</summary>
|
|
|
|
Here are a few recommendations for LXQt users.
|
|
|
|
#### PCManFM-Qt File Manager
|
|
|
|
Go to `Edit` → `Preferences`. Click on `Display` section. On `Icons` category change size to `16x16` for `Size of side pane icons`.
|
|
|
|
|
|
|
|
#### Monochrome Panel Plugins
|
|
|
|
`Configure Panel` and set `16px` for `Icon size`.
|
|
|
|
|
|
|
|
</details>
|
|
|
|
## Icon request
|
|
|
|
- Application name
|
|
- Icon name (see desktop-file option **Icon** on `/usr/share/applications`)
|
|
- Original icon image
|
|
- Use tray? Tray icon name. Hardcoded?
|
|
- Small description and/or a link to the official webpage
|
|
|
|
**NOTE**: We do NOT support Windows/Wine/Proton/Crossover or other NOT native Linux-apps & games. 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](tools/work) you will find a step-by-step guide, an environment, and tools that will 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 of the theme
|
|
|
|
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:
|
|
|
|
- Patreon: https://www.patreon.com/varlesh
|
|
- PayPal: https://www.paypal.me/varlesh
|
|
|
|
## License
|
|
|
|
Papirus icon theme distributed under the terms of the GNU General Public License, version 3. See the [`LICENSE`](LICENSE) file for details.
|