WhiteSur Icons by @vinceliuice · Any WM / DE on Any distro

01. Overview & Architecture

Profile: 2024.04.08

Schema validatedSource pinned

Purpose: macOS Big Sur style icon theme for Linux desktops.
Compatibility: Any distro (Server: BOTH)
Desktop Part: Icon themes
Window Manager & Theme: Any WM / DE / macOS-like

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.

Origingithub.com/vinceliuice/WhiteSur-icon-themePinned to 73d8040da51a · reviewed in this config file

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: whitesur-icon-theme (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/vinceliuice/WhiteSur-icon-theme ~/0xtsoa-review/vinceliuice-whitesur-icon-theme# 1. clone to a review folder

$git -C ~/0xtsoa-review/vinceliuice-whitesur-icon-theme checkout --detach 73d8040da51a9ed74e47c7366e7e9ff437601a5c# 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 whitesur-icon-theme (AUR)

Shell commands

$yay -S whitesur-icon-theme # 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/vinceliuice/whitesur-icon-theme/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

04. Documentation & Guide

Source: vinceliuice/WhiteSur-icon-themeRef: 73d8040da5

README.md|GitHub Flavored Markdown

Raw Source ↗

WhiteSur Icon Theme

MacOS Big Sur like icon theme for linux desktops

Donate

If you like my project, you can buy me a coffee:

Install tips

Usage: ./install.sh [OPTIONS...]

OPTIONS:
-d, --dest	Specify theme destination directory (Default: $HOME/.local/share/icons)
-n, --name	Specify theme name (Default: WhiteSur)
-t, --theme	Specify theme color variant(s) [default/purple/pink/red/orange/yellow/green/grey/all] (Default: blue)
-a, --alternative	Install alternative icons (redesigned MacOS default icons)
-b, --bold	Install bold panel icons version
-p, --kde-plasma	Replace Apple logo with KDE Plasma logo
-r,--remove,-u,--uninstall	Uninstall (remove) icon themes
-h, --help	Show this help

Note for snaps: To use these icons with snaps, the best way is to make a copy of the application's .desktop located in /var/lib/snapd/desktop/applications/name-of-the-snap-application.desktop into $HOME/.local/share/applications/. Then use any text editor and change the "Icon=" to "Icon=name-of-the-icon.svg"

For more information, run: ./install.sh --help

Bold version suggested use in High resolution display like 4k display with 200% scale!

Requirement

You can use this with:

GTK theme

WhiteSur-gtk-theme: https://github.com/vinceliuice/WhiteSur-gtk-theme

KDE theme

WhiteSur-kde: https://github.com/vinceliuice/WhiteSur-kde

Preview

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