Iconic
by Holo
Score: 47/100
favorite
share
Description
Category: Customization & UI

The Iconic plugin allows users to customize icons across various elements in Obsidian, offering seamless integration with the app's vanilla design. It provides access to over 1,300 icons and 1,900+ emojis that can be applied to tabs, files, folders, bookmarks, ribbon commands, properties, and more. Users can easily change icons with a secondary click and personalize them with theme-responsive colors or custom RGB selections. The plugin supports multiple languages and integrates smoothly with different Obsidian themes, adapting dynamically to theme changes. Designed for accessibility and aesthetic enhancement, Iconic empowers users to create a visually tailored workspace.

Stats
321
stars
36,215
downloads
13
forks
266
days
42
days
49
days
4
total PRs
2
open PRs
0
closed PRs
2
merged PRs
102
total issues
45
open issues
57
closed issues
223
commits
Latest Version
2 months ago
Changelog

Thanks for your patience with this update, it's been a busy month! πŸ˜΅β€πŸ’« This patch focuses on addressing a number of serious usability bugs with the 1.1.0 release. Hopefully this makes the plugin accessible to a larger slice of users.

Big thanks to everyone who submitted issues over the last few weeks, including @henrik, @Drakemoor, @hello-ppareja, @kherge, @cwsamuelson, @Wildphinn, @Gduhxtd, @whoszatarash, and @AstralEcliptic, all of whose suggestions made it into this patch πŸ’– Thank you all so much!

We were also blessed with our very first pull requests this year, tagged with emojis below :)

New features

  • You can now fully navigate the icon picker by keyboard! (#40)
    • Press Tab to jump between parts of the dialog
    • Press ← β†’ left/right to browse through icons in the search results
    • Press ↑ ↓ up/down to switch between colors, and Del or Backspace to reset the color
    • Press Enter or Space to click a button
  • Iconic now has a complete Ukrainian translation through the valiant efforts of @cor-bee! πŸ’™πŸ’› (#69)
    • Most of the other translations in Iconic are currently machine-generated, so if you spot any grammar mistakes in your native language, we will always welcome your corrections :)
  • Expanded the README to explain how the Rulebook works in more detail (#45)

Bugfixes

  • Jumping to a section from the Outline sidebar no longer causes a janky scroll (#54)
  • Newly-created files are now checked by the Rulebook immediately (#59)
  • Alleviated performance issues in vaults with large numbers of tags (#61)
  • Alleviated performance issues in folders with large numbers of files, all thanks to @Jessiii223! ⚑⚑ (#67)
  • The RGB picker now works correctly again (#72)
  • The Rulebook dialog can no longer be opened by hotkey while Obsidian is still loading (2170d2a78fc53c24a95d0820850a50f671eee30b)
  • Tag Wrangler plugin: Now merges with the Iconic tag menu (#63)
  • Periodic Notes plugin: Now merges with the Iconic ribbon menu (#68)
  • Ribbon Divider plugin: Dividers no longer have their own right-click menus (a9e21b8ac79c7178e4621ffd7269cfcf6ee2b704)

Visual fixes

  • RTL languages like Arabic now render rules & conditions correctly while dragging them (6642d96fe59c30e2922b383863f9d6007a6ed413)
  • Minimal Edge theme: No longer hides Iconic icons when file & folder icons are hidden by Style Settings (#75)

Full changelog: https://github.com/gfxholo/iconic/compare/1.1.0…1.1.1

README file from

Iconic

A plugin for iconophiles, designed to blend seamlessly with vanilla Obsidian.

Click almost any icon on a tab, sidebar, ribbon, or title bar to swap in one of the 1,700+ icons included in the app, or one of the 1,900+ emojis that your device supports.

banner.webp

β€Ώ Themes: Ayu Light & Mirage / Fancy-a-Story / Primary

Includes language support for English, Arabic, German, Spanish, French, Indonesian, Japanese, Russian, and Simplified Chinese. Most of these languages are currently machine-translated, but if you can supply more accurate translations, absolutely send a message or a pull request :)

Supported items

  • Tabs πŸ“‘
  • Files & Folders πŸ“πŸ“‚
  • Bookmarks & Groups πŸ”–πŸ“‚
  • Tags 🏷️
  • Properties πŸ“¦
  • Ribbon commands πŸŽ€
  • Minimize/Maximize/Close buttons πŸͺŸ
  • Sidebar toggles ◀️▢️
  • Help/Settings buttons β”βš™οΈ
  • Pin buttons (on tablets) πŸ“Œ

How to use

Changing an icon

Secondary-click an item whose icon you want to change, then click Change icon from the menu. You can open menus on mobile by pressing & holding an item. Certain lists like Files, Bookmarks, and Properties let you hold Alt or ⇧ Shift to select multiple items at once.

Every icon is searchable by name. You can filter between icons and/or emojis by clicking the bottom two toggles. When you find an icon that sings for you, click it to confirm.

You can also choose one of nine optional colors per icon. These colors follow the CSS theme of your vault, so they adjust automatically when it changes. If you prefer a specific RGB color, secondary-click the bubble to open the full color picker.

icon-picker.webp

Setting up rules

You can automate your file & folder icons based on a variety of conditions, like their name, their extension, their parent folder, their tags, their property values, the date you've created or modified them, and even the current time of day. Automated icons never remove your custom icons β€” only replace them visually β€” so you can be as experimental as you want.

Open the rulebook from the ribbon, from the plugin settings, or by using the Open rulebook command. There are currently two pages in the rulebook: File rules and Folder rules, which affect files and folders respectively.

rule-picker.webp

Click the green (+) to create a new rule, then click βš™οΈ to open the rule editor. Every rule has an icon, which will overrule the icon of anything which meets the conditions of that rule. A condition is a true or false test; it either matches, or it doesn't, and this decides whether the rule gets triggered. Rules can have multiple conditions, and you control how this is interpreted with the All / Any / None buttons.

There are several types of data you can check using a condition:

  • Icon checks the icon set to a file/folder
  • Color checks the color set to a file/folder
  • Name checks the simple name of a File/Folder
  • Filename checks the full name of a File.md
  • Extension checks the file extension, like md, canvas, jpg, etc.
  • Folder tree checks the partial Path/Leading/To/Your/ file
  • Path in vault checks the entire Path/Leading/To/Your/File.md
  • Headings checks for # Headings inside a note
  • Links checks for [[Links]] inside a note
  • Tags checks for tags inside a note, including #hashtags and the tags: property
  • Properties checks a specific property: inside a note
  • Date created checks the date & time a file was created
  • Date modified checks the date & time a file was modified
  • System clock checks the date & time on your device

Date & time conditions are checked once every minute, so you can use them to modify your icons in real time.

rule-editor.webp

You can see what your rule is actually matching by clicking the 1 match / X matches button at the bottom.

When a rule is active, you'll see an Edit rule action in the menus of any icons which are being overruled. The icon picker will display a warning if you try to edit an overruled icon.

What makes this plugin different from Iconize?

Both plugins can change the icons & colors of files & folders, and auto-set icons based on filepath rules. But Iconic can also:

  • Change icons of plugin tabs, tags, properties, ribbon commands, and a variety of window buttons
  • Change icons by clicking them directly
  • Change icons & colors from the same dialog
  • Dynamically shift colors to match your theme
  • Auto-set icons using a conditional rule system

Can I use both plugins together?

Sort of, just expect a few visual bugs! They currently do some fighting over control of tab icons and the Bookmarks pane.

License

This plugin is released under an MIT No Attribution license, which means you're free to modify and share its source code without needing to credit the author (me). It also protects the code author from liability for damages, so I recommend using a similar license if you republish this code.

Similar Plugins
info
β€’ Similar plugins are suggested based on the common tags between the plugins.
Icon Shortcodes
3 years ago by AidenLx
Obsidian Plugin: Insert emoji and custom icons with shortcodes
Command Palette--
3 years ago by qawatake
An Obsidian plugin to provide a command palette without unwanted commands
Ninja Cursor
3 years ago by vorotamoroz
Obsidian Stylist
2 years ago by ixth
Obsidian plugin that allows to add classes and styles on markdown blocks
Material Symbols
2 years ago by Cristoph Berane
Callout Manager
2 years ago by eth-p
An Obsidian.md plugin that makes creating and configuring callouts easy.
Emoji Magic
2 years ago by simplgy
Makes it easier to add emojis using an improved keyword search
Auto Hide Cursor
2 years ago by Mo Ismat
A simple plugin for https://obsidian.md
Blur
2 years ago by @gapmiss
A plugin for creating obfuscated blocks of text in Obsidian.md
Iconoir Icons
2 years ago by @gapmiss
A plugin for creating customized icons in Obsidian.md
Background Image
2 years ago by shmolf
Editor Width Slider
2 years ago by @MugishoMp
With this plugin you can set the line width of the editor in obsidian.
Pathfinder 2E Action Icons
2 years ago by Thiago Coutinho
Obsidian plugin for easily insertind the Pathfinder 2E Action icons
CSS Editor
2 years ago by Zachatoo
Edit CSS snippets in Obsidian.
Tokei
2 years ago by HiroMike
A simple clock for Obsidian
Vertical Tabs View
2 years ago by hdykokd
A plugin for Obsidian that provides a vertical tabs view
File Property Enhancer
a year ago by Boninall
Auto Reading Mode
a year ago by Kelvin Cao
Canvas Card Background Remover
a year ago by luxmargos
This Obsidian plugin allows you to make the background of cards transparent in the Canvas for specific embed types, including Image (png), Canvas, and even Markdown.
Additional Icons
a year ago by Matthew Turk
Add additional iconsets to Obsidian
Full Screen Toggle
a year ago by Donkey Pacific
Fullscreen toggle plugin across all platforms for Obsidian.
Font Size Adjuster
a year ago by Ryota Ushio
An Obsidian.md plugin to adjust font size via commands.
Beautitab
a year ago by Andrew McGivery
A plugin for Obsidian.MD that creates a customizable new tab view with beautiful backgrounds, quotes, search, and more.
Status Bar Organizer
a year ago by Kacper Darowski
Arrange and hide status bar elements.
Tag Formatter
a year ago by snsvrno
Configurable Obsidian plugin that hides parent tags.
Metadata Icon
a year ago by Benature
change metadata entry icon
Color cycler
a year ago by Taylor Brennan
Plugin for Obsidian to dynamically change the accent color
Custom Sidebar Icons
a year ago by RavenHogWarts
Custom Icons
Fontsource
a year ago by Ayuhito
A plugin to load custom fonts from Fontsource into Obsidian.
Close Window When Empty
9 months ago by Taylor Jadin
Node Auto Resize
9 months ago by Boninall
Shrink pinned tabs
9 months ago by Nicolas LΕ“uillet
Obsidian plugin to shrink pinned tabs in order to save screen space
Hider
4 years ago by @kepano
Hide Obsidian UI elements such as tooltips, status, titlebar and more
Icons
4 years ago by Camillo Visini
Add icons to your Obsidian notes – Experimental Obsidian Plugin
Icon Swapper
4 years ago by mgmeyers
Allows swapping out Obsidian's icons
Homepage
4 years ago by mirnovov
An Obsidian plugin that opens a specified note, canvas, or workspace on startup, instead of the most recent one.
File Explorer Markdown Titles
4 years ago by Dylan Elliott
Obsidian Plugin that adds the the markdown title within your notes to the file explorer
Zen Mode
4 months ago by paperbenni
Theme Controller
3 months ago by Binaris
Set when and how the themes will be displayed
Backgroundset
2 months ago by daonali
similar as vscode background
Image Preview on Icon Hover
2 months ago by rama1997
Plugin for Obsidian that add image popups when hovering over various icons in the user interface
Context Command Hider
2 months ago by Mara-Li
This plugin allows you to hide every command from the Obsidian's right-click context menu.
Explorer Colors
a month ago by Scott Van der Zwet
Set cascading colors for files and folders in Obsidian.
NerdFont Icon Picker
a month ago by Xaver Wenhart
a simple nerdfont icon picker for obsidian
Hide Commands in Menu
a month ago by bomian98
Obsidian Plugin, hide different commands in different menus.
Note Favicon
15 days ago by mdklab
Obsidian plugin – Show Favicon from Metadata
Smooth Cursor
14 days ago by Busyo
Obsidianε…‰ζ ‡ηΎŽεŒ–ζ’δ»Ά
Wheel Tab Switcher
6 days ago by 22-2
Switch between Obsidian Tabs using your mouse wheel when hovering over tab headers.
Collapsible Code Blocks
5 days ago by Bradley Wyatt
Obsidian Plugin that makes code blocks collapsible in reading and edit view as well as enabling scroll-able code blocks.