ProxMorph

Custom themes for Proxmox VE (PVE) and Proxmox Backup Server (PBS) that integrate with the native Color Theme selector.

✨ Features

• Native Integration - Themes appear in built-in Color Theme dropdown (PVE and PBS)
• Auto-Patch on Updates - Automatically re-applies themes after product updates
• Hybrid Engine - CSS for styling + JavaScript for dynamic chart patching
• Easy Installation - Single command installation for both PVE and PBS

📸 Screenshot

Comparison between default Proxmox Dark theme and UniFi theme:

🎨 Themes

UniFi Inspired by Ubiquiti UniFi Network Application

GitHub Dark Screenshot Coming Soon Based on official GitHub Dark Dimmed theme

More themes inspired by other vendor UIs are in development.

🚀 Installation

One-Liner Install

bash <(curl -fsSL https://raw.githubusercontent.com/IT-BAER/proxmorph/main/install.sh) install

Manual Install

git clone https://github.com/IT-BAER/proxmorph.git
cd proxmorph
chmod +x install.sh
./install.sh install

Apply Theme

1. Hard refresh browser (Ctrl+Shift+R)
2. Click username → Color Theme
3. Select a ProxMorph theme

💻 Commands

Command	Description
./install.sh install	Install themes
./install.sh uninstall	Remove themes
./install.sh update or bash <(curl -fsSL https://raw.githubusercontent.com/IT-BAER/proxmorph/main/install.sh) update	Updates (latest from GitHub) and install the latest themes
./install.sh status	Show installation status

🛠️ Creating Themes

1. Copy an existing theme from themes/
2. Rename to theme-yourname.css
3. Edit the first line: /*!Your Theme Name*/
4. Modify CSS styles
5. Run ./install.sh install

Theme files must start with /*!Display Name*/ - this sets the name in Proxmox's dropdown.

ℹ️ How It Works

1. Theme CSS files are copied to shared /usr/share/javascript/proxmox-widget-toolkit/themes/
2. JavaScript patches (for charts) are installed to product-specific JS directories
3. proxmoxlib.js is patched to register themes, and product index templates (.tpl or .hbs) are patched to load JS patches
4. An apt hook automatically re-patches after product updates (widget-toolkit, pve-manager, or proxmox-backup-server)
5. Themes appear in the native Color Theme selector of both PVE and PBS

📦 Supported Versions

• Proxmox VE 9.x / 8.x
• Proxmox Backup Server 4.x / 3.x

📄 License

MIT License

💜 Support

If you like my themes, consider supporting this and future work, which heavily relies on coffee:

Donate via PayPal