Flyx 2.0 - Modern Streaming Platform

A full-featured movie and TV show streaming platform built with Next.js 14, featuring multiple video sources, live TV, comprehensive analytics, and flexible deployment options.

Features

Content Discovery

Browse trending movies and TV shows
Advanced search with filters
Detailed movie/show information with cast, ratings, and trailers
Episode-by-episode navigation for TV series
Continue watching functionality

Video Playback

Multiple video source providers (2embed, VidSrc, and more)
Adaptive HLS streaming with quality selection
Live TV support with DLHD integration
IPTV/Stalker portal support
Resume playback from where you left off

Analytics & Admin

Comprehensive admin dashboard
Real-time live activity monitoring
Watch session tracking with completion rates
User analytics (DAU/WAU/MAU metrics)
Device and quality breakdowns
Geographic distribution insights

Privacy-First Design

Anonymous user tracking (no PII collected)
IP address hashing
Local storage for user preferences
GDPR-compliant data collection

Tech Stack

Category	Technology
Framework	Next.js 14 (App Router)
Language	TypeScript
Styling	Tailwind CSS
Database	Neon PostgreSQL (prod) / SQLite (dev)
Deployment	Vercel
Proxy	Cloudflare Workers
API	TMDB

Quick Start

Prerequisites

Node.js 18+ or Bun
TMDB API key (get one here)
Neon database (for production)

Local Development

# Clone the repository
git clone https://github.com/yourusername/flyx.git
cd flyx

# Install dependencies
npm install
# or
bun install

# Copy environment file
cp .env.example .env.local

# Add your TMDB API key to .env.local
# TMDB_API_KEY=your_bearer_token
# NEXT_PUBLIC_TMDB_API_KEY=your_api_key

# Start development server
npm run dev

Open http://localhost:3000 to view the app.

Environment Variables

Required

Variable	Description
`TMDB_API_KEY`	TMDB Bearer token (Read Access Token)
`NEXT_PUBLIC_TMDB_API_KEY`	TMDB API key (for client-side)
`DATABASE_URL`	Neon PostgreSQL connection string (production)

Optional

Variable	Description
`IP_SALT`	Salt for IP address hashing (privacy)
`CRON_SECRET`	Secret for automated metrics updates
`NEXT_PUBLIC_CF_STREAM_PROXY_URL`	Cloudflare stream proxy URL
`NEXT_PUBLIC_CF_TV_PROXY_URL`	Cloudflare TV proxy URL
`RPI_PROXY_URL`	Raspberry Pi proxy URL
`RPI_PROXY_KEY`	Raspberry Pi proxy API key

See .env.example for the complete list with descriptions.

Deployment

Vercel (Recommended)

Create Neon Database
- Sign up at neon.tech
- Create a new project
- Copy the connection string
Deploy to Vercel
- Import your repository to Vercel
- Add environment variables:
  - DATABASE_URL - Your Neon connection string
  - TMDB_API_KEY - Your TMDB Bearer token
  - NEXT_PUBLIC_TMDB_API_KEY - Your TMDB API key
- Deploy!
Access Admin Panel
- Navigate to /admin
- Default credentials: vynx / defaultPassword
- Change the password immediately!

📚 See QUICK_START_VERCEL.md for detailed instructions

Database Setup

Neon PostgreSQL (Production)

Neon is a serverless PostgreSQL database perfect for Vercel deployments.

Create account at neon.tech
Create a new project
Copy connection string (includes ?sslmode=require)
Add as DATABASE_URL in Vercel

Features:

Serverless & auto-scaling
Connection pooling built-in
Free tier available
Automatic backups

📚 See NEON_SETUP.md for complete setup guide

SQLite (Local Development)

For local development, the app automatically uses SQLite when DATABASE_URL is not set. No configuration needed!

Proxy Setup

Flyx supports multiple proxy configurations for different use cases.

Cloudflare Workers (Recommended)

The Cloudflare proxy handles HLS stream proxying and live TV with proper CORS headers.

cd cloudflare-proxy

# Install dependencies
npm install

# Configure wrangler.toml with your settings

# Deploy
npx wrangler deploy

Features:

Stream proxy for HLS content
Live TV proxy for DLHD
Decoder sandbox for secure script execution
Health monitoring endpoint

Environment Variables (after deployment):

NEXT_PUBLIC_CF_STREAM_PROXY_URL=https://media-proxy.your-subdomain.workers.dev/stream
NEXT_PUBLIC_CF_TV_PROXY_URL=https://media-proxy.your-subdomain.workers.dev

📚 See cloudflare-proxy/README.md for detailed setup

Raspberry Pi Proxy

For bypassing datacenter IP restrictions using a residential IP.

# Copy to your Pi
scp -r rpi-proxy [email protected]:~/

# SSH and run
ssh [email protected]
cd rpi-proxy
export API_KEY=$(openssl rand -hex 32)
node server.js

Expose to internet:

Cloudflare Tunnel (recommended)
ngrok
Port forwarding

📚 See rpi-proxy/README.md for complete setup

Hetzner VPS Proxy

For IPTV/Stalker portal streams that block datacenter IPs.

# Copy to VPS
scp -r hetzner-proxy root@your-vps:/opt/

# Install and run
ssh root@your-vps
cd /opt/hetzner-proxy
export API_KEY="your-secret-key"
node server.js

📚 See hetzner-proxy/README.md for complete setup

Admin Panel

Access the admin panel at /admin to manage your platform.

Features

Section	Description
Dashboard	Overview of platform statistics
Analytics	Watch sessions, completion rates, device breakdown
Live Activity	Real-time user monitoring
User Metrics	DAU/WAU/MAU, retention, growth rates

Default Credentials

Username: vynx
Password: defaultPassword

⚠️ Change these immediately after first login!

Admin Commands

# Create admin user
npm run admin:create <username> <password>

# Reset password
npm run admin:reset-password <username> <new-password>

# List admins
npm run admin:list

# Delete admin
npm run admin:delete <username>

📚 See ADMIN_SETUP.md for complete admin guide

Analytics

Flyx includes a comprehensive, privacy-focused analytics system.

Watch Session Tracking

Content watched (title, type, season/episode)
Watch time and completion percentage
Pause/seek behavior
Quality settings
Device type

User Metrics

Daily/Weekly/Monthly Active Users
New vs returning users
Retention rates
Engagement metrics

Live Activity

Real-time user count
Current watching activity
Geographic distribution
Most watched content

📚 See these guides for more:

ANALYTICS_TRACKING.md

ADMIN_ANALYTICS_GUIDE.md

USER_ANALYTICS_GUIDE.md

LIVE_ACTIVITY_GUIDE.md

Project Structure

flyx/
├── app/                    # Next.js App Router
│   ├── components/         # React components
│   ├── context/           # React context providers
│   ├── lib/               # Utilities and services
│   │   ├── hooks/         # Custom React hooks
│   │   └── services/      # API and analytics services
│   ├── api/               # API routes
│   └── admin/             # Admin panel pages
├── server/                # Server-side code
│   └── db/                # Database utilities
├── cloudflare-proxy/      # Cloudflare Worker proxy
├── rpi-proxy/             # Raspberry Pi proxy
├── hetzner-proxy/         # Hetzner VPS proxy
├── scripts/               # Utility scripts
└── public/                # Static assets

Available Scripts

Script	Description
`npm run dev`	Start development server
`npm run build`	Build for production
`npm start`	Start production server
`npm run lint`	Run ESLint
`npm test`	Run tests
`npm run type-check`	TypeScript type checking
`npm run db:init`	Initialize database
`npm run db:migrate`	Run database migrations
`npm run db:status`	Check migration status
`npm run verify-env`	Verify environment setup

Documentation

Guide	Description
QUICK_START_VERCEL.md	5-minute Vercel deployment
VERCEL_DEPLOYMENT.md	Complete Vercel guide
VERCEL_SETUP_CHECKLIST.md	Step-by-step checklist
NEON_SETUP.md	Neon PostgreSQL setup
ADMIN_SETUP.md	Admin panel configuration
ANALYTICS_TRACKING.md	Analytics system overview
ADMIN_ANALYTICS_GUIDE.md	Using the analytics dashboard
USER_ANALYTICS_GUIDE.md	User metrics guide
LIVE_ACTIVITY_GUIDE.md	Real-time monitoring
ANONYMIZED_USER_TRACKING.md	Privacy & tracking details

API Integration

TMDB API

The app uses TMDB for all movie and TV show metadata:

Trending content
Search functionality
Movie/show details
Cast and crew information
Season and episode data

Getting a TMDB API Key:

Create account at themoviedb.org
Go to API settings
Request an API key (Developer option)
Copy both the API Key and Bearer Token

Troubleshooting

Database Connection Issues

# Verify environment
npm run verify-env

# Check database status
npm run db:status

# Initialize database
npm run db:init

Vercel Deployment Errors

Ensure DATABASE_URL is set in Vercel environment variables
Check that all three environments are selected (Production, Preview, Development)
Redeploy after adding variables

Stream Not Loading

Check Cloudflare Worker is deployed
Verify proxy URLs in environment variables
Check browser console for CORS errors
Test health endpoint: curl https://your-proxy.workers.dev/health

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Credits

Special Thanks

IPTV - Huge thanks to MoldyTaint/Cinephage for his amazing help with sourcing IPTV!

Resources

Movie & TV Data - TMDB (The Movie Database)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter issues:

Check the relevant documentation guide
Review deployment logs
Verify environment variables
Open an issue on GitHub

Made with ❤️

Name		Name	Last commit message	Last commit date
Latest commit History 377 Commits
app		app
cloudflare-proxy		cloudflare-proxy
data		data
examples		examples
hetzner-proxy		hetzner-proxy
public		public
rpi-proxy		rpi-proxy
scripts		scripts
server/db		server/db
source-testing		source-testing
tests/decoders		tests/decoders
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
ADMIN_ANALYTICS_GUIDE.md		ADMIN_ANALYTICS_GUIDE.md
ADMIN_SETUP.md		ADMIN_SETUP.md
ANALYTICS_TRACKING.md		ANALYTICS_TRACKING.md
ANONYMIZED_USER_TRACKING.md		ANONYMIZED_USER_TRACKING.md
LIVE_ACTIVITY_GUIDE.md		LIVE_ACTIVITY_GUIDE.md
NEON_SETUP.md		NEON_SETUP.md
QUICK_REFERENCE_USER_ANALYTICS.md		QUICK_REFERENCE_USER_ANALYTICS.md
QUICK_START_VERCEL.md		QUICK_START_VERCEL.md
README.md		README.md
REDDIT_POST_DEC2025.md		REDDIT_POST_DEC2025.md
USER_ANALYTICS_GUIDE.md		USER_ANALYTICS_GUIDE.md
VERCEL_DEPLOYMENT.md		VERCEL_DEPLOYMENT.md
VERCEL_SETUP_CHECKLIST.md		VERCEL_SETUP_CHECKLIST.md
bun.test.setup.ts		bun.test.setup.ts
bunfig.toml		bunfig.toml
dlhd-player-page.html		dlhd-player-page.html
jest.setup.js		jest.setup.js
mac-scan-tested.json		mac-scan-tested.json
next-env.d.ts		next-env.d.ts
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
tsconfig.tsbuildinfo		tsconfig.tsbuildinfo
vercel.json		vercel.json

Dovakin24/Flyx-main

Folders and files

Latest commit

History

Repository files navigation

Flyx 2.0 - Modern Streaming Platform

Features

Content Discovery

Video Playback

Analytics & Admin

Privacy-First Design

Tech Stack

Quick Start

Prerequisites

Local Development

Environment Variables

Required

Optional

Deployment

Vercel (Recommended)

Database Setup

Neon PostgreSQL (Production)

SQLite (Local Development)

Proxy Setup

Cloudflare Workers (Recommended)

Raspberry Pi Proxy

Hetzner VPS Proxy

Admin Panel

Features

Default Credentials

Admin Commands

Analytics

Watch Session Tracking

User Metrics

Live Activity

Project Structure

Available Scripts

Documentation

API Integration

TMDB API

Troubleshooting

Database Connection Issues

Vercel Deployment Errors

Stream Not Loading

Contributing

Credits

Special Thanks

Resources

License

Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages