Skip to content

A modern debrid client with built-in media discovery and streaming.

License

Notifications You must be signed in to change notification settings

viperadnan-git/debridui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

387 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DebridUI

Deployment Next.js TypeScript Tailwind CSS GitHub repo size License

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

Important

This project does not provide, host, or stream any content. DebridUI is a client interface that connects to third-party debrid service APIs to display authorized users' private files and content. Read full disclaimer.

Community Hosted Instances

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

⚠️ Important Legal Notice: This project is a client interface only and does not host, store, or distribute any content. Users are solely responsible for ensuring their use complies with all applicable laws, copyright regulations, and third-party service terms. By using this software, you acknowledge and agree to the full disclaimer.

License

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

Packages

 
 
 

Contributors

Languages