spanishst/xtreamfilter repository overview

⁠XtreamFilter

XtreamFilter is a Docker-based Xtream Codes proxy and IPTV media workflow tool. It combines multiple IPTV providers, applies per-source filters, exposes merged or dedicated Xtream and M3U endpoints, and provides a web interface for browsing and managing your content.

⁠Features

• Merge multiple Xtream providers into a single IPTV catalog
• Dedicated routes for each configured provider
• Filter live TV, VOD, and series by groups or channels
• Generate merged and provider-specific Xtream and M3U playlists
• Optional stream proxy mode to hide upstream URLs
• Web interface for source management, browsing, filtering, and playback
• Custom categories with pattern matching and recent-content filters
• Download movies and series episodes with progress tracking
• Series and movie monitoring with automatic episode detection
• Jellyfin and Kodi-compatible downloads with NFO files and poster artwork
• Optional Telegram notifications
• Configurable download scheduling, throttling, and player profiles

⁠Quick Start

Create local directories for persistent data:

mkdir -p data downloads
Run the container:
docker run -d \
  --name xtreamfilter \
  -p 8080:5000 \
  -v "$(pwd)/data:/data" \
  -v "$(pwd)/downloads:/downloads" \
  -e TZ=Europe/Paris \
  -e PUID=1000 \
  -e PGID=1000 \
  --restart unless-stopped \
  spanishst/xtreamfilter:latest

Open the web interface at: http://localhost:8080⁠ Add your Xtream provider credentials, configure filters and routes, refresh the catalog, and then use the generated Xtream or M3U URLs in your IPTV client.

⁠Persistent Storage

The container uses the following directories:

• /data: Application database, configuration, and cache
• /downloads: Downloaded movies, episodes, metadata, and artwork

The PUID and PGID environment variables control ownership of files created in the mounted directories. Set them to match the user and group that own the directories on your host. id -u id -g

⁠Docker Compose

services:
  xtreamfilter:
    image: spanishst/xtreamfilter:latest
    container_name: xtreamfilter
    ports:
      - "8080:5000"
    volumes:
      - ./data:/data
      - ./downloads:/downloads
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
    restart: unless-stopped

Start the service with:

docker compose up -d

Use XtreamFilter only with IPTV services and content that you are authorized to access.