🎬 Movie Folder Posters

Automatically apply official movie posters as Windows folder icons for your local movie library.

This tool scans movie folders, cleans noisy release names (like 1080p, BluRay, x264), fetches high-quality posters from TMDb, converts them into .ico format, and applies them to folders — fully automated, with a manual correction option when needed.

---

✨ Features

• 🧹 Smart Name Cleaning
  Removes release tags and junk text from folder names to improve movie matching.

• 🎥 TMDb Integration
  Fetches official, high-resolution movie posters using The Movie Database API.

• 🖼️ Folder Icon Creation
  Converts posters into high-quality Windows .ico files and applies them as folder icons.

• 🛠️ Manual Fix Mode
  Fix incorrect matches by manually providing:

  • TMDb movie ID
  • TMDb URL
  • Exact movie title

• ⚡ Fully Automated Workflow
  Select your movie directory → start → done.

---

🖥️ Supported Platform

• ✅ Windows (uses desktop.ini for folder icons)

Other operating systems are not supported for folder icon application.

---

📦 Requirements

• Python 3.x
• Python packages:
  • requests
  • Pillow

Install dependencies:

pip install -r requirements.txt