A fast, free online video downloader supporting YouTube, Facebook, Instagram, TikTok, and more platforms. Built with React and powered by yt-dlp for reliable video extraction.

• 🎬 Multi-Platform Support - Download videos from YouTube, Facebook, Instagram, TikTok, Twitter/X, Vimeo, and 1000+ more sites
• 📊 Multiple Quality Options - Choose from 360p to 4K resolution
• 🎵 Audio Extraction - Download audio-only in MP3/M4A format
• 📱 Responsive Design - Works seamlessly on mobile and desktop
• ⚡ Rate Limiting - Built-in abuse protection (10 requests/minute)
• 🔒 Secure Processing - Edge function handles all video extraction server-side

• Node.js v18 or higher
• npm or bun package manager
• A deployed yt-dlp server (see Deployment Guide)

# Clone the repository
git clone <YOUR_REPOSITORY_URL>
cd <PROJECT_NAME>

# Install dependencies
npm install

# Start development server
npm run dev

The project uses Lovable Cloud, which automatically configures these environment variables:

⚠️ Required: Set the following secret in Lovable Cloud settings:

How to set the secret:

1. Open your Lovable project
2. Go to Settings → Secrets
3. Add YTDLP_SERVER_URL with your server URL
4. The edge function will automatically use the new URL

├── src/
│   ├── components/          # React components
│   │   ├── ui/              # shadcn/ui components
│   │   ├── Hero.tsx         # Main download interface
│   │   ├── VideoResults.tsx # Download results display
│   │   ├── Header.tsx       # Navigation header
│   │   ├── Footer.tsx       # Site footer
│   │   ├── Features.tsx     # Feature showcase
│   │   └── HowTo.tsx        # Usage instructions
│   ├── pages/               # Page components
│   │   ├── Index.tsx        # Home page
│   │   └── NotFound.tsx     # 404 page
│   ├── hooks/               # Custom React hooks
│   ├── lib/                 # Utility functions
│   └── integrations/        # Backend integrations
├── supabase/
│   └── functions/           # Edge functions
│       └── process-video/   # Video processing function
├── public/                  # Static assets
├── DEPLOYMENT-GUIDE.md      # Detailed deployment instructions
└── README.md                # This file

1. Click "Publish" in the Lovable editor
2. Set the YTDLP_SERVER_URL secret to your yt-dlp server
3. Your app is live!

See DEPLOYMENT-GUIDE.md for detailed instructions:

• ✅ Setting up your yt-dlp server with Node.js
• ✅ Configuring API key authentication
• ✅ Deploying edge functions
• ✅ Nginx/Apache reverse proxy setup
• ✅ SSL certificate configuration
• ✅ Security hardening

The API includes built-in rate limiting to prevent abuse:

Users receive clear feedback when limits are reached, including the time until reset.

• No user data stored - Stateless processing, no database required
• Rate limiting - Prevents abuse and DDoS attacks
• API key protection - yt-dlp server secured with authentication
• CORS configured - Only allows requests from your domain
• Edge function isolation - Server-side processing protects your infrastructure

1. Verify your yt-dlp server is running and accessible
2. Check the YTDLP_SERVER_URL secret is set correctly
3. Ensure the URL includes the protocol (https://)
4. Check server logs for connection issues

• Wait for the cooldown period (shown in error message)
• The limit resets automatically after 60 seconds

• Verify the video URL is valid and publicly accessible
• Some private or age-restricted videos may not be accessible
• Try a different video to test functionality

© 2025 ADL. All rights reserved.

Built with ❤️ using Lovable