README.md

README.md

Complete FSTV Proxy Server

Docker-based IPTV proxy server with automated scraping and playlist generation.

🚀 Features

• Encoded URLs: Clean proxy URLs like /match/a7k9mq3x.m3u8
• Auto-scraping: Daily at 12:05 AM UTC
• Download endpoints: Direct playlist/EPG downloads (EPG Shows Live Events from when scraped -- it is messed up, no time to work on it ATM)
• Sports + TV: Combined matches and channels
• Real-time streams: Live HLS extraction from FSTV

📁 Setup

1. Create structure:

mkdir fstv-proxy && cd fstv-proxy
mkdir src mappings playlists

2. Copy files:

   • Copy Docker files to root
   • Copy Python files to src/
   • Copy FSTV data files to root

3. Build and run:

docker-compose build
docker-compose up -d

🌐 Server Endpoints

Base URL: http://your-server:6680

Download Endpoints:

• GET /playlist/matches.m3u8 - Sports matches playlist
• GET /playlist/channels.m3u8 - TV channels playlist
• GET /playlist/combined.m3u8 - Combined playlist
• GET /epg/matches.xml - Sports EPG

Streaming Endpoints:

• GET /match/{id}.m3u8 - Match stream
• GET /channel/{id}.m3u8 - TV channel stream

Control Endpoints:

• POST /scrape-now - Manual scrape
• GET /scrape-status - Scrape info
• GET /health - Health check
• GET /stats - Server stats

⏰ Auto-Scraping

• Schedule: 12:05 AM UTC daily (Can add more/multiple times in main.py)
• Covers: Full day events (00:10 - 23:45)
• Updates: Mappings + playlists automatically

🔧 Development

• Edit src/main.py or src/scraper.py
• Run docker-compose restart
• No rebuilding needed!

📊 Usage Example

# Get playlists
curl http://your-server:6680/playlist/combined.m3u8 
(/playlist/matches.m3u8 - Sports matches playlist)
(/playlist/channels.m3u8 - TV channels playlist)

# Manual scrape
curl -X POST http://your-server:6680/scrape-now

# Check status
curl http://your-server:6680/health