Beam-web

A modern streaming web application for movies and TV shows.

I do not endorse piracy of any kind I simply enjoy programming and large user counts.

Quick Start

git clone https://github.com/Beam-Archive/Beam-web.git
cd Beam-web
pnpm install
pnpm run dev

Visit http://localhost:5173

Documentation

Getting Started

• Installation Guide - Complete installation instructions
• Quick Start - Get running in 5 minutes
• Configuration Guide - Environment setup and customization

Features & Usage

• Features Overview - Complete feature list
• Architecture - Technical architecture and design
• Development Guide - Contributing and development workflow

Supabase Integration

• Supabase Setup - Profile picture setup guide
• Setup Checklist - Verification checklist
• How It Works - Technical implementation details
• SQL Setup Script - Database setup

Quick Deploy

NOTE: To self-host, more setup is required. Check the installation guide to properly set up!

Features

• Stream movies and TV shows
• Custom video player with HLS support
• User accounts with encrypted sync
• Bookmarks and watch history
• Profile pictures with Supabase
• Multiple themes
• Multi-language support
• PWA support
• Chromecast support
• Keyboard shortcuts

See FEATURES.md for complete feature list.

Configuration

Required Environment Variables

VITE_TMDB_READ_API_KEY=your_tmdb_api_key

Optional Environment Variables

VITE_BACKEND_URL=https://your-backend-url.com
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

See CONFIGURATION.md for all configuration options.

Development

# Install dependencies
pnpm install

# Start dev server
pnpm run dev

# Run tests
pnpm run test

# Lint code
pnpm run lint

# Build for production
pnpm run build

See DEVELOPMENT.md for detailed development guide.

Project Structure

Beam-web/
├── docs/              # Documentation
├── src/
│   ├── backend/       # Backend integration
│   ├── components/    # React components
│   ├── pages/         # Page components
│   ├── stores/        # State management
│   └── utils/         # Utilities
├── themes/            # Theme definitions
└── public/            # Static assets

See ARCHITECTURE.md for detailed architecture.

Links And Resources

Service	Link	Source Code
P-Stream Docs	docs	source code
Extension	extension	source code
Proxy	simple-proxy	source code
Backend	backend	source code
Frontend	P-Stream	source code
Weblate	weblate

Referrers

• FMHY (Voted as #1 multi-server streaming site of 2024)
• Piracy Subreddit Megathread
• Toon's Instances
• Entertainment Empire
• Search Engines: DuckDuckGo, Bing, Google
• Rentry.co

License

See LICENSE.md