armanoide / roundcube-iconizer

1.0.0 2026-11-13 14:16 UTC

Requires

• php: >=8.1
• roundcube/plugin-installer: >=0.3.0

MIT

• Armanoide

• plugin
• icons
• roundcube
• folders
• tabler
• iconify
• lucide

Published on Packagist.org on 2026-11-13 14:18 UTC

README

Custom per-folder icons in the Elastic sidebar — pick any icon from curated Iconify packs, stored per user.

Features

• 🔍 Searchable icon picker in the folder edit form — search across installed packs
• 🎨 Curated packs: Bootstrap Icons, Font Awesome, Material Design, Simple Icons
• 🖼️ Local sprite mirror — packs are mirrored server-side once; no runtime requests to api.iconify.design
• 👤 Per-user persistence — icons live in your Roundcube user preferences, synced across devices
• ♻️ Follows your folders — icons survive renames and are cleaned up on delete
• 🌈 Theme-aware — icons render in currentColor, so your skin stays in charge

Requirements

• Roundcube 1.6+ with the Elastic skin
• PHP 8.0+

Installation

Composer (recommended)

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

Then enable it in config/config.inc.php (step below).

Manual

1. Clone the plugin into your Roundcube plugins directory:

git clone https://github.com/Armanoide/roundcube_iconizer.git \
    /var/www/html/plugins/roundcube_iconizer

1. Enable it in config/config.inc.php:

$config['plugins'] = [
    // ... other plugins ...
    'roundcube_iconizer', // <-- add this line
];

1. Make sure plugins/roundcube_iconizer/sprites/ and data/ are writable by the web server user.

Docker

services:
  roundcubemail:
    image: roundcube/roundcubemail:latest
    volumes:
      - ./plugins/roundcube_iconizer:/var/www/html/plugins/roundcube_iconizer

Usage

Install icon packs — Settings → Icon packs: install/remove the sprite mirror for each pack.

Set a folder icon — Settings → Folders → edit (or create) a folder → Icon field → search, pick, save. The sidebar repaints immediately — no reload.

Icons are referenced as pack:name (e.g. bi:folder2-open). Removing an icon restores the standard Elastic glyph.

Thanks To

• Iconify — the unified icon infrastructure
• Bootstrap Icons (MIT), Font Awesome (CC BY 4.0 / OFL), Material Design Icons (Apache 2.0), Simple Icons (CC0) — the pack authors

License

MIT © 2026 Armanoide