README

Catppuccin for Roundcube

^{Soothing pastel Catppuccin flavours for Roundcube's Elastic skin <3}
_{⭐️ GitHub · 📖 Roundcube}

Previews

🌻 Latte

🪴 Frappé

🌺 Macchiato

🌿 Mocha

🧠 Installation

Composer (recommended)

cd /path/to/roundcube
composer require armanoide/roundcube-catppuccin

Manual

git clone https://github.com/Armanoide/roundcube_catppuccin.git \
    /path/to/roundcube/plugins/roundcube_catppuccin

Then enable it in config/config.inc.php:

$config['plugins'][] = 'roundcube_catppuccin';

Docker

services:
  roundcubemail:
    image: roundcube/roundcubemail:latest
    environment:
      - ROUNDCUBEMAIL_SKIN=elastic
      - ROUNDCUBEMAIL_PLUGINS=archive,zipdownload,roundcube_catppuccin
    volumes:
      - ./www/config:/var/www/html/config
      - ./www/plugins:/var/www/html/plugins

🍱 Usage

Once installed and enabled, users can pick their flavour directly from the UI:

Settings > General > Catppuccin Theme

The selection is persisted to the database and synced to a cookie so the login page reflects it before authentication.

⚙️ Configuration

Global default flavour (optional)

Set a default flavour for all users in config/config.inc.php:

$config['catppuccin_flavor'] = 'mocha';

Lock the setting (optional)

Prevent users from changing their flavour:

$config['dont_override'][] = 'catppuccin_flavor';

Watermark page (optional)

Display a themed blank page (e.g. for login portal or branding):

$config['blankpage_url'] = 'https://your-webmail-host/static.php/plugins/roundcube_catppuccin/watermark.html';

The watermark respects the user's selected flavour via cookie, so the background colour matches automatically.

📋 Requirements

• Roundcube 1.6+
• PHP 8.0+
• Elastic skin (default in Roundcube)

💝 Thanks To

• Catppuccin Org — for the beautiful palettes

Copyright © 2021-present Catppuccin Org