**Memories** — мощный плагин для Obsidian, который превращает ваши медиафайлы в красивые интерактивные галереи прямо внутри заметок. Просматривайте изображения, видео и аудио с поддержкой полноэкранного режима, слайдшоу и продвинутых функций навигации.
## ✨ Возможности
### 🎨 Гибкое отображение
- **Адаптивная сетка** — автоматическая компоновка под любой размер экрана
- **Два режима отображения** — полный (full) и компактный (compact)
- **Настраиваемый размер** — контроль размера элементов сетки
- **Ленивая загрузка** — оптимизация производительности для больших коллекций
- **📤 Встроенный менеджер файлов** — загрузка и удаление медиа прямо из галереи
### 🔍 Продвинутый Lightbox
- **Масштабирование изображений** — зум с поддержкой панорамирования
- **Мультимедийная поддержка** — изображения, видео и аудио файлы
- **Интерактивные миниатюры** — быстрая навигация по коллекции
- **Горячие клавиши** — полноценное управление с клавиатуры
### ⚡ Умные функции
- **Автослайдшоу** — автоматическая смена с настраиваемым интервалом
- **Случайный режим** — рандомная навигация по медиа
- **Гибкая сортировка** — по дате, имени или случайный порядок
- **Кеширование миниатюр** — быстрая загрузка для видеофайлов
### 📁 Универсальные источники
- **Множественные пути** — медиа из нескольких папок одновременно
- **Рекурсивный поиск** — сканирование всех вложенных папок
- **Корневой доступ** — отображение всех медиафайлов хранилища
🌌 Визуальный обзор
## 📦 Установка
### Метод 1: Через Community Plugins (рекомендуется)
1. Откройте **Настройки** → **Community plugins**
2. Отключите **Restricted mode**, если он включен
3. Нажмите **Browse** и найдите **"Memories"**
4. Нажмите **Install**, затем **Enable**
### Метод 2: Ручная установка
1. Скачайте последнюю версию из [релизов](https://github.com/DIMFLIX/obsidian-memories/releases)
2. Создайте папку `memories` в `.obsidian/plugins/` вашего хранилища
3. Распакуйте файлы в созданную папку
4. Перезагрузите Obsidian и активируйте плагин в настройках
## 🚀 Использование
### Базовый синтаксис
Создайте кодовый блок с типом `memories` в вашей заметке:
````markdown
```memories
paths: Photos/
sort: date-desc
type: compact
limit: 9
```
````
### Полная конфигурация
````markdown
```memories
paths: Photos/Vacation, Photos/Family
sort: date-desc
type: full
size: 250
lazy: true
limit: 12
```
````
## ⚙️ Параметры конфигурации
### 📍 Указание путей
**Одна папка:**
```yaml
paths: Photos/Vacation
```
**Несколько папок:**
```yaml
paths: Photos/Vacation, Photos/Family, Media/Videos
```
**Все медиа из хранилища:**
```yaml
paths: ./
```
### 🔄 Сортировка
```yaml
sort: date-desc
```
**Доступные варианты:**
- `date-desc` — по дате (новые сначала) ⏰
- `date-asc` — по дате (старые сначала) 🕰️
- `name-asc` — по имени (алфавит) 🔤
- `random` — случайный порядок 🎲
### 🎯 Режимы отображения
**Полная галерея:**
```yaml
type: full
```
Отображает все медиафайлы в выбранных папках.
**Компактный режим:**
```yaml
type: compact
limit: 6
```
Показывает ограниченное количество файлов с возможностью просмотра всех в lightbox.
### ⚡ Производительность
```yaml
lazy: true
size: 200
```
- `lazy` — ленивая загрузка для оптимизации производительности
- `size` — размер элементов сетки в пикселях
## 🎮 Управление в Lightbox
### ⌨️ Горячие клавиши
- **← / →** — предыдущее/следующее медиа
- **Пробел** — запуск/остановка слайдшоу
- **Esc** — закрыть lightbox
- **Колесо мыши** — навигация по медиа
### 🖱️ Управление изображениями
- **Левый клик** — увеличение (масштаб до 5x)
- **Правый клик** — уменьшение
- **Колесо на изображении** — плавное масштабирование
- **Перетаскивание** — панорамирование при увеличении
### 🎪 Дополнительные функции
- **🎲 Random** — случайная навигация по коллекции
- **▶️ Slideshow** — автоматическое слайдшоу (интервал 1-60 сек)
- **📊 Информация** — размер файла и дата изменения
- **📁 Открыть в проводнике** — быстрый доступ к файлу
## 🎨 Поддерживаемые форматы
### 🖼️ Изображения
- **Основные:** JPG, JPEG, PNG, GIF, BMP, SVG, WebP
- **Расширенные:** TIFF, TIF, AVIF, HEIC, HEIF, ICO
### 🎥 Видео
- **Современные:** MP4, WebM, OGV, MOV
- **Классические:** AVI, MKV, FLV, WMV, 3GP, M4V
- **Профессиональные:** MPG, MPEG, M2V, ASF
### 🎵 Аудио
- **Популярные:** MP3, WAV, FLAC, OGG, AAC, M4A
- **Специализированные:** WMA, Opus, AIFF, AU
## ⚡ Производительность
### 🚀 Оптимизации
- **Ленивая загрузка** — элементы загружаются по мере прокрутки
- **Кеширование миниатюр** — быстрые превью для видеофайлов
- **Виртуализация** — эффективное отображение больших коллекций
- **Интеллектуальное наблюдение** — Intersection Observer для плавной работы
### 📊 Рекомендации
- Используйте `lazy: true` для галерей с более чем 20 элементами
- Оптимальный `size` — 200-300 пикселей для баланса детализации и производительности
- Компактный режим (`type: compact`) для быстрого просмотра больших коллекций
## 🐛 Устранение неполадок
### 🔍 Галерея не отображается
- Проверьте правильность пути к папке
- Убедитесь, что папка содержит поддерживаемые медиафайлы
- Проверьте синтаксис кодового блока
### 🎥 Видео не воспроизводятся
- Убедитесь, что формат поддерживается вашим браузером
- Проверьте целостность видеофайлов
- Для проблемных форматов используйте MP4 как универсальный вариант
### ⚡ Медленная загрузка
- Включите ленивую загрузку: `lazy: true`
- Используйте компактный режим для больших коллекций
- Убедитесь, что миниатюры видео кешируются
### 🔧 Техническая диагностика
- Откройте консоль разработчика (Ctrl+Shift+I) для просмотра ошибок
- Проверьте разрешения доступа к файлам
- Убедитесь, что плагин активирован в настройках
## 🤝 Поддержка и развитие
### 📝 Сообщение об ошибках
Нашли баг? [Создайте issue](https://github.com/DIMFLIX/obsidian-memories/issues) с подробным описанием:
- Шаги для воспроизведения
- Ожидаемое и фактическое поведение
- Версия Obsidian и плагина
### 💡 Предложения функций
Есть идея для улучшения? Мы рады предложениям! Опишите:
- Какую проблему решает ваше предложение
- Конкретный вариант реализации
- Примеры использования
### 🌟 Поддержка проекта
- ⭐ Поставьте звезду на GitHub
- 📢 Расскажите о плагине в соцсетях
- 💻 Участвуйте в разработке через PR
## 📄 Лицензия
Плагин распространяется как open-source проект под [MIT лицензией](./LICENSE).
---
**Сделано с ❤️ для сообщества Obsidian**
[⭐ Star on GitHub](https://github.com/DIMFLIX/obsidian-memories) ·
[🐛 Report Bug](https://github.com/DIMFLIX/obsidian-memories/issues) ·
[💡 Request Feature](https://github.com/DIMFLIX/obsidian-memories/issues)
