Skip to content

rama1997/Image-Preview-On-Icon-Hover

Repository files navigation

Image Preview on Icon Hover

Enhance your Obsidian experience by adding image popups when hovering over various icons in the user interface!

Descriptive Alt Text

✨ Features

  • Custom Image Previews: Add your own images to hover over various Obsidian icons
  • Flexible Configuration: Customize images for:
    • Vault Switcher
    • Help Icon
    • Settings Icon
    • Left/Right Sidebar Toggles
    • Ribbon Bar Icons
    • Status Bar Icons
  • Interactive Icon Management:
    • Add, remove, and customize ribbon bar icons and status bar icons
    • Search and select from a wide range of Obsidian icons
    • Easily assign custom images to any icon

🚀 Installation

From Obsidian's Community Plugins

  1. Open Obsidian
  2. Go to Settings → Community Plugins
  3. Enable Community Plugins if not already done
  4. Click "Browse" and search for "Image on Icon Hover"
  5. Click "Install"

From GitHub

  1. Download the Latest Release from the Releases section of the GitHub Repository
  2. Put files to your vault's plugins folder: /.obsidian/plugins/image-preview-on-icon-hover
  3. Reload Obsidian

🎨 Usage

Configuring Core Obsidian Icons

  1. Open Obsidian Settings
  2. Navigate to the "Image on Icon Hover" tab
  3. You'll find sections for:
    • Left/Right Sidebar Toggle
    • Vault Switcher
    • Help Icon
    • Setting Icon
  4. Enter the path to your desired image (e.g., images/example.png)

Managing Ribbon and Status Bar Icons

  1. In the plugin settings, you can:
    • Add new icons with the "+" button
    • Select icons
    • Choose unique images for each icon
    • Delete existing icons

Image Path Guidelines

  • Use relative paths from your vault root

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🐛 Reporting Issues

If you encounter any issues or have suggestions for improvements, please open an issue on the GitHub repository.

About

Plugin for Obsidian that add image popups when hovering over various icons in the user interface

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published