cerede2000/tvguide repository overview

⁠TV Guide

Lightweight, self-hosted XMLTV schedule browser with live, evening, grid, and full-text search views.

• English and French UI with browser-language detection
• XML, GZIP, ZIP, 7-Zip, XZ, and BZIP2 imports
• Atomic imports and smart source synchronization
• SQLite FTS5 search
• Administration password support
• Non-root, read-only compatible container
• linux/amd64 and linux/arm64

Source, issues, and release notes: github.com/cerede2000/tvguide⁠

⁠Docker Compose

services:
  tvguide:
    image: cerede2000/tvguide:latest
    container_name: tvguide
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      TZ: Europe/Paris
      ADMIN_PASSWORD: change-this-password
      XMLTV_SYNC_WORKERS: 1
      MALLOC_ARENA_MAX: 2
    volumes:
      - ./data:/data
    security_opt:
      - no-new-privileges:true
    read_only: true
    tmpfs:
      - /tmp:size=16m,mode=1777

mkdir -p data/imports
chown -R 1000:1000 data
docker compose up -d

Open http://localhost:8080, then add an XMLTV source from Administration → XMLTV sources.

⁠Environment variables

The container listens on port 8080, runs as UID/GID 1000, stores all persistent data under /data, and exposes GET /api/health.

⁠Tags

• latest: latest stable release
• 1.17.0: exact release
• 1.17: latest patch in the release line

Pin an exact version for controlled deployments. Database migrations run automatically at startup; back up /data/app.db before upgrades.

Full documentation: English⁠ · Français⁠