Skip to content

peritus/obsidian-interactive-ratings

Repository files navigation

Interactive Ratings Plugin for Obsidian

Add interactive rating symbols to your notes that update with a click.

demo of the Interactive Ratings Plugin for Obsidian

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/5 Achievement level
  • 🔥🔥🔥🔥 80% Spice level
  • 🎯🎯🎯🎯🎯🎯 (5/6) Accuracy rating
  • 🏴‍☠️🏴‍☠️🏴‍☠️ (3/5) Pirate movie rating

Installation

  1. In Obsidian settings, go to Community Plugins
  2. Disable Safe Mode
  3. Search for "Interactive Ratings"
  4. 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

About

Edit symbol ratings in your Obsidian notes interactively.

Resources

License

Stars

Watchers

Forks

Packages

No packages published