FoliCon

The Ultimate Movie, TV Series, Anime, Music & Game Folder Icon Customizer for Windows

Quick Install • Features • Visual Showcase • Overlay Store • Setup Guide • Documentation

---

❤️ Support FoliCon

If FoliCon has saved you hours of manual folder customization, please consider supporting development.

Why sponsor?

Your support helps keep FoliCon fast, reliable, and actively maintained:

• 🎯 New features (better matching, richer metadata, Theme store)
• 🛠️ Faster bug fixes and compatibility updates
• 📦 Continued WinGet/Chocolatey packaging and release maintenance
• 💬 More time for issue support and community requests

Ways to help

• Monthly support: GitHub Sponsors
• One-time support: PayPal
• Free support: Star the repo, share it with friends, and report issues/ideas

---

FoliCon is a modern, high-performance Windows application that transforms plain, generic folders into stunning, personalized media artworks. It automatically queries online databases (TMDB, IGDB, DeviantArt) and applies beautiful, metadata-rich icons in seconds.

Built with WPF & .NET, FoliCon features an extensible Overlay Plugin System and built-in Overlay Designer, giving you 100% creative freedom to customize shapes, 3D borders, reflections, templates, and badge placements.

---

⚡ Quick Installation

Choose your preferred way to install FoliCon:

Method 1: Windows Package Manager (winget)

winget install DineshSolanki.FoliCon

Method 2: Chocolatey

choco install folicon

Method 3: Direct Portable Download

Download the latest pre-compiled archive from GitHub Releases or SourceForge. No installer needed — simply unzip and run FoliCon.exe.

---

📸 Before & After

Plain Windows Folders (Before)	FoliCon Customized Folders (After)

🔍 Click here to expand more UI Screenshots & Feature Views

Searching & Matching	Poster Selection & IMDb Badges

Main Batch Workflow	Custom Manual Icon Setter

---

✨ Key Features

• 🎬 Multi-Media Metadata Support: Works seamlessly across Movies, TV Series / Shows, Anime, Music Albums, PC/Console Games, and Books.
• 🌟 Live Rating Badges: Embed official IMDb & TMDB rating stars directly on your folder art.
• 🖼️ Dual Operation Modes:
  • Poster Mode: Automatically extracts posters, fanart, release years, and story overviews from TMDB.
  • Professional Mode: Fetches curated, custom-designed icons from top designers on DeviantArt.
• 🔄 Instant Shell Refresh: Uses native Windows Shell APIs (SHFOLDERCUSTOMSETTINGS / Desktop.ini) to refresh icon caches on the fly with zero Explorer restarts or lag.
• 🧩 Extensible Overlay System: Choose from dozens of community styles (Blu-ray cases, DVD cases, Clear Glass, Minimalist, Rounded, Perspective 3D).
• 🎨 Integrated Overlay Designer: Create and customize your own overlay styles with a real-time WYSIWYG editor and export them as shareable packages.
• 🌍 Multilingual: Translated into 8+ languages (English, Spanish, Arabic, Russian, Hindi, Portuguese, Japanese, Chinese).
• 🪶 100% Lightweight & Portable: Zero bloat, zero background telemetry, and no registry clutter.

---

🧩 Overlay Plugin System & Store

FoliCon separates icon rendering from core code using JSON-driven Overlays.

• 🛍️ Overlay Store: Browse, install, update, and rate overlays created by the community.
• 🎨 Overlay Designer: Build custom overlays from scratch or templates — adjust aspect ratios, rotations, opacity, drop-shadows, and corner radiuses with instant live preview.
• 📖 Authoring Guide: Learn how to create your own overlays in CREATING-OVERLAYS.md.
• 🌐 Community Catalog: github.com/DineshSolanki/FoliCon-Overlays

---

🚀 Getting Started

No complex installation required — download the latest release and run.

FoliCon connects with third-party media APIs for accurate metadata. On your first run, a friendly Setup Wizard will guide you through connecting the services you wish to use (all services are optional).

Service	Purpose	How to Get (Free)
TMDB	Movie & TV Show Posters, Overviews, IMDb/TMDB Ratings	Get free API key
IGDB / Twitch	Video Game Covers, Release Dates & Metadata	Create free Twitch App
DeviantArt	Professional Mode Curated Artist Icons	Log in with any DeviantArt account

Note

All services are optional. You can configure only the providers you need from Settings → Setup Wizard.

---

🌐 Localization & Translations

Help us bring FoliCon to more languages! Localization is powered by Crowdin.

1. Visit the FoliCon Crowdin Project.
2. Select your language and start translating strings.

For Developers (Syncing Translations)

$env:CROWDIN_PROJECT_ID = "your_project_id"
$env:CROWDIN_API_TOKEN  = "your_api_token"

# Upload latest source strings
.\crowdin-sync.ps1 -Action upload-sources

# Download translated language packs
.\crowdin-sync.ps1 -Action download

---

🛠️ Built With

• .NET & WPF — High-performance native Windows desktop framework
• Prism — MVVM architecture & modularity
• HandyControls — Modern WPF control suite
• WinCopies.IconLib — High-quality multi-resolution .ico encoder
• Ookii.Dialogs.Wpf — Native Windows folder selection dialogs
• The Movie Database (TMDb) API — Entertainment metadata
• IGDB API — Game metadata
• DeviantArt API — Community icon galleries
• Sentry & NLog — Diagnostics & logging

---

📈 Star History

---

👥 Contributors & Acknowledgments

FoliCon is created and maintained by Dinesh Solanki.

Acknowledgments:

• A big tribute to Jamedjo for Raticon, the original project that inspired the creation of FoliCon.
• Poster & frame designs by HazZbroGaminG, Faelpessoal, and Liaher.
• This product uses the TMDb API but is not endorsed or certified by TMDb.
• Professional Mode icons are fetched from publicly available galleries on DeviantArt; all rights remain with their respective creators.

Special Community Contributors:

@pierx

@FazCodeFR

@TheFmC

@MasoudRahmani

@PoetaGA

... and many more who have interacted with us through issues and discussions. ---

📄 License

This project is licensed under the GNU General Public License v3.0.