🍎 Kali Linux KDE macOS Theme Installer

Author: ussu321
Repository: Mac-Linux-
Version: 2.0
License: MIT

A fully automated, error-free bash script that transforms your Kali Linux KDE Plasma desktop into a macOS Big Sur / Monterey look using the popular WhiteSur theme suite.

---

✨ Features

• Zero-touch automation — installs themes, icons, cursors, and configures everything
• Kali Linux optimized — uses Kali/Debian compatible packages (apt)
• KDE Plasma native — proper KWin, Kvantum, and Plasma global theme integration
• GTK2/3/4 sync — consistent theming across Qt and GTK applications
• Plank dock — macOS-style dock with auto-start configuration
• Safe & reversible — backs up existing configs before overwriting
• Error handling — set -e with informative messages and fallbacks

---

📦 What Gets Installed

Component	Source	Description
WhiteSur KDE	vinceliuice/WhiteSur-kde	Plasma global theme, Aurorae window decorations, Kvantum style, color scheme
WhiteSur Icons	vinceliuice/WhiteSur-icon-theme	macOS Big Sur style icon set (dark variant)
WhiteSur Cursors	vinceliuice/WhiteSur-cursors	macOS-style mouse cursor theme
Plank	Debian repos	Lightweight macOS-style dock
Kvantum	Debian repos	SVG-based Qt theme engine
Fonts	Debian repos	Noto Sans & Roboto for clean typography

---

🚀 Quick Start

1. Download the script

curl -O https://raw.githubusercontent.com/ussu321/Analysis-of-Algorithms/main/install-macos-theme.sh

2. Make it executable

chmod +x install-macos-theme.sh

3. Run it

./install-macos-theme.sh

⚠️ Note: The script will ask for sudo privileges to install system packages. Theme files themselves are installed per-user (~/.config, ~/.local).

---

🖥️ Requirements

• OS: Kali Linux (or any Debian-based distribution)
• Desktop: KDE Plasma 5.x (installed via kde-standard if missing)
• Network: Internet connection for cloning GitHub repos
• Disk: ~500 MB free space for themes and dependencies

---

⚙️ Post-Installation

After running the script, log out and log back in (or reboot) for all changes to apply.

Manual tweaks (optional):

# Launch Kvantum Manager to verify theme
kvantummanager

# Launch Plank preferences (right-click on dock)
plank --preferences

# Restart KDE Plasma without rebooting (if already in KDE)
kquitapp5 plasmashell && kstart5 plasmashell

---

🧩 Troubleshooting

Theme not applied after login?

1. Open System Settings → Appearance → Global Theme
2. Select WhiteSur-dark
3. Click Apply

Icons look wrong?

# Rebuild icon cache
gtk-update-icon-cache -f ~/.local/share/icons/WhiteSur-dark/

Kvantum theme missing?

# Ensure Kvantum is set as Qt style
export QT_STYLE_OVERRIDE=kvantum
# Or set it permanently in KDE System Settings → Application Style

Plank not showing?

# Start manually
plank &

# Or check autostart file
ls ~/.config/autostart/plank.desktop

Want to revert?

# Restore backed-up panel config (if exists)
mv ~/.config/plasma-org.kde.plasma.desktop-appletsrc.bak.* ~/.config/plasma-org.kde.plasma.desktop-appletsrc

# Remove theme configs
rm -rf ~/.config/kdeglobals ~/.config/kwinrc ~/.config/kcminputrc ~/.config/Kvantum

---

🗂️ File Structure

~/.config/
├── kdeglobals              # KDE global settings (colors, fonts, icons)
├── kwinrc                  # Window manager (Aurorae theme, effects)
├── kcminputrc              # Mouse/cursor settings
├── Kvantum/
│   └── kvantum.kvconfig    # Kvantum engine theme selector
├── gtk-3.0/settings.ini    # GTK3 theme settings
├── gtk-4.0/settings.ini    # GTK4 theme settings
├── gtkrc-2.0               # GTK2 theme settings
├── autostart/
│   └── plank.desktop       # Plank auto-launcher
└── plank/
    └── dock1/settings      # Plank dock preferences

~/.local/share/
├── aurorae/themes/         # Window decorations
├── color-schemes/          # Plasma color schemes
├── icons/                  # Icon themes (WhiteSur-dark)
├── plasma/desktoptheme/    # Plasma desktop themes
└── plasma/look-and-feel/   # Global themes

---

🙋 Credits

• Theme Art: Vinceliuice — Creator of the WhiteSur theme suite
• Script: ussu321 — Kali Linux automation & branding

---

📜 License

This installer script is released under the MIT License.
The WhiteSur themes are licensed under their respective GPL/LGPL licenses (see original repositories).

---

⬆ Back to Top

Made with ❤️ by ussu321