mirror of
https://github.com/PapirusDevelopmentTeam/papirus-folders.git
synced 2024-09-19 11:08:48 -04:00
142 lines
16 KiB
Markdown
142 lines
16 KiB
Markdown
# Papirus Folders
|
|
|
|
papirus-folders is a handy bash script that lets you change the colors of folders in the [Papirus icon theme](https://github.com/PapirusDevelopmentTeam/papirus-icon-theme) and similar themes based on version 20171007 or newer. It's an easy way to customize how your folders look.
|
|
|
|
## 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)
|
|
- [Related projects](#related-projects)
|
|
- [Donate](#donate)
|
|
|
|
## Preview
|
|
|
|
| Name | Preview | Name | Preview |
|
|
|:-----|:-------:|:-----|:-------:|
|
|
| **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** |    |
|
|
|
|
> [!IMPORTANT]
|
|
> 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
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-folders-install | sh
|
|
```
|
|
|
|
To install papirus-folders to **home directory** using the following command:
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-folders-install | env PREFIX=$HOME/.local sh
|
|
```
|
|
|
|
To install papirus-folders on **BSD systems** using the following command:
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-folders-install | env PREFIX=/usr/local sh
|
|
```
|
|
|
|
#### Uninstall
|
|
|
|
```
|
|
wget -qO- https://git.io/papirus-folders-install | env uninstall=true 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-folders/versions) to find out package versions.
|
|
|
|
| **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` |
|
|
| 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> |
|
|
| Void Linux | Benjamín Albiñana | `sudo xbps-install -S papirus-folders` |
|
|
|
|
|
|
> [!NOTE]
|
|
> If you are a maintainer and want to be in the list, please create an issue or make a pull request.
|
|
|
|
### 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
|
|
|
|
```
|
|
papirus-folders -Ru
|
|
```
|
|
|
|
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).
|
|
|
|
|
|
## 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)
|
|
Dolphin contextual menu for coloring a selected folders | [Dolphin Folder Color](https://github.com/audoban/dolphin-folder-color)
|
|
|
|
## Donate
|
|
|
|
If you would like to support development by making one-time donation or by becoming a supporter, please visit our page on [Buy Me a Coffee](https://www.buymeacoffee.com/papirus).
|
|
|
|
<a href="https://www.buymeacoffee.com/papirus"><img alt="Buy me a coffee" src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=papirus&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
|