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 )
2021-07-21 09:08:44 -04:00
- [Related projects ](#related-projects )
2017-11-07 07:09:08 -05:00
## Preview
| Name | Preview | Name | Preview |
|:-----|:-------:|:-----|:-------:|
2023-05-24 13:16:44 -04:00
| **adwaita** |    | **black** |    |
| **blue** |    | **bluegrey** |    |
| **breeze** |    | **brown** |    |
| **carmine** |    | **cyan** |    |
| **darkcyan** |    | **deeporange** |    |
| **green** |    | **grey** |    |
| **indigo** |    | **magenta** |    |
| **nordic** |    | **orange** |    |
| **palebrown** |    | **paleorange** |    |
| **pink** |    | **red** |    |
| **teal** |    | **violet** |    |
| **white** |    | **yaru** |    |
| **yellow** |    |
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 ).
## 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
```
2019-12-19 11:22:58 -05:00
wget -qO- https://git.io/papirus-folders-install | sh
2017-11-07 07:09:08 -05:00
```
2022-07-25 11:09:20 -04:00
To install papirus-folders to **home directory** using the following command:
```
wget -qO- https://git.io/papirus-folders-install | env PREFIX=$HOME/.local sh
```
2017-11-07 12:46:10 -05:00
To install papirus-folders on **BSD systems** using the following command:
```
2019-12-19 11:22:58 -05:00
wget -qO- https://git.io/papirus-folders-install | env PREFIX=/usr/local sh
2017-11-07 12:46:10 -05:00
```
2017-11-07 07:09:08 -05:00
#### Uninstall
```
2019-12-19 11:22:58 -05:00
wget -qO- https://git.io/papirus-folders-install | 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
2019-05-30 02:40:54 -04:00
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-folders/versions ) to find out package versions.
2017-11-28 01:41:30 -05:00
2023-08-02 03:11:08 -04:00
| **Distro** | **Maintainer** | **Package** |
| :--------- | :---------------- | :----------- |
| Arch Linux | Piotr Górski | [papirus-folders-git ](https://aur.archlinux.org/packages/papirus-folders-git ) < sup > AUR</ sup > |
| MX Linux | Steven Pusser | `sudo apt-get install papirus-folders` |
| NetBSD | Nia Alarie | [papirus-folders ](http://pkgsrc.se/graphics/papirus-folders ) < sup > pkgsrc</ sup > |
| NixOS | Alexandre Acebedo | `nix-env -iA nixos.papirus-folders` |
2020-11-12 14:06:34 -05:00
| openSUSE | andy great | [papirus-folders ](https://software.opensuse.org/package/papirus-folders ) < sup > OBS [[link ](https://build.opensuse.org/package/show/openSUSE:Factory/papirus-folders )]</ sub > |
2019-05-30 02:40:54 -04:00
| Void Linux | Benjamín Albiñana | `sudo xbps-install -S papirus-folders` |
2018-11-30 15:50:58 -05:00
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).
2021-07-21 09:08:44 -04:00
## Related projects
Use case | Tool
--- | ---
Graphical user interface for papirus-folders | [papirus-folders-gui ](https://github.com/ItzSelenux/papirus-folders-gui )
Graphical application for generating folders icon with to your own colors or with presets for popular themes | [Oomox theme designer ](https://github.com/themix-project/oomox )
A context menu for Nautilus, Nemo or Caja File Browser for changing the color of an individual folder | [Folder Color ](http://foldercolor.tuxfamily.org )
2021-09-27 02:56:55 -04:00
Dolphin contextual menu for coloring a selected folders | [Dolphin Folder Color ](https://github.com/audoban/dolphin-folder-color )
