🌈 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 and structural intelligence to your vault, making navigation intuitive and your workspace beautiful.

---

✨ What does it do?

Obsidian's default file explorer can feel cluttered as your vault grows. Colorful Folders solves this by:

1. Color-Coding Hierarchy: Automatically assigns distinct, beautiful colors to your top-level and nested folders.
2. Visual Wayfinding: Uses glowing connector lines to create a clear "breadcrumb trail" to your active file.
3. Cross-Platform Performance: Built for zero-lag with a robust CSS engine that works identically on Windows, macOS, Linux, Android and iOS.

---

🚀 Version 4.0.2 - Optimized Factory Defaults

Version 4.0.2 hard-codes the user's preferred global configuration for all new installations, while keeping personal data private.

• Global Baseline: Hand-curated defaults for palette, opacity, and animations.
• Privacy Mode: Custom folder styles and personal presets were excluded from the source code.
• Improved Performance: Optimized settings initialization for a faster out-of-the-box experience.

---

🚀 Version 4.0.1 - The Reliability & Consistency Patch

🚀 Version 4.0.0 - The Visual Intelligence & Performance Overhaul

Version 4.0.0 is a milestone release that transforms the file explorer into a professional, high-fidelity visual dashboard.

📅 1. Auto-Generated Lucide Icons

• 20+ Smart Categories: Automatically injects high-fidelity icons for common folder and file names (e.g., Journal -> 📅, Finance -> 💰, Tech -> 💻).
• Universal Scope: Icons are applied to both folders and files, dynamically tinted to match your chosen colors.
• Wider, HD Rendering: Replaces standard emojis with high-clarity SVGs for a modern, pro look.

📊 2. Dynamic Item Counters

• Recursive Statistics: Displays the total count of folders and files contained within each directory.
• High-Visibility Design: Uses a custom, combined SVG design with a sleek "folder-open" icon and plural "files" icon for maximum clarity.
• Perfect Integration: Counters are perfectly aligned at the right edge and inherit the exact hex color of their parent folder.

📱 3. Deep Notebook Navigator Support

• Native Icon Replacement: Automatically hides native icons and replaces them with premium, color-synced Lucide icons for a unified workspace.

⚡ 4. Extreme Performance & Pro Sizing

• Unified 17px Standard: All icons are professionally sized at 17px with 6px right-margins for perfect alignment.
• Fluent UI: Introduced a 250ms debounce and an iconCache engine to ensure zero lag, even in very large vaults.

---

🚀 Version 3.5.8 - The "Polish & Purity" Update

🎨 1. Two Stunning New Color Palettes

• Pastel Dreams: Soft, relaxing, low-saturation hues for a clean minimalist look.
• Neon Cyberpunk: High-contrast, saturated glows for a striking, vibrant vault.

✨ 2. Subtle & Non-Distracting Animations

• Animated Toggles: Choose from Smooth Breathe, Neon Flicker, or Color Shimmer for your active path glow.
• Duration Slider: Control the speed of your vault's "heartbeat" from 0.5s to 10s.

🌈 3. Smart Rainbow Logic

• Rainbow Root Text: Override folder backgrounds without losing your text gradients.
• Auto-Color Rainbow Files: Files cycle independently through your palette for a full rainbow effect.

---

🚀 Version 3.5.0 - Individual File Styling & Typography

📁 1. Custom File Style

Right-click any File and select "Set Custom File Style" to override its color, icon, and text formatting.

🅱️ 2. Advanced Typography

Take full control of your folder and file titles:

• Bold & Italic Toggles: Make key projects stand out instantly.
• Custom Text Color: Override default theme colors for specific items.

🔄 3. Smart Inheritance

• Apply to Subfolders: Force a specific style down the entire folder tree.
• Apply to Files: Instantly style all files within a folder to match its aesthetic.

---

🎨 Core Customization

• Monochromatic Mode: Force subfolders to inherit their parent's color for a strictly organized look.
• Outline Only Mode: Minimalist? Remove background tints entirely and keep only the bright connecting lines and text.
• Custom Palettes: Enter your own comma-separated list of Hex codes to use your own brand colors.
• Exclusion List: Keep utility folders like attachments or templates looking standard.

---

🛠️ Installation

1. Via BRAT (Recommended & Fastest)

Using the BRAT (Beta Reviewer's Auto-update Tool) plugin is the fastest way to get the latest features and ensures the plugin stays updated automatically.

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

[!TIP] Why use BRAT? Manual installations do not update automatically. Using BRAT ensures you stay up-to-date with the latest bug fixes and color presets the moment they are released.

---

💡 Pro Tip

You can access all these settings by going to Settings > Colorful Folders. Look for the large "💡 Pro Tip" banner at the top of the settings page for more hidden tricks, including custom overriding colors!

---

Developed with ❤️ by ROHIT-NAHAR