viperadnan/debridui repository overview

⁠DebridUI

A modern debrid client for managing your files, discovering trending movies and shows — with addon support and streaming to your preferred media player.

⁠Community Hosted Instances

• https://debridui.viperadnan.com⁠ - Hosted by creator

⁠Features

⁠File Management

• Multi-account support - Manage multiple debrid accounts seamlessly
• Real-time file tracking - Live updates for download progress and status
• Advanced file explorer - Tree view, search, sorting, and batch operations
• Direct streaming - Stream to VLC, IINA, MPV, PotPlayer, Kodi, MX Player
• Drag & drop uploads - Upload files and links easily

⁠Media Discovery

• Trakt.tv catalogue - Browse trending movies and TV shows
• Smart search - Find content across multiple sources
• Media details - Cast info, ratings, trailers, and recommendations
• Season/episode browser - Navigate TV shows with ease

⁠User Experience

• Dark/Light mode - Automatic theme switching
• Responsive design - Works on desktop, tablet, and mobile
• Keyboard shortcuts - Quick navigation with Cmd/Ctrl+K search
• Progress tracking - Visual indicators for active downloads
• Context menus - Right-click actions for quick operations

⁠Getting Started

⁠Prerequisites

• Node.js 20+ or Bun
• PostgreSQL 14+
• A debrid account (Real-Debrid, TorBox, AllDebrid supported)

⁠Configuration

Copy .env.example to .env.local and fill in the required values:

cp .env.example .env.local

See .env.example⁠ for all available environment variables and their descriptions.

⁠Installation

# Clone the repository
git clone https://github.com/viperadnan-git/debridui
cd debridui

# Install dependencies
bun install

# Configure environment (see Configuration section above)
cp .env.example .env.local

# Set up database
bunx drizzle-kit push

# Run development server
bun run dev

Open http://localhost:3000⁠ to access the app.

⁠Deployment

Vercel (Recommended):

1. Push code to GitHub
2. Import project on Vercel⁠
3. Add PostgreSQL database (Vercel Postgres, Neon, Supabase, etc.)
4. Configure environment variables
5. Deploy

Standalone (Self-hosted):

This app uses Next.js standalone output for optimized self-hosting.

Environment Variables: Ensure all required environment variables from .env.example⁠ are set in your production environment.

# Build the app
bun run build

# Static files are automatically copied to .next/standalone via postbuild script

# Start the server
NODE_ENV=production node .next/standalone/server.js

⁠CORS Proxy

Addons require a CORS proxy to function. Deploy proxy.worker.js to Cloudflare Workers:

1. Create a Cloudflare Workers⁠ account
2. Click "Create Application" → "Create Worker"
3. Replace worker code with contents of proxy.worker.js
4. Update ALLOWED_ORIGINS array with your domain(s)
5. Deploy and copy the worker URL
6. Add to .env.local: NEXT_PUBLIC_CORS_PROXY_URL=https://your.worker.workers.dev?url=

⁠Contributing

Contributions are welcome! Please open an issue or submit a pull request.

⁠Disclaimer

⁠License

GPL-3.0-or-later - see LICENSE⁠ file for details.