# Media Atlas for Obsidian

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/gregeld96/media-atlas?color=purple&style=flat-square)](https://github.com/gregeld96/media-atlas)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)

**Media Atlas** is a high-performance, React-powered media management plugin for Obsidian. It provides a seamless, visual way to browse, search, and organize your vault's images with native integration.

---

## ✨ Features

- 🖼️ **Visual Gallery**: A beautiful grid view of all images in your vault (PNG, JPG, WebP, GIF, SVG).
- 🖱️ **Native Drag & Drop**: Drag images directly from the gallery into your notes. No more manual typing.
- 🔍 **Instant Search**: Find specific images instantly with our lightning-fast filtering system.
- 🔄 **Real-time Sync**: Automatically detects when you add, rename, or delete images in your vault.
- ⚡ **Performance First**: Built with React for a smooth and responsive experience.

---

## 🔥 Media Atlas Pro

Want more power? **Media Atlas Pro** is now available! 

👉 **[Get Media Atlas Pro on Gumroad](https://gregeld.gumroad.com/l/media-atlas-pro)**

The Pro version includes:
- 🚫 **Unused Media Cleaner**: Find and delete images that aren't used in any notes, saving you precious disk space.
- ⚡ **Enhanced Workflow**: Advanced tools to keep your vault clean and organized.
- 🛡️ **Premium Features**: Exclusive access to advanced media management tools.

---

## 🚀 Installation

### 1. Via Community Plugins (Pending Review)
*Go to **Settings** > **Community Plugins** > **Browse** and search for `Media Atlas`.*

### 2. Manual Installation (Beta)
1. Download the latest `main.js`, `manifest.json`, and `styles.css` from the [Releases](https://github.com/gregeld96/media-atlas/releases) page.
2. Go to your Obsidian vault: `.obsidian/plugins/`.
3. Create a folder named `media-atlas`.
4. Move the downloaded files into that folder.
5. Restart Obsidian and enable the plugin in **Settings**.

---

## 🛠️ Tech Stack

- **Framework**: React.js
- **Language**: TypeScript
- **Bundler**: tsup
- **Styling**: Obsidian Native CSS Variables

---

## 🎁 Support the Development

This plugin is free to use. If it helps you manage your media more efficiently, consider supporting the developer to keep the project alive.

- 🌍 **International (PayPal)**: [Ko-fi](https://linktr.ee/gregoriuseldwin)
- 🇮🇩 **Indonesia (QRIS/GoPay/OVO)**: [Saweria](https://linktr.ee/gregoriuseldwin)

---

## 🤝 Contributing

Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

---

## 📄 License

Distributed under the MIT License. See `LICENSE` for more information.

Developed with ❤️ by Gregorius Eldwin Pradipta