SVG Sticker

by rimpk901
5
4
3
2
1
Score: 50/100

Description

Assign custom SVG stickers to notes, folders, and Make.md Spaces in Obsidian.

Reviews

  • Argus Dev
    Reviewed on Nov 17th, 2026
    I've been looking for a clean way to use my own SVG icons across both regular Obsidian folders and Make.md Spaces, and this plugin nails it. The visual picker is super snappy, and being able to bulk-assign icons saved me hours of tedious clicking when reorganizing my vault. Everything just works without breaking anything. Big thanks for making this!

Stats

2
stars
35
downloads
0
forks
5
days
2
days
2
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
12
commits

Latest Version

2 days ago

Changelog

1.0.1 — Fix: icons redrawn / re-requested on scroll

Fixed

  • Native file explorer: icons no longer flicker or get redrawn while scrolling or typing in large vaults. The explorer observer used to watch the whole document.body and rescan every file and folder on any DOM change (including its own icon insertions). It now reacts only to newly added explorer rows and processes just those nodes.
  • Make.md: scrolling the Spaces tree no longer triggers thousands of image requests (13k requests / ~33 MB in a few seconds of scrolling with many icons). Make.md's getUIPath() appends a random ?0–999 suffix to every image URL, so each re-mounted row of its virtualized tree requested the icon again. The plugin now strips that suffix, so icons are loaded once and served from cache.

Improved

  • Icon resource paths are cached and invalidated when an SVG changes, is renamed or deleted.
  • Editing a note's sticker frontmatter by hand updates only that note's row.
  • Removed loading="lazy" from explorer icons to avoid visible flicker.

Notes

  • The Make.md fix is a temporary workaround that relies on Make.md's internal API (superstate.ui.getUIPath) and is restored when the plugin is disabled. It will become unnecessary once Make.md fixes this upstream.
  • Make.md integration may need adjustment after major Make.md updates.

Installation

Download main.js, manifest.json, styles.css into .obsidian/plugins/svg-sticker/ and reload Obsidian.


1.0.1 — Исправление: иконки перерисовываются / перезапрашиваются при скролле

Исправлено

  • Штатный проводник: иконки больше не мерцают и не перерисовываются при скролле или наборе текста в больших хранилищах. Раньше обсервер следил за всем document.body и при любом изменении DOM заново обходил все файлы и папки (включая вставку собственных иконок). Теперь он реагирует только на новые строки проводника и обрабатывает только их.
  • Make.md: скролл дерева Spaces больше не вызывает тысячи запросов картинок (13 тыс. запросов / ~33 МБ за несколько секунд при большом количестве иконок). getUIPath() в Make.md добавляет к URL случайный суффикс ?0–999, поэтому каждая заново смонтированная строка виртуализированного дерева запрашивала иконку снова. Плагин теперь убирает этот суффикс — иконки грузятся один раз и дальше берутся из кэша.

Улучшено

  • Пути к SVG кэшируются и сбрасываются при изменении, переименовании или удалении файла.
  • Ручное изменение sticker во frontmatter обновляет только строку этой заметки.
  • Убран loading="lazy" у иконок проводника, чтобы не было мерцания.

Примечания

  • Исправление для Make.md — временное, оно опирается на внутренний API (superstate.ui.getUIPath) и снимается при отключении плагина. Оно станет не нужно, когда Make.md исправит это у себя.

README file from

Github

GitHub release GitHub downloads GitHub license Obsidian

🎨 SVG Sticker

Bring your Obsidian vault to life with custom SVG icons!

SVG Sticker is a plugin for Obsidian that lets you assign custom SVG icons to notes, folders, and Make.md Spaces.

Choose icons from your own collection, customize the icon folder, and organize your vault visually.


✨ Features

  • Custom SVG icons — use your own SVG icon collection.
  • Note stickers — assign icons to individual notes.
  • Folder stickers — personalize folders in the native Obsidian File Explorer.
  • Make.md integration — assign SVG icons to Make.md Spaces without modifying Make.md source code.
  • Bulk assignment — select multiple Make.md items and assign the same icon to all of them at once.
  • Icon picker — browse icons in a visual grid with search and pagination.
  • Custom icon folder — choose any folder in your vault as the icon source.
  • Multilingual interface — English, Russian, Korean, and Chinese.
  • Automatic language detection — use your Obsidian language or select one manually.

🎬 Demo

1. Assigning an icon to a note or folder (without Make.md)

Choose an SVG icon and assign it to a regular note or folder in Obsidian.

Assigning an icon without Make.md

2. Make.md integration

Assign custom SVG icons to Make.md Spaces using the context menu.

Make.md icon assignment

3. Bulk icon assignment

Select multiple Make.md items and assign the same SVG icon to all of them in one action.

Bulk icon assignment


📦 Installation

Manual installation

  1. Download the latest release from the Releases page.

  2. Open your Obsidian vault folder.

  3. Navigate to:

    .obsidian/plugins/

  4. Create a folder named:

    svg-sticker

  5. Copy the plugin files into that folder:

    • main.js
    • manifest.json
    • styles.css
  6. Restart Obsidian or reload plugins.

  7. Enable SVG Sticker in Settings → Community plugins.


⚙️ Configuration

Open:

Settings → Community plugins → SVG Sticker

Icon folder

Specify the folder containing your SVG files, relative to your vault root.

Default:

embed/icons

Example:

Assets/Icons

Leave the field empty to search for SVG files throughout the entire vault.

Language

The plugin supports:

  • Automatic — follows your Obsidian interface language.
  • English
  • Русский
  • 한국어
  • 中文

Your language preference is saved automatically.


🖼️ Preparing SVG icons

  1. Create an icon folder inside your vault.
  2. Add your .svg files.
  3. Set the folder path in SVG Sticker settings.
  4. Open the icon picker and choose an icon.

Example folder structure:

MyVault/
├── Assets/
│   └── Icons/
│       ├── book.svg
│       ├── folder.svg
│       ├── work.svg
│       └── star.svg
└── Notes/
    ├── Projects.md
    └── Ideas.md

SVG Sticker uses the original SVG files from your vault.


🔌 Make.md integration

SVG Sticker supports Make.md through an external adapter.

  • No Make.md source code modifications.
  • No replacement of Make.md components.
  • Uses Make.md's runtime API to assign and restore icons.
  • Supports individual and bulk assignments.

Note: Make.md integration relies on internal APIs that may change in future Make.md updates. Compatibility may need to be adjusted after major updates.


🛠️ Development

Clone the repository:

git clone https://github.com/rimpk901/obsidian-svg-sticker.git
cd obsidian-svg-sticker

Install dependencies:

npm install

Build the plugin:

npm run build

For development:

npm run dev

📁 Project structure

svg-sticker/
├── src/
│   ├── main.ts
│   ├── StickerModal.ts
│   ├── MakeMDAdapter.ts
│   ├── i18n.ts
│   └── types.ts
├── styles.css
├── manifest.json
├── package.json
├── tsconfig.json
└── esbuild.config.mjs

🤝 Contributing

Bug reports, suggestions, and pull requests are welcome!

If you find a bug or have an idea for a new feature, feel free to open an issue.


📄 License

MIT