# Lampa Plugin — «Мои фильмы»

Плагин добавляет в меню Lampa раздел **«Мои фильмы»**: каталог фильмов с обложками,
описанием и торрентами. Клик по фильму → детали → «Смотреть» → воспроизведение
через настроенный в Lampa torrserver (localhost:8090).

## Структура на сервере

Всё раздаётся по одному базовому URL (например `https://movies.example.com/`):

```
server-root/
├── catalog.json            описание каталога (массив фильмов)
├── covers/
│   ├── inception.jpg
│   └── interstellar.jpg
├── torrents/
│   ├── inception.torrent
│   └── interstellar.torrent
└── plugin.js               (можно раздавать отсюда же или с отдельного хоста)
```

`catalog.json` — см. `catalog.example.json`. Поля фильма:

| поле            | обязательно | назначение                                  |
|-----------------|-------------|---------------------------------------------|
| `id`            | да          | уникальный id                               |
| `title`         | да          | название                                    |
| `original_title`| нет         | оригинальное название                       |
| `year`          | нет         | год                                         |
| `genre`         | нет         | массив жанров                               |
| `rating`        | нет         | рейтинг                                     |
| `description`   | нет         | описание                                    |
| `poster`        | нет         | путь к обложке в `covers/` (или полный URL) |
| `torrent`       | да*         | путь к `.torrent` в `torrents/` (или URL)   |
| `magnet`        | нет         | magnet-ссылка (приоритетнее `torrent`)      |

\* нужен либо `torrent`, либо `magnet`.

## Требования к серверу

- Отдавать `catalog.json`, `covers/*`, `torrents/*` по HTTPS (или HTTP, если Lampa на
  том же устройстве).
- **CORS**: заголовок `Access-Control-Allow-Origin: *` на `catalog.json` и обложки
  (Lampa грузит их из WebView). Торрент torrserver забирает сам — CORS для него не нужен,
  но файл должен отдаваться с корректным типом.
- Любой статический хостинг: nginx, Caddy, GitHub Pages, хостинг торрент-бокса и т.п.

Пример nginx:

```nginx
location / {
    add_header Access-Control-Allow-Origin *;
    try_files $uri $uri/ =404;
}
```

## Установка плагина в Lampa

1. Положи `plugin.js` на доступный по URL хост, запомни прямую ссылку
   (например `https://movies.example.com/plugin.js`).
2. В Lampa: **Настройки → Плагины → Добавить плагин** → вставить URL `plugin.js` → OK.
3. В **Настройки → Плагины → Мои фильмы** (параметр «Адрес сервера каталога»)
   вписать базовый URL сервера (с `/` на конце), напр. `https://movies.example.com/`.
4. В главном меню появится пункт **«Мои фильмы»**.

## Поток воспроизведения

При нажатии «Смотреть» плагин передаёт torrent/magnet в `Lampa.Player`. Дальше
работает уже настроенный в Lampa torrserver (локально `localhost:8090`), который
раздаёт видеопоток плееру. Плагин сам torrserver не трогает.