Home
← Back to Tools

Local Setup Guide 🛠️

Get YouTube Downloader running on your machine in 2 minutes

Prerequisites

Make sure you have the following installed:

  • ✅ Node.js (v18 or higher) — Download
  • ✅ npm (comes with Node.js)
  • ✅ Git (optional, for cloning)
node --version
npm --version

Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/boring-tools.git
cd boring-tools

Or download the ZIP file and extract it.

2. Install Dependencies

npm install

This installs Next.js, React, yt-dlp, and other dependencies.

3. Install yt-dlp

Choose your operating system:

Windows (via Chocolatey)

choco install yt-dlp

Windows (Manual)

  1. Download from: github.com/yt-dlp
  2. Extract and add to PATH

macOS

brew install yt-dlp

Linux

sudo apt install yt-dlp

Verify installation:

yt-dlp --version

4. Start the App

npm run dev

Open http://localhost:3000/youtube-downloader in your browser.

✅ Why YouTube Downloader Works Better Locally

Online Limitations:

  • ❌ Server-side bandwidth limits
  • ❌ YouTube API rate limits
  • ❌ Legal constraints on servers
  • ❌ Slow downloads

Local Advantages:

  • ✅ Full video quality support
  • ✅ Unlimited download speeds
  • ✅ No rate limits
  • ✅ Complete privacy

❓ Troubleshooting

"yt-dlp not found" Error

Make sure yt-dlp is installed and in your PATH.

yt-dlp --version

Dependencies Installation Fails

Clear npm cache and reinstall:

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

Port 3000 Already in Use

Use a different port:

npm run dev -- -p 3001

FAQ

Can I use the online version instead?

The online version has limitations. Local setup is recommended for full functionality.

Is downloading from YouTube legal?

Downloading is only legal for content you have permission to download. Always respect copyright and YouTube's Terms of Service.

Will my videos be stored on the server?

No! With local setup, everything stays on your computer. Nothing is uploaded or stored anywhere.

← Back to Tools