YTUBE-DL

A modern CLI tool to download YouTube videos with a beautiful interface.

🚀 Quick Start

# Just run this - no installation needed!
npx @zyuapp/ytube-dl@latest

Then paste any YouTube URL and follow the interactive prompts!

Features

• 🎥 Download YouTube videos as 360p MP4 files
• 📊 Interactive mode for URL and output directory
• 📈 Real-time download progress with speed and ETA
• 🎨 Beautiful ASCII banner and colored output
• ⚡ Fast and efficient downloading
• 🔧 Configurable output directory

Installation

Option 1: Use with npx (No installation needed)

# Run directly with npx
npx @zyuapp/ytube-dl

# Or use latest version explicitly
npx @zyuapp/ytube-dl@latest

Option 2: Install globally

# Install globally from npm
npm install -g @zyuapp/ytube-dl

# Then use anywhere
ytube-dl

Option 3: Development setup

# Clone the repository
git clone https://github.com/zyuapp/ytube-dl.git
cd ytube-dl

# Install dependencies
npm install

# Build the project
npm run build

# Link globally (optional)
npm link

Usage

Basic Usage

# Interactive mode (no arguments) - Recommended!
npx @zyuapp/ytube-dl

# Download a video directly
npx @zyuapp/ytube-dl https://www.youtube.com/watch?v=VIDEO_ID

# Use latest version
npx @zyuapp/ytube-dl@latest

# If installed globally
ytube-dl https://www.youtube.com/watch?v=VIDEO_ID

Interactive Mode

# Automatic interactive mode (no URL) - Just run without arguments
npx @zyuapp/ytube-dl

# Explicit interactive mode
npx @zyuapp/ytube-dl --interactive

# If installed globally
ytube-dl
ytube-dl --interactive

Options

• -o, --output - Output directory (default: current directory)
• -i, --interactive - Interactive mode

Examples

# Download to specific directory
npx @zyuapp/ytube-dl https://www.youtube.com/watch?v=VIDEO_ID --output ~/Downloads

# Interactive mode (automatic) - Just run without arguments!
npx @zyuapp/ytube-dl

# Always use latest version
npx @zyuapp/ytube-dl@latest

Development

# Run in development mode
npm run dev

# Run linting
npm run lint

# Run type checking
npm run typecheck

# Build project
npm run build

Requirements

• Node.js >= 20.18.1
• npm or yarn

Video Quality

Downloads are currently limited to YouTube's 360p MP4 video+audio stream. Higher resolutions usually require downloading separate video and audio streams and merging them, which this package does not do yet.

License

MIT