📺 TV Guide — Программа передач для спутникового ТВ

Веб-приложение для просмотра программы передач российских телеканалов, транслируемых на спутнике Turksat 42°E.

🎯 Возможности

• 14 российских каналов: ТНТ, СТС, НТВ, РЕН ТВ, Россия 24, РТР Планета и другие
• Программа на 7 дней вперёд + вчерашний день
• Автоматическое обновление EPG раз в сутки из источника iptvx.one
• Индикатор "СЕЙЧАС" — текущая передача выделена
• Фильтр по каналам — смотри программу одного канала или всех сразу
• Сдвиг времени для каждого канала — настраивается индивидуально, сохраняется в браузере
• PWA (Progressive Web App) — установи как приложение на телефон или компьютер
• Адаптивный дизайн — работает на телефонах, планшетах и ПК
• Тёмная тема — приятный интерфейс для просмотра

📡 Поддерживаемые каналы

Канал	ID в EPG
5 International	piaty-int
Домашний International	domashny-int
Известия	izvestia
НТВ Мир	ntv-mir
НТВ Право	ntv-pravo
НТВ Сериал	ntv-serial
НТВ Стиль	ntv-style
Перец International	perec-int
РЕН International	rentv-int
РТР Планета	rtr-planeta-eu
Россия 24	rossia-24
СТС International	sts-int
ТНТ International	tnt-int-eu
ТНТ Music	tnt-music

⏱️ Настройка сдвига времени

Спутниковое вещание может отличаться от IPTV-версии канала по времени. Для каждого канала можно настроить индивидуальный сдвиг:

1. Нажмите ⚙️ в шапке нужного канала
2. Используйте кнопки + и − для выбора сдвига (от -12 до +12 часов)
3. Нажмите Сохранить

Настройки сохраняются в localStorage браузера.

📱 Установка как приложение (PWA)

Приложение можно установить на главный экран телефона или компьютера:

Android / Chrome:

• При первом посещении появится баннер «Установить TV RU 42E»
• Нажмите «Установить» — приложение появится на главном экране

iPhone / iPad:

• Нажмите кнопку «Поделиться» (⬆️) в Safari
• Выберите «На экран Домой»
• Нажмите «Добавить»

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

🚀 Установка

Требования

• PHP 7.4+ (с поддержкой gzip)
• Веб-сервер (Apache/Nginx)
• ~200 MB свободного места для XML-файла EPG

Быстрый старт

1. Скопируйте index.php в директорию на веб-сервере
2. Убедитесь что PHP имеет права на запись в эту директорию
3. Откройте страницу в браузере
4. При первом запуске EPG загрузится автоматически (~30 MB архив → ~185 MB XML)

Структура файлов

/your-directory/
├── index.php                    # Основной файл приложения
├── sw.js                        # Service Worker для PWA
├── site.webmanifest             # Манифест для PWA
├── favicon.ico                  # Иконка сайта
├── favicon.svg                  # SVG иконка
├── favicon-96x96.png            # PNG иконка 96x96
├── apple-touch-icon.png         # Иконка для iOS
├── web-app-manifest-192x192.png # PWA иконка 192x192
├── web-app-manifest-512x512.png # PWA иконка 512x512
├── epg_lite.xml                 # Локальный кэш EPG (создаётся автоматически)
└── epg_cache.json               # Кэш программы передач (создаётся автоматически)

⚙️ Конфигурация

В начале файла index.php можно изменить:

$cache_time = 3600;      // Время жизни кэша программ (1 час)
$xml_max_age = 86400;    // Максимальный возраст XML-файла (24 часа)

Добавление каналов

Чтобы добавить канал, найдите его ID в EPG и добавьте в массив $channels_by_id:

$channels_by_id = [
    'channel-id' => 'Отображаемое название',
    // ...
];

🔄 API

Обновление кэша

GET /?action=update_cache

Возвращает JSON с логом загрузки и статистикой.

Получение программы

GET /?action=get_data&date=2025-12-04&channel=all
GET /?action=get_data&date=2025-12-04&channel=tnt-int-eu

Параметры:

• date — дата в формате YYYY-MM-DD (по умолчанию: сегодня)
• channel — ID канала или all для всех

🛠️ Технологии

• Backend: PHP (без фреймворков)
• Frontend: Vanilla JavaScript, CSS3
• Источник данных: iptvx.one EPG_LITE
• Шрифты: Inter, JetBrains Mono (Google Fonts)

📝 Лицензия

MIT License — используйте свободно.

🙏 Благодарности

• iptvx.one — за предоставление EPG данных
• Сообщество vanlife.bez.coffee — за идею и тестирование

---

Сделано с ❤️ для тех, кто смотрит спутниковое ТВ в путешествиях