README file from
GithubInteractive Ratings Plugin for Obsidian
Add interactive rating symbols to your notes that update with a click.
Supported Symbol Sets
| Symbol Type | Full | Empty | Half | Examples |
|---|---|---|---|---|
| Stars | ★ | ☆ | ★★★☆☆ (3/5) Book rating |
|
| Star Symbols | ✦ | ✧ | ✦✦✦✧✧ (3/5) Stargazing |
|
| Moon Phases | 🌕 | 🌑 | 🌗 | 🌕🌕🌗🌑🌑 (2.5/5) Lunar observation |
| Circles | ● | ○ | ◐ | ●●●○○○○○○○ 3/10 Movie review scale |
| Squares | ■ | □ | ◧ | ■■■□ (3/4) Recipe difficulty |
| Triangles | ▲ | △ | ▲▲▲▲▲△△△△△△△ 5/12 Hiking difficulty |
|
| Red Hearts | ❤️ | 🤍 | ❤️❤️❤️🤍🤍 (3/5) Celebrity crush |
|
| Orange Hearts | 🧡 | 🤍 | 🧡🧡🧡🧡🤍 80% Sunset addiction |
|
| Yellow Hearts | 💛 | 🤍 | 💛💛🤍🤍 2/4 Wizard vibes |
|
| Green Hearts | 💚 | 🤍 | 💚💚💚🤍🤍🤍 50% Plant guilt |
|
| Blue Hearts | 💙 | 🤍 | 💙💙🤍🤍🤍 (2/5) Ocean yearning |
|
| Purple Hearts | 💜 | 🤍 | 💜💜💜💜🤍 4/5 Unicorn belief |
|
| Black Hearts | 🖤 | 🤍 | 🖤🖤🖤🤍 75% Villain sympathy |
|
| Brown Hearts | 🤎 | 🤍 | 🤎🤎🤍🤍🤍 (2/5) Chocolate dependency |
|
| Block Progress | █ | ▁ | ███▁▁▁ (3/6) Project completion |
|
| Braille Dots | ⣿ | ⣀ | ⡇ | ⣿⣿⡇⣀⣀⣀⣀⣀⣀⣀ 2.5/10 |
| Solid/Empty Circles | ⬤ | ○ | ⬤⬤⬤○○○○○○○○○ 25% Budget spending |
|
| Solid/Empty Squares | ■ | □ | ■■■□□□□ 3/7 Weekly progress |
|
| Dotted Squares | ▰ | ▱ | ▰▰▰▱▱▱▱▱▱▱ (3/10) Task complexity |
|
| Filled/Empty Rectangles | ◼ | ▭ | ◼◼◼▭ 75% Reading progress |
|
| Vertical Bars | ▮ | ▯ | ▮▮▮▮▮▮▯▯▯▯▯▯ 50% Battery level |
|
| Bold Circles | ⬤ | ◯ | ⬤◯◯ 1/3 Quick product review |
|
| Black/White Circles | ⚫ | ⚪ | ⚫⚫⚫⚫⚫⚪⚪⚪⚪⚪ (5/10) Coffee strength |
|
| Block/Light Shade | █ | ░ | ███░░░░░░░ 30% Download progress |
Usage
Type any supported symbol sequence (minimum 3 identical symbols) in your note. When you hover over these symbols in edit mode, clicking on one of the symbols allowing you to update the rating.
Rating Text (optional)
Add numerical ratings with these formats:
★★★☆☆- Only symbols, no rating text★★★☆☆ 3/5- Fraction without parentheses★★★☆☆ (3/5)- Fraction in parentheses★★★☆☆ 60%- Percentage★★★☆☆ (60%)- Percentage in parentheses
The numerical rating updates automatically when you change the symbols.
Custom Emojis
You can configure which emojis are supported for rating interactions by going to Settings → Community Plugins → Interactive Ratings. In the "Emojis to support in ratings" setting, enter any emojis you want to use for ratings.
Default emojis: 🎥🏆⭐💎🔥⚡🎯🚀💰🎖️
ZWJ Sequence Support: The plugin fully supports complex emojis including ZWJ (Zero Width Joiner) sequences such as:
- 🏴☠️ (Pirate Flag)
- 👨🚒 (Man Firefighter)
- 🏳️🌈 (Rainbow Flag)
- And other compound emojis
Example usage:
🎥🎥🎥🎥🎥 (4/5)Movie rating🏆🏆🏆 3/5Achievement level🔥🔥🔥🔥 80%Spice level🎯🎯🎯🎯🎯🎯 (5/6)Accuracy rating🏴☠️🏴☠️🏴☠️ (3/5)Pirate movie rating
Installation
- In Obsidian settings, go to Community Plugins
- Disable Safe Mode
- Search for "Interactive Ratings"
- Install and enable the plugin
Use Cases
- Book/Media Reviews:
★★★★☆☆☆☆☆☆ Just okay, 4/10 - Habit Tracking:
Exercise: ●●●○○○○ (3/7) days this week - Project Status:
Client project: ████████░░ 80% complete - Recipe Notes:
Pasta recipe: ■■■□ (3/4) difficulty, would make again - Learning Progress:
Spanish vocabulary: ⬤⬤⬤⬤⬤⬤◯◯◯◯ 60% mastered
Support
For issues or feature requests: GitHub repository
License
MIT