jellyfin-notifer

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #golang #android #machine-learning #deep-learning #windows #awesome #vue #awesome-list #pytorch #security #ios

jellyfin-notifer

(★ 14)

No description available.

jellyfin-notifer Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Jellyfin Notifier

**Jellyfin Notifier** — это умный менеджер уведомлений для вашего медиасервера Jellyfin. Приложение решает главную проблему стандартных уведомлений Jellyfin: отсутствие гибкости и фильтрации.

Вместо того чтобы спамить вас уведомлениями о каждом добавленном файле, Jellyfin Notifier фильтрует контент по библиотекам, группирует эпизоды сериалов и отправляет красивые сводки в Telegram по удобному для вас расписанию.

---

## 🌟 Основная Концепция и Суть

Стандартный плагин Webhook в Jellyfin отправляет уведомления обо всех событиях подряд. Если вы добавите сезон сериала, вы получите 10-20 отдельных уведомлений. Если вы добавите контент в папку с домашним видео, вы тоже получите уведомление, которое, возможно, не хотели видеть в основном канале.

**Jellyfin Notifier работает как интеллектуальный фильтр:**

1.  **Фильтрация по библиотекам:** Это ключевая функция. Вы можете настроить "Белый список" (Whitelist) библиотек (например, только "Сериалы", "Аниме", "Фильмы"). Уведомления из других библиотек будут игнорироваться.
2.  **Буфер и Очередь:** Уведомления не отправляются сразу. Они попадают в **Очередь (Queue)**. Это позволяет накапливать данные.
3.  **Группировка:** Если вы добавили 5 серий одного сериала, приложение объединит их в одно аккуратное сообщение: "Добавлены новые эпизоды: S01E01-E05".
4.  **Планировщик:** Вы сами решаете, когда получать уведомления — мгновенно по кнопке или автоматически по Cron-расписанию (например, раз в день вечером).

---

## 📸 Обзор Интерфейса и Настройки

### 1. Настройки Приложения
![Настройки Приложения](https://raw.githubusercontent.com/wolfram0108/jellyfin-notifer/main/docs/0001.png)

Экран настроек — сердце конфигурации. Здесь задаются параметры подключения и фильтрации.

*   **Jellyfin Settings:**
    *   **Server URL:** Адрес вашего сервера Jellyfin (например, `http://192.168.1.100:8096`).
    *   **API Key:** Ключ API, который нужно создать в панели администратора Jellyfin. Он нужен приложению, чтобы запрашивать у сервера детали о медиафайлах (например, имя библиотеки).
    *   **User ID:** ID пользователя (можно найти в URL профиля Jellyfin), от имени которого будут проверяться права доступа (опционально, но полезно).

*   **Whitelist (Белый список библиотек):**
    *   Самая важная настройка. Введите сюда **точные названия** ваших библиотек, уведомления из которых вы хотите получать.
    *   *Пример:* `Фильмы`, `Сериалы 4K`, `Аниме`.
    *   *Как это работает:* Если приходит вебхук о файле из библиотеки "Личное", и её нет в списке, уведомление будет проигнорировано.

*   **Telegram Settings:**
    *   **Bot Token:** Токен вашего Telegram бота (от @BotFather).
    *   **Chat ID:** ID чата или канала, куда слать уведомления.
    *   **Thread ID:** Если используется супергруппа с темами, можно указать ID конкретной ветки.

*   **Scheduler (Планировщик):**
    *   Тип расписания (Interval или Cron).
    *   Можно настроить отправку, например, каждый день в 19:00, чтобы получать сводку новинок за день.

### 2. Очередь (Queue)
![Очередь](https://raw.githubusercontent.com/wolfram0108/jellyfin-notifer/main/docs/0004.png)

Экран **Queue** показывает все уведомления, которые были получены от Jellyfin и прошли фильтрацию, но еще не были отправлены в Telegram.

*   Здесь вы видите, что именно накопилось.
*   Кнопка **"Send Now"** позволяет принудительно отправить всё, что есть в очереди, прямо сейчас, не дожидаясь расписания.
*   Это позволяет проверить, как будет выглядеть сводка, или просто очистить очередь.

### 3. История (History)
![История](https://raw.githubusercontent.com/wolfram0108/jellyfin-notifer/main/docs/0002.png)

Экран **History** разделен на две части (или имеет вкладки):
*   **Webhook Logs:** Полный журнал всех входящих запросов от Jellyfin. Здесь видно:
    *   ✅ **Processed:** Уведомление принято и добавлено в очередь.
    *   🚫 **Ignored:** Уведомление пришло, но было отфильтровано (например, не та библиотека или не тот тип контента).
    *   ❌ **Error:** Ошибки обработки.
*   **Send Logs:** История отправок в Telegram (успешные сводки и ошибки отправки).

---

## 🛠 Установка и Запуск

Проект содержит удобный скрипт запуска, который автоматически настраивает окружение.

1.  **Клонируйте репозиторий:**
    ```bash
    git clone https://github.com/wolfam0108/jellyfin-notifer.git
    cd jellyfin-notifer
    ```

2.  **Запустите установочный скрипт:**
    ```bash
    ./run.sh
    ```
    *Скрипт проверит наличие Conda, создаст окружение, установит зависимости Python (backend) и Node.js (frontend), соберет фронтенд и запустит сервер.*

3.  **Откройте в браузере:**
    Приложение будет доступно по адресу: `http://localhost:8000`

---

## 🔌 Настройка Jellyfin Webhook

Чтобы приложение начало получать данные, нужно настроить Jellyfin.

1.  Откройте панель управления **Jellyfin** -> **Плагины** -> **Каталог**.
2.  Установите плагин **Webhook**.
3.  Перезагрузите сервер Jellyfin, если потребуется.
4.  Перейдите в **Плагины** -> **Webhook** -> **Add Generic Destination**.
5.  Настройте параметры:
    *   **Webhook Name:** `Jellyfin Notifier`
    *   **Webhook Url:** `http://<IP-АДРЕС-ПРИЛОЖЕНИЯ>:8000/webhook/jellyfin`
    *   **Notification Type:** Выберите `Item Added` (Добавление элемента). Остальные типы можно не выбирать, так как приложение ориентировано на новинки.
    *   **Item Type:** Можно оставить пустым (фильтрация происходит в приложении) или выбрать `Movie` и `Episode`.
    *   **Send All Properties:** Рекомендуется включить.

Теперь при добавлении нового контента Jellyfin будет отправлять данные на этот URL, а Jellyfin Notifier будет их фильтровать и складывать в очередь.

jellyfin-notifer

jellyfin-notifer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

jellyfin-notifer

jellyfin-notifer Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README