Media Notify

Веб-панель + Telegram-бот для отправки уведомлений о контенте из Jellyfin выбранным пользователям.

Что умеет

• Получает список фильмов/сериалов из Jellyfin.
• Показывает пользователей Telegram, которые зарегистрировались через /start.
• Отправляет карточку контента в Telegram (с постером и ссылкой на Jellyfin).
• Позволяет менять DateCreated у элемента (и у эпизодов сериала), чтобы управлять блоком «Недавно добавленное».

Требования

• Node.js 18+
• Доступ к Jellyfin API
• Telegram Bot Token

Установка

npm install

Настройка (обязательно)

1. Создайте .env из примера:

cp example.env .env

2. Заполните .env реальными значениями:

• PORT — порт приложения (например, 3002)
• JELLYFIN_URL — URL Jellyfin API (например, http://localhost:8096)
• JELLYFIN_API_KEY — API ключ Jellyfin
• JELLYFIN_USER_ID — ID пользователя Jellyfin, от имени которого читается библиотека
• JELLYFIN_URL_WEB — публичный URL Jellyfin Web (для ссылки в уведомлении)
• TELEGRAM_BOT_TOKEN — токен Telegram-бота
• ADMIN_TOKEN — токен для доступа к API и панели
• DISABLE_ADMIN_TOKEN_AUTH — если true, доступ к панели и API будет работать без ADMIN_TOKEN (только для доверенной локальной сети)

3. Создайте data/users.json из примера:

cp data/users_example.json data/users.json

4. Заполните data/users.json пользователями, которым можно отправлять уведомления.

Пример структуры:

{
  "users": [
    {
      "chatId": 123456789,
      "telegramUsername": "username",
      "firstName": "Name",
      "lastName": "LastName",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Примечание: когда пользователь пишет боту /start, он автоматически добавляется/обновляется в этом файле.

Запуск

npm start

После запуска:

• Панель: http://localhost:<PORT>
• Healthcheck: GET /health

Как пользоваться

1. Откройте панель в браузере.
2. Если защита включена, введите ADMIN_TOKEN в поле сверху.
3. Выберите пользователя из списка.
4. Нажмите «Отправить уведомление» на нужной карточке.
5. При необходимости откройте карточку и измените дату добавления (DateCreated).

Основные API-эндпоинты

Если DISABLE_ADMIN_TOKEN_AUTH=false, защищенные эндпоинты требуют заголовок x-admin-token: <ADMIN_TOKEN>.

• GET /api/users — список пользователей
• GET /api/items?limit=80&search= — список элементов из Jellyfin
• POST /api/notify — отправка уведомления в Telegram (messageText — опционально)
• POST /api/items/:id/date — изменение DateCreated у элемента (и дочерних при applyToChildren=true)
• GET /health — проверка работоспособности