Custom Icons
Enhance your workspace with customizable icons for documents and folders.
![Obsidian Downloads](https://img.shields.io/badge/dynamic/json?logo=obsidian&color=%23483699&label=downloads&query=%24%5B%22custom-sidebar-icons%22%5D.downloads&url=https%3A%2F%2Fraw.githubusercontent.com%2Fobsidianmd%2Fobsidian-releases%2Fmaster%2Fcommunity-plugin-stats.json)
![GitHub stars](https://img.shields.io/github/stars/RavenHogWarts/obsidian-custom-icons?style=flat)
![latest download](https://img.shields.io/github/downloads/RavenHogWarts/obsidian-custom-icons/latest/total?style=plastic)
[![Github release](https://img.shields.io/github/manifest-json/v/RavenHogWarts/obsidian-custom-icons?color=blue)](https://github.com/RavenHogWarts/obsidian-custom-icons/releases/latest)
![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/RavenHogWarts/obsidian-custom-icons?include_prereleases&label=BRAT%20beta)
[中文](https://github.com/RavenHogWarts/obsidian-custom-icons/blob/master/README_ZH.md) | [English](README.md)
Usage
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.
Examples
- 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.
![Usage](https://github.com/RavenHogWarts/obsidian-custom-icons/raw/master/attachment/Usage_EN.png)
Installation
Install from Community Plugins
Click to install, or:
- Open Obsidian and go to
Settings > Community Plugins
.
- Search for "Custom Icons".
- Click "Install".
Install via BRAT Plugin
- Install the BRAT plugin from Community Plugins.
- In the BRAT plugin settings, click "Add Beta Plugin".
- Enter the URL
https://github.com/RavenHogWarts/obsidian-custom-icons
.
- Enable "Custom Icons" in "Third-party Plugins".
Manual Installation
- Download the latest release from Releases.
- Copy
main.js
, styles.css
and manifest.json
to VaultFolder/.obsidian/plugins/custom-sidebar-icons/
.
- Reload plugins and enable "Custom Icons" in "Third-party Plugins".
How to Build
- Clone the repository:
git clone https://github.com/RavenHogWarts/obsidian-custom-icons
.
- Install dependencies:
npm install
.
- Start development:
npm run dev
.
- Build for production:
npm run build
.
License
Custom Icons is licensed under the MIT License. See LICENSE for more information.
Acknowledgements
Support
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!