VFootball

Live football streaming platform with real-time match tracking, multi-provider IPTV support, and admin dashboard.

Quick Start

# Install all dependencies
npm install

# Configure backend
cp backend/.env.example backend/.env
# Edit backend/.env with your API keys and provider credentials

# Start everything (backend + both frontends)
npm run dev

• Backend API: http://localhost:5001
• User Frontend: http://localhost:3000
• Admin Dashboard: http://localhost:3001

Project Structure

VFootball/
├── backend/            # Express API server
│   ├── routes/         # API endpoints
│   ├── services/       # Business logic (matches, providers, auth)
│   ├── middleware/     # Auth, CORS, rate limiting
│   ├── utils/          # Helpers (logger, encryption, channel matching)
│   ├── config/         # Environment and app config
│   ├── data/           # Provider configs, EPG data
│   └── server.js       # Entry point
├── frontend-user/      # React app for end users
│   ├── src/pages/      # Home, match detail, stream player, channels
│   ├── src/services/   # API client
│   └── src/components/ # Shared components
├── frontend-admin/     # React admin dashboard
│   ├── src/components/ # Dashboard, login, provider manager
│   └── src/contexts/   # Auth context
├── shared-branding/    # Shared CSS design system
└── docs/               # API, architecture, and deployment docs

Features

• Real-time football match listings with live scores
• Multi-provider IPTV stream discovery
• HLS proxy for CORS-free streaming
• FFmpeg-based restreaming
• JWT admin authentication
• EPG channel indexing
• Rate limiting and API key support

Tech Stack

• Backend: Node.js, Express, JWT, FFmpeg
• Frontend: React 18, React Router, Axios, HLS.js
• APIs: API-Football, IPTV providers

License

MIT