2017-11-07 07:09:08 -05:00
# Papirus Folders
2018-09-10 01:58:27 -04:00
papirus-folders is a bash script that allows changing the color of folders in [Papirus icon theme ](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme ) and its forks (which based on version 20171007 and newer).
2017-11-07 07:09:08 -05:00
2018-09-10 01:58:27 -04:00
## Table of contents
- [Preview ](#preview )
- [Installation ](#installation )
- [Ubuntu and derivatives ](#ubuntu-and-derivatives )
- [Papirus Installer ](#papirus-installer )
- [Third-party packages ](#third-party-packages )
- [Script usage ](#script-usage )
2017-11-07 07:09:08 -05:00
## Preview
| Name | Preview | Name | Preview |
|:-----|:-------:|:-----|:-------:|
2018-12-11 11:51:13 -05:00
| **black** | ![folder-black ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-black.svg ) ![user-black-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-black-home.svg ) ![folder-black-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-black-download.svg ) | **blue** | ![folder-blue ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-blue.svg ) ![user-blue-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-blue-home.svg ) ![folder-blue-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-blue-download.svg ) |
| **bluegrey** | ![folder-bluegrey ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-bluegrey.svg ) ![user-bluegrey-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-bluegrey-home.svg ) ![folder-bluegrey-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-bluegrey-download.svg ) | **brown** | ![folder-brown ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-brown.svg ) ![user-brown-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-brown-home.svg ) ![folder-brown-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-brown-download.svg ) |
2019-04-17 05:58:34 -04:00
| **cyan** | ![folder-cyan ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-cyan.svg ) ![user-cyan-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-cyan-home.svg ) ![folder-cyan-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-cyan-download.svg ) | **deeporange** | ![folder-deeporange ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-deeporange.svg ) ![user-deeporange-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-deeporange-home.svg ) ![folder-deeporange-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-deeporange-download.svg ) |
| **green** | ![folder-green ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-green.svg ) ![user-green-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-green-home.svg ) ![folder-green-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-green-download.svg ) | **grey** | ![folder-grey ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-grey.svg ) ![user-grey-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-grey-home.svg ) ![folder-grey-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-grey-download.svg ) |
| **indigo** | ![folder-indigo ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-indigo.svg ) ![user-indigo-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-indigo-home.svg ) ![folder-indigo-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-indigo-download.svg ) | **magenta** | ![folder-magenta ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-magenta.svg ) ![user-magenta-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-magenta-home.svg ) ![folder-magenta-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-magenta-download.svg ) |
| **orange** | ![folder-orange ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-orange.svg ) ![user-orange-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-orange-home.svg ) ![folder-orange-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-orange-download.svg ) | **pink** | ![folder-pink ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-pink.svg ) ![user-pink-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-pink-home.svg ) ![folder-pink-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-pink-download.svg ) |
| **red** | ![folder-red ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-red.svg ) ![user-red-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-red-home.svg ) ![folder-red-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-red-download.svg ) | **teal** | ![folder-teal ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-teal.svg ) ![user-teal-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-teal-home.svg ) ![folder-teal-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-teal-download.svg ) |
| **violet** | ![folder-violet ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-violet.svg ) ![user-violet-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-violet-home.svg ) ![folder-violet-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-violet-download.svg ) | **white** | ![folder-white ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-white.svg ) ![user-white-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-white-home.svg ) ![folder-white-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-white-download.svg ) |
| **yellow** | ![folder-yellow ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-yellow.svg ) ![user-yellow-home ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/user-yellow-home.svg ) ![folder-yellow-download ](https://cdn.jsdelivr.net/gh/PapirusDevelopmentTeam/papirus-icon-theme@master/Papirus/48x48/places/folder-yellow-download.svg )
2017-11-07 07:09:08 -05:00
**NOTE:** This project doesn't provide any folder icons. If you want to request a new folder icon or a new color of folder please open an issue [here ](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme/issues/new ).
2019-01-19 11:22:38 -05:00
**NOTE:** If you want to change the color of folders to your own or use presets for popular themes, see [Oomox theme designer ](https://github.com/themix-project/oomox ).
2018-09-10 01:58:27 -04:00
**NOTE:** To change the color of an individual folder you can use [Folder Color ](http://foldercolor.tuxfamily.org ) or [Dolphin Folder Color ](https://github.com/audoban/dolphin-folder-color ).
2017-11-07 07:09:08 -05:00
## Installation
### Ubuntu and derivatives
You can install papirus-folders 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-folders
```
or download .deb packages from [here ](https://launchpad.net/~papirus/+archive/ubuntu/papirus/+packages?field.name_filter=papirus-folders ).
### Papirus Installer
Use the script to install the latest version directly from this repo (independently on your distro):
#### Install
```
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-folders/master/install.sh | sh
```
2017-11-07 12:46:10 -05:00
To install papirus-folders on **BSD systems** using the following command:
```
2018-10-28 14:39:45 -04:00
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-folders/master/install.sh | env PREFIX=/usr/local sh
2017-11-07 12:46:10 -05:00
```
2017-11-07 07:09:08 -05:00
#### Uninstall
```
2018-09-30 16:28:01 -04:00
wget -qO- https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-folders/master/install.sh | env uninstall=true sh
2017-11-07 07:09:08 -05:00
```
2017-11-28 01:41:30 -05:00
2018-04-12 14:42:47 -04:00
### Third-party packages
2017-11-28 01:41:30 -05: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.
2018-11-30 15:50:58 -05:00
| **Distro** | **Maintainer** | **Package** |
| :--------- | :------------- | :----------- |
| Arch Linux | Piotr Górski | [papirus-folders-git ](https://aur.archlinux.org/packages/papirus-folders-git ) < sup > AUR</ sup > |
| NetBSD | nia | [papirus-folders ](http://pkgsrc.se/graphics/papirus-folders ) < sup > pkgsrc</ sup > |
| openSUSE | Alexander Ahjolinna | [papirus-folders ](https://software.opensuse.org/download.html?project=home:ahjolinna&package=papirus-folders ) < sup > OBS [[link ](https://build.opensuse.org/package/show/home:ahjolinna/papirus-folders )]</ sub > |
2017-11-28 01:41:30 -05:00
**NOTE:** If you are a maintainer and want to be in the list, please create an issue or make a pull request.
2018-09-10 01:58:27 -04:00
### Script usage
Papirus-folders doesn't have a GUI, but it is a fully functional command-line application with TAB-completions. Below you'll see some examples of use.
#### Show the current color and available colors for Papirus-Dark
```
papirus-folders -l --theme Papirus-Dark
```
#### Change color of folders to brown for Papirus-Dark
```
papirus-folders -C brown --theme Papirus-Dark
```
#### Revert to default color of folders for Papirus-Dark
```
papirus-folders -D --theme Papirus-Dark
```
#### Restore the last used color from a config file
```
2018-10-29 04:45:02 -04:00
papirus-folders -Ru
2018-09-10 01:58:27 -04:00
```
The last command is extremely useful for restoring color after icon theme upgrade (official installers of [papirus-icon-theme ](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme ) and some third-party packages do this automatically).