Enhance your workspace with customizable icons for documents and folders.

Tips: 插件安装后需要重新启动当前Obsidian库才能加载到设置数据。

Tips: After installing the plugin, you need to restart the current Obsidian vault to load the setting data.

Currently, there are two ways to set the icons:

• Custom: This includes using online URLs, local relative or absolute file paths, Base64 encodings, or SVG tags.
• Lucide icons: This method requires only the name of the icon from Lucide. Note that the official Obsidian icons also use Lucide icons.

• Online URL: https://www.example.com/favicon.ico
• Local images:
  • Relative path: .obsidian/svg/example.svg
  • Absolute path (Unix-style): /Users/YourUsername/Pictures/example.jpg
  • Absolute path (Windows-style): D:\Pictures\example.png
• Base64 encoding: Starting with data:
• SVG tags: Enclosed within <svg></svg> tags
• Lucide source icons: Directly use the icon name from Lucide.

Click to install, or:

1. Open Obsidian and go to Settings > Community Plugins.
2. Search for "Custom Icons".
3. Click "Install".

1. Install the BRAT plugin from Community Plugins.
2. In the BRAT plugin settings, click "Add Beta Plugin".
3. Enter the URL https://github.com/RavenHogWarts/obsidian-custom-icons.
4. Enable "Custom Icons" in "Third-party Plugins".

1. Download the latest release from Releases.
2. Copy main.js, styles.css and manifest.json to VaultFolder/.obsidian/plugins/custom-sidebar-icons/.
3. Reload plugins and enable "Custom Icons" in "Third-party Plugins".

1. Clone the repository: git clone https://github.com/RavenHogWarts/obsidian-custom-icons.
2. Install dependencies: npm install.
3. Start development: npm run dev.
4. Build for production: npm run build.

Custom Icons is licensed under the MIT License. See LICENSE for more information.

• obsidian-metadata-icon
• Templater

If you find this plugin useful and wish to support its development, you can do so through the following methods: WeChat, Alipay, Love Power Donation or Paypal. Any amount of support is appreciated. Thank you!