🌌 Welcome to DanuZz's YouTube Downloader 🚀

---

---

🔧 Installation

``bash
npm install dxz-ytdl
`

$3

`bash
npm install -g dxz-ytdl
`

---

🖥️ CLI Usage

After installing globally, you can use dxz-ytdl directly from your terminal.

$3

`bash
dxz-ytdl --help
`

Output:
`
Usage: dxz-ytdl [options] [command]

Advanced YouTube downloader CLI with search

Options:
-V, --version output the version number
-h, --help display help for command

Commands:
download Download audio/video from YouTube URL
search Search YouTube videos
help [command] display help for a specific command
`

---

$3

Download audio or video from a YouTube URL.

`bash
dxz-ytdl download [options]
`

#### Options:

| Option | Description | Default |
|--------|-------------|---------|
| -f, --format | Format: mp3 or mp4 | mp3 |
| -q, --quality | Quality (see below) | 128k for mp3, 360p for mp4 |
| -o, --output | Output directory path | ./downloads |
| --retries | Max retries for download | 3 |

#### Quality Options:

| Format | Available Qualities |
|--------|---------------------|
| mp3 | 32k, 64k, 128k, 192k, 256k, 320k, best |
| mp4 | 144p, 240p, 360p, 480p, 720p, 1080p, best |

#### Examples:

Download MP3 (default quality 128k):
`bash
dxz-ytdl download "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
`

Download MP3 with specific quality:
`bash
dxz-ytdl download "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f mp3 -q 320k
`

Download MP4 video:
`bash
dxz-ytdl download "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f mp4 -q 720p
`

Download to custom directory:
`bash
dxz-ytdl download "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f mp4 -q 1080p -o ./my-videos
`

Download with retries:
`bash
dxz-ytdl download "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f mp3 -q best --retries 5
`

Sample Output:
`
Starting download for: https://www.youtube.com/watch?v=dQw4w9WgXcQ
Title: Rick Astley - Never Gonna Give You Up
Author: Rick Astley
Preparing mp3 download at 128k quality to ./downloads/Rick_Astley___Never_Gonna_Give_You_Up.mp3...
Duration: 212s
Filesize: 3.45 MB
Saved to: ./downloads/Rick_Astley___Never_Gonna_Give_You_Up.mp3
Download completed successfully!
`

---

$3

Search YouTube videos programmatically.

`bash
dxz-ytdl search [options]
`

#### Options:

| Option | Description | Default |
|--------|-------------|---------|
| -l, --limit | Number of results to return | 10 |
| -t, --type | Type: video or playlist | video |

#### Examples:

Basic search:
`bash
dxz-ytdl search "rick astley never gonna give you up"
`

Search with limit:
`bash
dxz-ytdl search "coding tutorials" -l 5
`

Search for playlists:
`bash
dxz-ytdl search "lo-fi music" -t playlist -l 3
`

Sample Output:
`
Search Results:
1. Rick Astley - Never Gonna Give You Up by Rick Astley (212s) - https://www.youtube.com/watch?v=dQw4w9WgXcQ
2. Rick Astley - Together Forever by Rick Astley (205s) - https://www.youtube.com/watch?v=yPYZpwSpKmA
3. Rick Astley - Whenever You Need Somebody by Rick Astley (197s) - https://www.youtube.com/watch?v=BeyEGebJ1l4
`

---

📺 Programmatic Usage Examples

$3

JavaScript:
`javascript
const { search } = require('dxz-ytdl');

console.log('=== Testing Search ===');
search('rick astley never gonna give you up', { limit: 5 })
.then(results => {
console.log('Search Results:', results);
console.log('First result title:', results[0].title);
console.log('First result URL:', results[0].url);
})
.catch(err => console.error('Search Error:', err.message));
`

Python:
`python
import subprocess, json

command = 'node -e "const { search } = require(\'dxz-ytdl\'); search(\'coding tutorial\', { limit: 5 }).then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

$3

JavaScript:
`javascript
const { ytmp3 } = require('dxz-ytdl');

console.log('=== Testing ytmp3 with random quality (passing null) ===');
ytmp3('https://www.youtube.com/watch?v=dQw4w9WgXcQ', null)
.then(result => {
console.log('Random MP3 Result (quality:', result.quality, '):');
console.log('Title:', result.title);
console.log('Download URL:', result.downloadUrl);
})
.catch(err => console.error('Random MP3 Error:', err.message));
`

Python:
`python
import subprocess, json

command = 'node -e "const { ytmp3 } = require(\'dxz-ytdl\'); ytmp3(\'https://www.youtube.com/watch?v=dQw4w9WgXcQ\', null).then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

$3

JavaScript:
`javascript
const { ytmp3 } = require('dxz-ytdl');

console.log('=== Testing ytmp3 with explicit quality (128k) ===');
ytmp3('https://www.youtube.com/watch?v=dQw4w9WgXcQ', '128k')
.then(result => {
console.log('Title:', result.title);
console.log('Author:', result.author);
console.log('Format:', result.format);
console.log('Quality:', result.quality);
console.log('Download URL:', result.downloadUrl);
})
.catch(err => console.error('Explicit MP3 Error:', err.message));
`

Python:
`python
import subprocess, json

command = 'node -e "const { ytmp3 } = require(\'dxz-ytdl\'); ytmp3(\'https://www.youtube.com/watch?v=dQw4w9WgXcQ\', \'128k\').then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

$3

JavaScript:
`javascript
const { ytmp4 } = require('dxz-ytdl');

console.log('=== Testing ytmp4 with random quality (passing null) ===');
ytmp4('https://www.youtube.com/watch?v=dQw4w9WgXcQ', null)
.then(result => {
console.log('Random MP4 Result (quality:', result.quality, '):');
console.log('Title:', result.title);
console.log('Download URL:', result.downloadUrl);
})
.catch(err => console.error('Random MP4 Error:', err.message));
`

Python:
`python
import subprocess, json

command = 'node -e "const { ytmp4 } = require(\'dxz-ytdl\'); ytmp4(\'https://www.youtube.com/watch?v=dQw4w9WgXcQ\', null).then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

$3

JavaScript:
`javascript
const { ytmp4 } = require('dxz-ytdl');

console.log('=== Testing ytmp4 with explicit quality (360p) ===');
ytmp4('https://www.youtube.com/watch?v=dQw4w9WgXcQ', '360p')
.then(result => {
console.log('Title:', result.title);
console.log('Author:', result.author);
console.log('Format:', result.format);
console.log('Quality:', result.quality);
console.log('Download URL:', result.downloadUrl);
})
.catch(err => console.error('Explicit MP4 Error:', err.message));
`

Python:
`python
import subprocess, json

command = 'node -e "const { ytmp4 } = require(\'dxz-ytdl\'); ytmp4(\'https://www.youtube.com/watch?v=dQw4w9WgXcQ\', \'360p\').then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

$3

Use the options object { path: './filename.ext' } to save files directly.

JavaScript (MP3 Save Example):
`javascript
const { ytmp3 } = require('dxz-ytdl');
const path = require('path');

const savePath = path.join(__dirname, 'test_audio.mp3');
ytmp3('https://www.youtube.com/watch?v=dQw4w9WgXcQ', '128k', { path: savePath })
.then(result => {
console.log('Title:', result.title);
console.log('Author:', result.author);
console.log('Format:', result.format);
console.log('Quality:', result.quality);
console.log('Saved to:', result.savedTo);
})
.catch(err => console.error('Save Error:', err.message));
`

JavaScript (MP4 Save Example):
`javascript
const { ytmp4 } = require('dxz-ytdl');
const path = require('path');

const savePath = path.join(__dirname, 'test_video.mp4');
ytmp4('https://www.youtube.com/watch?v=dQw4w9WgXcQ', '360p', { path: savePath })
.then(result => {
console.log('Title:', result.title);
console.log('Author:', result.author);
console.log('Format:', result.format);
console.log('Quality:', result.quality);
console.log('Saved to:', result.savedTo);
})
.catch(err => console.error('Save Error:', err.message));
`

Python (MP3 Save Example):
`python
import subprocess, json

command = 'node -e "const { ytmp3 } = require(\'dxz-ytdl\'); ytmp3(\'https://www.youtube.com/watch?v=dQw4w9WgXcQ\', \'128k\', { path: \'./audio.mp3\' }).then(r => console.log(JSON.stringify(r)))"'
result = subprocess.getoutput(command)
data = json.loads(result)
print(data)
`

---

📋 API Reference

$3

Search YouTube for videos or playlists.

`javascript
const { search } = require('dxz-ytdl');

const results = await search('query', { limit: 10, type: 'video' });
`

Options:
| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| limit | number | Max results to return | 10 |
| type | string | 'video' or 'playlist' | 'video' |

Returns: Array