The Ultimate Media Gallery for Obsidian
Transform your vault into a powerful visual knowledge base

Features • Installation • Quick Start • Documentation • Showcase

Obsidian excels at connecting ideas through text, but what about your images, videos, and visual content?

Lumina bridges this gap by treating media as first-class citizens in your knowledge graph. Tag your screenshots, link photos to project notes, search across thousands of images instantly—all without leaving Obsidian.

• 📁 Media files scattered across folders with no organization
• 🔍 Can't search for images by content or context
• 🔗 No way to connect photos to related notes
• 📝 Manual embedding is tedious and breaks workflow

Lumina provides a unified media experience with powerful tagging, instant search, and seamless note integration.

The heart of Lumina—organize media with the same power you organize notes.

#vacation #2024              → Hashtags like Obsidian
[[Projects/Website]]         → Link to any note
#photo AND [[Paris]]         → Boolean search

Key capabilities:

• Hashtags (#tag) — Familiar tagging syntax
• Note Links ([[Note]]) — Create bidirectional connections
• Boolean Search — AND, OR, NOT operators
• Batch Tagging — Tag hundreds of files at once
• Auto-sync — Tags sync with note frontmatter

📖 Full Tag System Documentation

Embed dynamic galleries directly in your notes:

```lumina
query: #screenshots AND [[Project Alpha]]
layout: masonry
columns: 3
showTags: true
```

Block Features:

• Visual editor (no code required)
• 10+ customizable options
• Live preview
• Drag-and-drop file reordering

Your tagged media appears in Obsidian's global search!

Search for #vacation and see both your notes AND your photos. Media files become discoverable alongside your markdown content.

Full support for 5 languages:

• 🇬🇧 English • 🇫🇷 Français • 🇩🇪 Deutsch • 🇪🇸 Español • 🇨🇳 中文

1. Install BRAT plugin
2. Open Settings → BRAT → Add beta plugin
3. Enter: infinition/obsidian-lumina
4. Enable Lumina in Community Plugins

1. Download from Releases:
   • main.js, manifest.json, styles.css, worker.js
2. Create folder: .obsidian/plugins/obsidian-lumina/
3. Copy files to folder
4. Reload Obsidian & enable plugin

Click the camera icon in the ribbon, or use Ctrl+P → "Open Lumina"

• Scroll through your vault's images and videos
• Zoom with the slider or Ctrl+Wheel
• Filter by folder or media type

1. Right-click any image
2. Select Manage Tags
3. Type #vacation and press Enter
4. Link to a note: type [[ and select a note

Type in the search bar:

#vacation                    → All vacation photos
[[Projects/Alpha]]           → Media linked to a project
#2024 AND #screenshot        → Combined filters
#work NOT #confidential      → Exclusion

Add a Lumina block to any note:

```lumina
query: #vacation
layout: grid
columns: 4
```

Organize research visuals with automatic connections:

Research/
├── Papers/
│   └── AI_Ethics.md           ← Note with research
├── Screenshots/
│   └── chart.png              ← Tagged: #ai [[Papers/AI_Ethics]]
└── Diagrams/
    └── flowchart.jpg          ← Tagged: #ai #diagram

In your note:

## Visual References

```lumina
query: [[Papers/AI_Ethics]] OR #ai
layout: justified
showTags: true
```

Result: A live gallery of all visuals connected to your research!

Tag photos with #travel #paris #2024 and [[Trips/Paris 2024]].

Your trip note becomes a rich visual document that updates automatically as you add more photos.

Organize UI screenshots: #component #button #dark-mode

Search across your entire design library in milliseconds.

Access via Settings → Lumina

Contributions are welcome!

# Clone
git clone https://github.com/infinition/obsidian-lumina.git

# Install
npm install

# Development
npm run dev

# Build
npm run build

MIT © Infinition

⭐ Star this repo if Lumina helps organize your visual knowledge!

Report Bug • Discussions