01. Overview & Architecture

Schema validatedSource pinned
Purpose
Catppuccin-colored folders for the Papirus icon theme.
Compatibility
Any distro (Server: BOTH)
Desktop Part
Icon themes
Window Manager & Theme
Any WM / DE / Catppuccin

02. Installation & Deployment

Before you installThis changes your desktop configuration and installs packages. Run it as your normal user, never with sudo: it asks for sudo only where a step needs it (listed below).The guided installer shows its plan first. Files it would replace are kept unless you approve. Everything it copies, clones or appends to in your home folder is backed up and verified first, and --rollback restores it. Packages, sudo changes and the other commands listed under Impact are not undone.
IntegrityEach release from main builds the installers in GitHub Actions and signs them with a GitHub build attestation. Verify your download against the repository, not this website (Option B, step 2). If it does not verify, don't run it.
ImpactPackages: papirus-folders-catppuccin-git (some from the Arch AUR)
RecoveryGuided: backups in ~/.local/state/0xtsoa/backups/, undo with bash install.sh --rollback.Manual: the steps below only write in the download folder or run listed commands.
Option A: manual installAdvanced
Read the source at the reviewed commit, back up, then run each step yourself.
$git clone https://github.com/catppuccin/papirus-folders ~/0xtsoa-review/catppuccin-papirus-folders# 1. clone to a review folder
$git -C ~/0xtsoa-review/catppuccin-papirus-folders checkout --detach f83671d17ea67e335b34f8028a7e6d78bca735d7# 2. the reviewed commit
Then the steps. Package commands are written for Arch; on other distros use your package manager.

Step-by-step deployment protocol

Step-by-step deployment
1Install papirus-folders-catppuccin-git (AUR)
$yay -S papirus-folders-catppuccin-git # AUR
$# Other distros: see the upstream README
Option B: guided installerRecommended
The same steps as one script for any distro. It shows the plan first, keeps files you already have unless you approve replacing them, and backs up everything it changes in your home folder. Never pipe it into a shell.
$curl -fsSLo install.sh 'https://www.0xtsoa.dev/configs/catppuccin/papirus-folders/install.sh'# 1. download
$gh attestation verify install.sh --repo nyharena25/0xTsoa --signer-workflow nyharena25/0xTsoa/.github/workflows/attest-installers.yml# 2. verify (GitHub CLI 2.49+, signed in)
$less install.sh# 3. read it
$bash install.sh --dry-run# 4. preview: changes nothing
$bash install.sh# 5. install (asks first)
$bash install.sh --rollback# undo the file changes
View script in browserOther options: --force (replace conflicts, backed up first), --yes, --help

03. Screenshot Gallery // Catppuccin Papirus Folders

Capture 01 // Fullscreen
Catppuccin Papirus Folders screenshot 1
01 / 11

04. Documentation & Guide

Source: catppuccin/papirus-foldersRef: f83671d17e
README.md|GitHub Flavored Markdown

Logo
Catppuccin for Papirus Folders

Stargazers

Previews

🌻 Latte
🪴 Frappé
🌺 Macchiato
🌿 Mocha

Usage

  1. Make sure You have Papirus Icon Theme installed

  2. Clone this repository and change to cloned directory:

    git clone https://github.com/catppuccin/papirus-folders.git
    cd papirus-folders
    
  3. Copy content of src to /usr/share/icons/Papirus/:

    sudo cp -r src/* /usr/share/icons/Papirus  
    
  4. Install papirus-folders script from Papirus Icon Theme:

    curl -LO https://raw.githubusercontent.com/PapirusDevelopmentTeam/papirus-folders/master/papirus-folders && chmod +x ./papirus-folders
    
  5. Use this script to set color of the folders, for example:

    ./papirus-folders -C cat-mocha-blue --theme Papirus-Dark
    
  6. To check all available colors:

    ./papirus-folders -l
    

    all colors are named as cat-"flavour"-"colour"

    for example:

    cat-latte-lavender, cat-frappe-green, cat-macchiato-red...

  7. Visit Papirus-folders to learn more about this script

For Arch Linux Users

With your favorite AUR helper, install with:

yay -S papirus-folders-catppuccin-git

then you could run papirus-folders -h to see all available command. Bash & ZSH completions are included.

 

💝 Thanks to

Copyright © 2021-present Catppuccin Org

GitHub Flavored Markdown (github-markdown-css)README snapshot at f83671d17e