🌈 Colorful Folders for Obsidian

Transform your Obsidian file explorer from a dull list into a vibrant, organized, and high-performance visual dashboard. Colorful Folders automatically applies premium color palettes, smart icons, and structural intelligence to your vault. Whether you want a strictly organized, monochromatic workspace or a neon-glowing cyberpunk aesthetic, this plugin makes navigation intuitive and your workspace beautiful.

🚀 Latest: 4.1.8 - The "Speed & Smoothness" Update

This release focuses entirely on making Colorful Folders feel lightning-fast and incredibly smooth to use, especially for users with massive vaults and lots of other plugins. Full Changelog

Instant Clicking: Selecting files is now completely instant. We rebuilt the "active folder" highlighting engine from the ground up to completely eliminate input lag when opening files.
Notebook Navigator Sync: We updated the Notebook Navigator integration so it natively supports the new, lightning-fast active highlights.

⚡ 2. Smooth Scrolling & Expanding

No More Stuttering: Rapidly expanding or collapsing folders is now buttery smooth. The plugin smartly groups visual updates to prevent your screen from freezing during intense folder management.
Faster Startups & Edits: Creating, deleting, or renaming files has been heavily optimized so Obsidian stays perfectly responsive while you work.

🛡️ 3. Zero Drag Lag & Better Compatibility

Smooth Mouse Movements: Hovering over files, dragging items, or switching tabs will no longer cause CPU spikes. The plugin now safely ignores rapid mouse movements and only triggers visual updates when absolutely necessary (like when you switch between Light and Dark mode).
Third-Party Plugin Immunity: Colorful Folders is now much smarter at ignoring visual "noise" injected by other plugins (like file counters or virtual scroll lists), completely preventing layout flickering and infinite reload loops.

🛠️ 4. Obsidian 1.13+ API Compatibility & Legacy Support

Deprecation Fixes: Safely bypassed developer console warnings for older APIs (like setWarning() and display()) instead of migrating to newer ones, guaranteeing that the plugin remains fully backwards-compatible with Obsidian 1.4.4+.
CSS Optimization: Improved CSS selector specificity (e.g. .is-invalid fields) and removed all !important flags for a cleaner styles structure.
Linter Compliance: Updated project typing to align with the latest obsidian API definitions while preserving backwards compatibility.

✨ Core Features

🎨 Vivid Color & Visual Hierarchy

Color-Coding Hierarchy: Automatically assigns distinct, beautiful colors to your top-level and nested folders.
Visual Wayfinding: Uses glowing connector lines to create a clear "breadcrumb trail" to your currently active file.
Stunning Built-in Palettes: Choose from preset themes like soft Pastel Dreams or high-contrast Neon Cyberpunk, or enter your own comma-separated hex codes for brand consistency.
Smart Rainbow Logic: Cycle files independently through your palette for a full rainbow effect, or use the Adaptive Heatmap that seamlessly syncs with your chosen colors.
Minimalist & Monochromatic Modes: Force subfolders to inherit their parent's color for strict organization, or use Outline Only Mode to remove background tints entirely while keeping the bright connecting lines.

🤖 Smart Iconography

Auto-Icon Engine: Automatically detects folder and file names and injects high-fidelity Lucide/SVG icons based on categories (e.g., Journal -> 📅, Finance -> 💰, Tech -> 💻).
Built-in Offline Libraries: Ships with 6 curated local icon sets (including Material, FontAwesome, and Vibrant packs) for instant, zero-latency styling without an internet connection.
Enhanced Iconify Support: Import seamlessly from Iconify with perfect alignment, alias preservation, and custom offset support.
Independent Icon Styling: Change icons and emojis without overriding your custom colors. Native icons are automatically replaced for a unified workspace.
Universal 18px Sizing: All icons are standardized to a professional 18px baseline with perfect vertical centering across all themes and font sizes.

📁 Advanced Customization & Typography

Individual File/Folder Styling: Right-click any item and select "Set Custom File Style" to override its color, icon, and text formatting.
WYSIWYG Menu: The custom style modal intelligently pre-fills with the exact colors currently visible in your vault, sensitive to dark-mode brightness.
Advanced Typography: Instantly make key projects stand out with bold and italic toggles, or custom text color overrides.
Smart Inheritance: Force a specific style down an entire folder tree or instantly style all files within a folder to match its aesthetic.

📐 Organization & Spacing

Section dividers: Add vertical visual dividers to group your files and folders. Includes Markdown support for rich descriptions in glassmorphic popovers and a dedicated smart editor. Features asymmetrical spacing (independent left/right gaps) and support for solid, dashed, or dotted lines.
Dynamic item counters: Display recursive statistics showing the total count of folders and files contained within a directory, color-matched to their parent folder.
Exclusion Lists: Keep utility directories like attachments or templates looking standard and unaffected by plugin styling.

🕵️ Stealth & Privacy Engine

Visual Privacy: Hide any file or folder from the sidebar with a single click via the context menu.
Ghost Mode: Toggle semi-transparent viewing of hidden items with a sleek blur effect.
Password Protection: Secure your privacy settings with a custom Password Modal featuring shake animations for invalid attempts.
Management Dashboard: A new "Privacy & stealth" card in settings to manage all hidden items and recovery options.

⚡ Performance & Visual Stability

Cross-Platform Engine: Built for zero-lag performance with a robust CSS engine that works identically on Windows, macOS, Linux, Android, and iOS.
Static Premium Standards: All animations have been decommissioned in favor of hardcoded, high-performance static visual standards (e.g., Luminous Selection) to ensure zero GPU stutter.
Vault Maintenance Tools: Includes one-click buttons to "Reset All Styling" or "Clear Icon Library", plus an Icon Debug Mode to track exactly how auto-icons are being applied.

🌐 Network Usage & Privacy

External Requests: Colorful Folders makes external network requests to raw.githubusercontent.com to download featured icon packs and to fetch changelogs when the plugin updates. These external calls are only made with user knowledge and do not transmit any personal data.

🛠️ Installation

Via Obsidian Community Plugins (Official & Recommended)

Colorful Folders is now officially available in the Obsidian Community Plugins gallery!

Open Obsidian and navigate to Settings > Community plugins.
Click Browse next to Community plugins.
Search for Colorful Folders.
Click Install, then click Enable.

Via BRAT (For Beta Releases)

If you would like to test the absolute latest beta features, presets, and updates before they hit the main store, you can use BRAT:

Install the BRAT plugin from the Obsidian Community Plugins gallery.
Go to Settings > BRAT > Beta Plugin List.
Click Add Beta plugin.
Paste the repository URL: https://github.com/RohitNahar-Offical/colorful-folders-obsidian
Click Add Plugin.
Enable Colorful Folders under your Community plugins tab.

💡 Pro Tip

You can access all styling configurations by navigating to Settings > Colorful Folders. Look for the large "💡 Pro Tip" banner at the top of the settings page for hidden tricks, including how to set up custom overriding colors!

👨‍💻 Developer Documentation

If you are a developer looking to understand the internal architecture, contribute features, or debug the styling engine, please refer to our comprehensive technical guides:

Developer Master Guide: The entry point for all technical documentation.
Internal Engine Architecture: Deep dive into the rendering pipeline and logic flow.
API Reference: Detailed class and method documentation.
Customization Guide: Advanced CSS snippets and styling overrides.

Developed with ❤️ by ROHIT-NAHAR

Colorful Folders

Description

Reviews

Stats

Latest Version

Changelog

README file from