TELEGRAM ADD-ON · ОТКРЫТЫЙ КОД

Смотрите видео из Telegram
в Stremio и Nuvio.

StreamGram — дополнение для Stremio и Nuvio, которое добавляет источники для просмотра из Telegram прямо в ваше приложение. Добавляйте каналы Telegram как каталоги и просматривайте их видео.

Выберите, как начать

На своём компьютере или сервере

Установите через Docker или Node.js на компьютере, домашнем сервере или VPS.

Инструкция по установке Сервер должен работать постоянно · Нужен публичный HTTPS

Проект на GitHub

Изучайте код, следите за обновлениями, сообщайте об ошибках или участвуйте в разработке.

Открыть GitHub Бесплатно и с открытым кодом · Будем рады звезде
Хотите сначала попробовать? Попробовать на 10 дней

После запуска подключите Telegram и установите личную ссылку дополнения. Медиатека не включена.

Что такое StreamGram?

StreamGram — дополнение для Stremio и Nuvio, которое связывает ваш аккаунт Telegram с плеером. Получайте источники для просмотра из Telegram и добавляйте каналы как каталоги прямо в привычном приложении.

Источники для просмотра из Telegram

Откройте фильм или эпизод в Stremio или Nuvio. StreamGram покажет подходящие источники из Telegram. Выберите источник и нажмите Play.

Каналы как каталоги

Выберите каналы или папки Telegram в настройках. Они появятся как каталоги в плеере: просматривайте видео и выбирайте, что посмотреть.

Глобальный поиск

Ищите в Stremio или Nuvio так же, как в Telegram. StreamGram ищет именно то, что вы ввели, в подключённом аккаунте Telegram и возвращает до 100 подходящих видео. Выберите результат и нажмите воспроизведение.

Нужен аккаунт Telegram с доступом к видео. Контент не включён; ждать полной загрузки файла для просмотра не нужно.

Дополнительные возможности

Непонятное имя файла? Добавьте тег.

Свяжите доступное видео Telegram с фильмом или эпизодом по IMDb или TMDB ID. Теги помогают при несовпадении имён файлов; отмеченные источники получают приоритет.

Поиск на нескольких языках

Выберите английский, иврит, русский, арабский или испанский. Английский всегда включён; другой язык добавляет поиск на нём. Язык интерфейса настраивается отдельно.

Ваш аккаунт, ваша личная ссылка

Подключите несколько аккаунтов Telegram к одному серверу. У каждого будет личная ссылка установки и свои настройки языка поиска и каталогов каналов.

Инструкции по установке

Что подготовить заранее.

После запуска сервера мастер в браузере поможет подключить сервисы. Это понадобится и для облачного хостинга, и для самостоятельной установки.

Данные Telegram API
Создайте API ID и API Hash на my.telegram.org. Мастер запросит их при настройке сервера. my.telegram.org ↗
Токен TMDB
TMDB API Read Access Token нужен для метаданных фильмов и сериалов и сопоставления источников. Он доступен в настройках API вашего аккаунта TMDB. TMDB ↗
Ваш аккаунт Telegram
Войдите по QR-коду или номеру телефона с кодом подтверждения. При включённой двухэтапной проверке Telegram понадобится также пароль.
Работающий сервер и HTTPS
При самостоятельной установке сервер должен работать и иметь публичный HTTPS-адрес. В стороннем сервисе InstaPods хостинг и HTTPS уже включены.
Самостоятельная установка по шагам

StreamGram работает на вашем компьютере или сервере. Оставляйте его включённым и подключённым к интернету во время просмотра. Эти шаги используют Node.js.

  1. Подготовьте компьютер

    Установите Git и Node.js версии 20 или новее. Откройте Terminal в macOS или Linux либо PowerShell в Windows. Установите pnpm этой командой:

    npm install --global pnpm@10.11.0
  2. Скачайте код с GitHub

    git clone скачивает копию проекта на компьютер. cd открывает папку проекта.

    git clone https://github.com/ohadhaviv92/streamgram.git
    cd streamgram
  3. Установите и запустите

    В папке проекта установите зависимости и запустите StreamGram. Перед запуском приложение собирается. Не закрывайте терминал во время использования.

    pnpm install
    pnpm run start
  4. Откройте мастер настройки

    На том же компьютере откройте адрес ниже. Выберите пароль администратора, введите Telegram API ID, API Hash и токен TMDB. Затем подключите Telegram по QR-коду или коду подтверждения.

    http://localhost:3000/dashboard
  5. Настройте HTTPS и установите дополнение

    Локальный адрес нужен для настройки на компьютере. Для просмотра в Stremio требуется публичный HTTPS-адрес сервера, например домен с Caddy или Tailscale Funnel. Укажите его в поле Public URL, откройте панель по публичному адресу и установите дополнение в Stremio или Nuvio. В руководстве GitHub есть инструкции по HTTPS и вариант с Docker.

    Инструкция по установке на GitHub ↗

Настройки и подключения сохраняются в папке data. Сохраняйте её между перезапусками и обновлениями. Не публикуйте её или личную ссылку установки.

Установка на InstaPods по шагам

InstaPods — сторонний хостинг. Эти шаги проведут вас от регистрации до запуска своего сервера StreamGram и установки дополнения.

План Launch
$3/ месяц

Стартовый вариант для личного или семейного использования. Подключите несколько аккаунтов Telegram к одному серверу — у каждого своя приватная ссылка дополнения.

  • Без лимита трафика
  • Отмена в любое время

Кредит $10 для старта

Новые аккаунты получают кредит $10 после добавления способа оплаты — примерно на 100 дней на плане Launch.

Условия кредита и цены ↗
  1. Войдите в InstaPods

    Откройте ссылку и создайте аккаунт. StreamGram уже выбран.

  2. Выберите Launch и разверните

    Выберите регион и план Launch за $3 в месяц, добавьте способ оплаты и запустите развёртывание.

  3. Подключите свои аккаунты

    Откройте сайт, пройдите мастер настройки и подключите аккаунты Telegram. Установите личную ссылку дополнения в Stremio или Nuvio.

Установка на своём VPS или локальном сервере

Запустите StreamGram с Docker или Node.js на сервере под вашим управлением. В руководстве на GitHub описаны установка, настройка и подключение публичного HTTPS-адреса для просмотра.

Инструкция по установке на GitHub

Что стоит знать.

Есть ли в StreamGram фильмы или сериалы?

Нет. StreamGram находит видео, доступные подключённому аккаунту Telegram, и передаёт подходящие потоки в Stremio или Nuvio.

Нужно сначала выбрать каналы?

Нет. Глобальный поиск работает после подключения аккаунта. Выбирайте папки или каналы только для создания каталогов.

Что нужно для собственного сервера?

Постоянно работающий сервер с публичным HTTPS-адресом, данные Telegram API, токен TMDB и ваш аккаунт Telegram. Мастер в браузере поможет с настройкой; полная инструкция есть на GitHub.

Какие приложения поддерживаются?

StreamGram предлагает ссылки установки для Stremio и Nuvio. Подключите Telegram и добавьте личную ссылку дополнения в приложение.

Нужно ли оставлять сервер включённым?

Да. Сервер связывает Telegram с плеером при поиске источников и просмотре. Домашний компьютер со StreamGram должен оставаться включённым и подключённым к интернету во время использования.

Нужно ли платить за StreamGram?

StreamGram бесплатен и имеет открытый код. При самостоятельной установке вы предоставляете компьютер или сервер. InstaPods — платный сторонний хостинг со стартовым кредитом по его условиям. Пробный доступ на 10 дней работает на нашем сервере.

Можно ли делиться ссылкой установки?

Личная ссылка даёт доступ к подключённому аккаунту через дополнение. Храните её в секрете. Для другого аккаунта добавьте его отдельно на сервере и создайте собственную ссылку.