Isoform — Aesthetic Windows Icon Suites 🌑✨

Created by Acourd

A collection of premium, minimalist, and geometric icon suites for Windows desktops.

Theme	Icons	Notes
Graphite Elegance	73	dark squircle, white silhouettes
Lumina Frost	71	light squircle, dark silhouettes
Midnight Ooo	—	deep night palette
Horizon Glow	—	warm gradient palette
White Space Pixel	69	pixel-art variant
KiraLight (Dark / Light)	138	2 × 69

---

🎨 Theme Previews

Graphite Elegance

Lumina Frost

Midnight Ooo

Horizon Glow

---

📂 Repository Structure

.
├── Tools/                        ← shared engine
│   ├── icon_engine.py            ← one applicator + organizer for every theme
│   └── icon_validate.py          ← icon resolution/name gate (used by CI)
│
└── [Theme]_Release/
    ├── Icons/ICO/                ← multi-resolution .ico (256, 128, 64, 48, 32, 16 px)
    ├── theme.json                ← theme config for the shared engine
    ├── Tools/Install.bat         ← minimal launcher → ..\..\Tools\icon_engine.py
    └── Apply_Theme.ps1           ← launcher (Graphite only; others use Tools\Install.bat)

The engine lives once at Tools/icon_engine.py; each theme only carries a theme.json. The former per-theme applicators were removed.

---

🚀 Quick Start

1. pip install -r requirements.txt (the engine never auto-installs anything).
2. Open the theme folder (e.g. Graphite_Elegance_Release).
3. Launch it:
   • Graphite Elegance ships Apply_Theme.ps1 (Right-click ➔ Run with PowerShell).
   • Most themes have Tools\Install.bat; Ooo ships Tools\apply_horizon_glow.bat and Tools\apply_midnight_ooo.bat.
   • Or call the engine directly (commands below).

By default this only applies icons. Destructive / cosmetic steps are opt-in:

:: apply icons only (safe default)
python Tools\icon_engine.py --config Graphite_Elegance_Release\theme.json

:: preview without writing anything (no backup, no refresh, no prompt)
python Tools\icon_engine.py --config Graphite_Elegance_Release\theme.json --dry-run

:: hide shortcut names (accessibility: opt-in) and clean launcher duplicates
python Tools\icon_engine.py --config Graphite_Elegance_Release\theme.json --rename --cleanup

:: reorder already-applied shortcuts (theme items only)
python Tools\icon_engine.py --config Graphite_Elegance_Release\theme.json --organize

:: undo a previous run
python Tools\icon_engine.py --restore "%LOCALAPPDATA%\Icons_Engine\backups\<key>\<timestamp>"

Safety

• A backup is written before any change (icon edits, deletions and renames included) under %LOCALAPPDATA%\Icons_Engine\backups\<key>\<timestamp>\.
• --restore validates the manifest schema and only touches paths inside the user/public Desktop; it never deletes arbitrary files.
• --rename and --organize operate only on shortcuts that match the active theme.
• theme.json is validated strictly: unknown keys are rejected, persist_key is sanitized and icons_dir may not escape the theme folder.

Note on invisible names

--rename uses non-breaking spaces, which makes shortcut names invisible to screen readers, search and keyboard navigation. It is therefore opt-in, not a default.

---

✅ Validating icons

The released sets ship the full 16/32/48/64/128/256 frame set with unique names per variant. The gate is pure Python and cross-platform:

python Tools\icon_validate.py --all
python Tools\icon_validate.py --all --json

Validation gate: python Tools\icon_validate.py --all → 0 errors, 0 warnings. The contract is documented in docs/ICON_FORMAT.md.

Icon factory: the generation pipeline (silhouette composition, source assets and the declarative build) is maintained in a separate private repository and is intentionally not part of this public repository. Only the published .ico results live here.

---

🤝 Contributing, License, Security

• CONTRIBUTING.md — dev setup, checks, contracts.
• LICENSE — MIT (third-party logos excluded).
• SECURITY.md — safety model and vulnerability reporting.

Third-party logos

Some rendered icons embed third-party brand logos (sourced via SimpleIcons / Clearbit). Those marks are the property of their respective owners and are not covered by this project's license. Confirm your rights before redistributing or using them commercially.

---

Developed with mathematical rigor and aesthetic passion. © 2026 Acourd.