Star Icons

⭐ Star Icons

The icon collection manager for Obsidian — 72,000+ icons, organized into collections and tags, and applied to files, folders and tabs through an intuitive rules engine with live preview and full transparency.

Star Icons takes a third path in the icon-plugin landscape:

• Iconize gives you total manual control.
• AutoIcons gives you set-and-forget automation.
• Star Icons gives you a library: curate, tag and collect icons like music playlists, then apply them with rules that explain themselves.

---

📸 Screenshots

---

✨ Features

🗂️ Icon Collection Manager (the hub)

A dedicated sidebar view — the place to browse your icons.

• 72,361 icons, offline after first load — pack data ships with the repo and manual installs; when a pack file is missing (Obsidian's community installer only downloads main.js, styles.css and manifest.json) it is fetched once from a CDN and cached locally, so everything works offline afterwards. Packs load on demand: main.js stays small, only the packs you enable are read, and every icon carries style tags (outline, filled, bold, color, brand…) so searching 72k icons never feels like 72k near-duplicates.
  • Core — on by default (26,932 icons): Material Symbols (7,798) · Tabler (5,130) · Remix Icon (3,078) · Bootstrap (2,078) · Lucide (2,025) · OpenMoji Color (1,718) · Phosphor (1,512) · Unicons (1,215) · Tabler Filled (1,054) · Boxicons (814) · Heroicons (324) · Animals (94) · Science (47) · Nature & Flowers (31) · Star Icons (14)
  • Extended — opt-in in Settings (45,429 more): Material Outlined (7,798) · Material Sharp (7,798) · Twemoji 🎨 (4,009) · Simple Icons (3,453) · Fluent Emoji 🎨 (3,145) · Phosphor Bold/Fill/Light/Thin/Duotone (7,560) · Font Awesome (2,274) · OpenMoji Mono (1,860) · Ionicons (1,357) · Line Awesome (1,544) · Ant Design (846) · Octicons (743) · CSS.gg (704) · Boxicons Solid/Logos (820) · Eva (490) · Heroicons Solid (324) · Unicons Solid/Mono/Thinline (704)
• Search with fuzzy matching across names, tags and styles
• Filter by pack, or by your own tags
• Collections: drag icons in, reorder with drag & drop, rename, delete
• Favorites and recently used strips in the picker
• Detail panel: big preview, tags editor, collection membership, copy name/SVG, apply to the active note

🎛️ Rules engine that explains itself

Rules run top-to-bottom and the first enabled match wins — but unlike other plugins, you always know why an icon is there.

• Conditions: file name · file path · extension · folder · tag · property · heading · and the system clock (day of week + time window)
• Match all or any conditions
• Actions: set an icon · random icon from a collection · use Obsidian's default
• Live preview: watch matching files appear as you build the rule
• Drag & drop reordering, enable/disable per rule
• Icon source tooltips: hover any file to see which icon applies and which rule decided it
• Status bar indicator shows the active note's icon + source

📐 Priority that's predictable

Manual override  >  Rules (in order)  >  File-type default  >  Global default

🖱️ Apply icons everywhere

• File explorer: files and folders
• Tab headers of open notes
• Above the note title (reading view, optionally edit mode)
• Right-click any file → Set icon… / Copy icon name / Remove icon override
• Command palette commands + a ribbon button
• Manual overrides, file-type defaults (.md, .pdf, …) and a global default

🧰 And more

• Pack on/off toggles (instantly shrinks search space)
• Export / import your whole configuration as JSON
• Settings reset, keyboard-navigable icon picker, dark/light theme aware
• Zero runtime dependencies beyond the Obsidian API — pack data is bundled or fetched on demand and cached locally

---

🚀 Getting started

From the community plugin store

1. Settings → Community plugins → Browse → search "Star Icons" → Install → Enable.

Manual install (from source)

1. Download main.js, manifest.json and styles.css from the latest release.
2. Copy them into <vault>/.obsidian/plugins/star-icons/.
3. Reload Obsidian and enable Star Icons — any missing pack is downloaded on demand and cached into packs/. For a fully offline install, also copy the packs/ folder from the repo into the plugin folder.

Development

npm install
npm run build:icons   # regenerate src/data/generated/*.json from node_modules packs
npm run dev           # watch mode (esbuild + packs/ copy)
npm run build         # production build -> main.js + packs/
npm test              # rule engine unit tests

---

📖 Rules deep-dive

Rules are evaluated in order; the first enabled rule whose conditions match wins. Drag rules to reorder, toggle them off without deleting, and use the live preview to sanity-check before saving.

💡 Tip: combine a folder rule with a random action and a collection of 20 icons — every project folder gets its own rotating icon.

---

🧭 Philosophy

1. Library first. Icons are content. Tag them, collect them, curate them.
2. Transparency. Every icon on screen can explain its own provenance.
3. Offline after first sync. Missing pack data is fetched once and cached in the plugin folder; after that there's no waiting and no network needed.
4. Native feel. Icons follow Lucide's design guidelines (24×24, 2px stroke, round caps) so they sit naturally inside Obsidian.

---

📦 Icon packs

Licenses & trademarks

• Attribution (CC BY): Font Awesome Free and Twemoji require a credit line — provided above and in the plugin's About/README.
• Share-alike (CC BY-SA): OpenMoji SVGs are bundled unmodified.
• Brands: Simple Icons (CC0), Boxicons Logos, Line Awesome brands and Octicons contain third-party logos. Free to use; do not imply endorsement.

---

🤝 Contributing

• Report bugs & request features via GitHub issues — the plugin has a built-in Report a bug dialog (Ctrl+P → "Star Icons: Report a bug…") that copies a diagnostic report for you.
• Add icons: edit src/data/packs/star.ts (24×24 stroke-style SVGs) and open a PR.
• Add packs: extend scripts/build-icon-data.mjs and re-run npm run build:icons.

Star Icons is open source (MIT) — star on GitHub and like the plugins it learns from (Iconize, Iconic, AutoIcons).

---

📜 License

MIT © 2026 Kerekes Stefan (Star Icons). Bundled icon packs retain their respective licenses (see above).