jocles
v1.0.5
Published
Jocles - A powerful YouTube video downloader with interactive CLI
Downloads
446
Maintainers
Readme
Jocles
📥 One command. Any video. A powerful YouTube video downloader with interactive CLI.
Quick Install
# Install globally with npm
npm install -g jocles
# Run it!
joclesOr use without installing:
npx joclesFeatures
- 🎯 Interactive Mode - Menu-driven interface, no commands to memorize
- 🚀 One-Click Install - Just
npm install -g joclesand you're ready - 📊 Progress Tracking - Real-time download progress with speed and ETA
- 🎬 Quality Selection - Choose from Best, 1080p, 720p, 480p, 360p, or Audio Only
- 🔄 Auto Updates - Built-in yt-dlp updater
Usage
Interactive Mode (Recommended)
joclesYou'll see a beautiful menu:
- 📥 Download Video - Paste URL → Select quality → Watch progress
- 📋 Get Video Info - View title, duration, views, etc.
- 🎯 List Formats - See all available formats
- 🔄 Update yt-dlp - Keep the downloader up to date
Command Line Mode
# Download video
jocles download "https://youtube.com/watch?v=VIDEO_ID"
# Download with quality preset
jocles download "URL" -q 720p
# Audio only
jocles download "URL" --audio-only
# Get video info
jocles info "URL"
# List formats
jocles formats "URL"Options
| Option | Description |
|--------|-------------|
| -q, --quality | Quality preset: best, 1080p, 720p, 480p, 360p, audio-only |
| -o, --output | Output path or template |
| --audio-only | Extract audio only |
| --audio-format | Audio format: mp3, aac, m4a, opus, flac, wav |
Requirements
- Node.js 18+
- yt-dlp (automatically downloaded on first run)
License
MIT
