A persistent, draggable mascot that displays quotes in your Obsidian workspace
Gemmy is a cute, interactive mascot that sits in your Obsidian workspace and displays quotes in a chat bubble. Whether you want daily motivation, reminders, or just a friendly presence while you work - Gemmy delivers.
| Feature | Description |
|---|---|
| Quote Display | Shows quotes in a stylish chat bubble |
| Idle Talk Mode | Automatically speaks when you stop typing |
| Favorites System | Save quotes you love with one click |
| Focus Mode | Built-in Pomodoro timer with YouTube music |
| Import/Export | Bring your own quotes (JSON/CSV) |
| Custom Avatar | Change Gemmy's appearance |
| Draggable | Position anywhere on screen |
Gemmy displays quotes in a chat bubble. When you stop typing, Gemmy automatically shows a new quote after a configurable delay.
Customizable frequency: Set how often quotes appear (default: 5 seconds of inactivity).
Click the heart icon to save quotes that resonate with you.
| Icon | Meaning |
|---|---|
| 🤍 | Not favorited |
| ❤️ | Favorited |
Switch between Normal Mode (📜) and Favorite Mode (⭐) to filter which quotes are shown.
| Mode | Icon | Behavior |
|---|---|---|
| Normal | 📜 | Cycles through ALL quotes |
| Favorite | ⭐ | Only shows YOUR saved favorites |
Missed a quote? Use Prev / Next buttons to browse through your session history.
Drag Gemmy anywhere on your screen. Position is automatically saved between sessions.
Replace Gemmy's default image with your own mascot!
Options:
- URL (https://...)
- Local file path
- Browse from computer
Browse your entire quote database with a search bar for quick filtering.
Add your own quotes directly from the menu.
Import quotes from JSON or CSV files.
Supported formats:
// Array format
["Quote 1", "Quote 2", "Quote 3"]
// Object format
{ "quotes": ["Quote 1", "Quote 2", "Quote 3"] }Quote 1
Quote 2
Quote 3
Export your entire collection to a JSON file for backup or sharing.
Click the 🎯 button to enter Focus Mode - a built-in Pomodoro timer with YouTube music integration.
| Feature | Description |
|---|---|
| Custom Duration | Set any time (default 25 min) |
| Play/Pause/Stop | Full timer controls |
| Session Complete | Notification when done |
| Feature | Description |
|---|---|
| YouTube Tracks | Add YouTube videos as background music |
| Library Manager | Organize your music collection |
| Random Play | 🎲 Shuffle through your tracks |
| Volume Control | Adjustable slider |
Right-click the menu icon (⋮) to access all features:
| Menu Item | Action |
|---|---|
| Copy Current Quote | Copy to clipboard |
| View Favorite Quotes | Browse saved favorites |
| View All Quotes | Browse entire database |
| Add New Quote | Add your own |
| Import Quotes | Import from file |
| Export Quotes | Export to JSON |
| Import Favourite Quotes | Import favourites from file |
| Export Favourite Quotes | Export favourites to JSON |
| Change Idle Frequency | Adjust timing |
| Change Avatar | Customize mascot |
| Hide Gemmy | Temporarily hide |
Access via Command Palette (Ctrl/Cmd + P):
| Command | Action |
|---|---|
Gemmy: Show Gemmy |
Make Gemmy appear |
Gemmy: Toggle Gemmy |
Show/Hide Gemmy |
Gemmy: Toggle Focus Mode |
Enter/Exit Focus Mode |
- Install the BRAT plugin from Community Plugins
- Open Settings → BRAT → Add Beta Plugin
- Enter:
https://github.com/Gohans1/gemmy - Click Add Plugin, then enable Gemmy in Community Plugins
- Download the latest release from GitHub
- Extract to
.obsidian/plugins/gemmy/ - Enable in Settings → Community Plugins
Access settings via Settings → Gemmy or through the menu.
| Setting | Description | Default |
|---|---|---|
| Idle Frequency | Seconds before new quote | 5 |
| Custom Avatar | URL or path to image | (built-in) |
| Focus Duration | Pomodoro timer length | 25 min |
- License: MIT (code) | CC BY 3.0 (Gemmy character)
Found a bug? Have a feature request?
Open an issue