ytdlp-ejs 0.1.1

ejs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

# ytdlp-ejs

YouTube player signature solver implemented in Rust, using SWC for JavaScript parsing and multiple runtime options for execution.

A Rust port of [yt-dlp/ejs](https://github.com/yt-dlp/ejs).

📖 [Improving yt-dlp-ejs with Rust: Smaller and Faster](blog.md)

## Features

- Parse YouTube player JavaScript code
- Extract and execute signature (`sig`) decryption functions
- Extract and execute throttle parameter (`n`) decryption functions
- Multiple JavaScript runtime support: QuickJS, Boa, Node, Deno, Bun
- Cross-platform support (Windows, Linux, macOS)
- Standalone binary under 5MB (with SWC + QuickJS)

## Installation

### From Source

```bash
# Default build (QuickJS + Boa + External runtimes)
cargo build --release

# QuickJS only (smallest binary)
cargo build --release --no-default-features --features qjs

# Boa only
cargo build --release --no-default-features --features boa
```

Binary output: `target/release/ejs`

### As a Library

```toml
[dependencies]
ejs = { git = "https://github.com/ahaoboy/ytdlp-ejs", features = ["qjs"] }
```

## Usage

### Command Line

```bash
# Basic usage
ejs <player_file> [n:<challenge>] [sig:<challenge>]

# Specify runtime
ejs --runtime qjs player.js n:ZdZIqFPQK-Ty8wId
ejs --runtime boa player.js sig:gN7a-hudCuAuPH6f...
ejs --runtime node player.js n:ZdZIqFPQK-Ty8wId sig:gN7a-hudCuAuPH6f...
ejs --runtime deno player.js n:ZdZIqFPQK-Ty8wId
ejs --runtime bun player.js n:ZdZIqFPQK-Ty8wId
```

Output (JSON):

```json
{
  "type": "result",
  "responses": [
    { "type": "result", "data": { "ZdZIqFPQK-Ty8wId": "qmtUsIz04xxiNW" } }
  ]
}
```

### As a Library

```rust
use ejs::{
    process_input_with_runtime, JsChallengeInput, JsChallengeRequest,
    JsChallengeType, RuntimeType,
};

let input = JsChallengeInput::Player {
    player: player_code.to_string(),
    requests: vec![
        JsChallengeRequest {
            challenge_type: JsChallengeType::N,
            challenges: vec!["ZdZIqFPQK-Ty8wId".to_string()],
        },
    ],
    output_preprocessed: false,
};

let output = process_input_with_runtime(input, RuntimeType::QuickJS);
```

## Runtime Options

| Runtime | Feature | Binary Size | External Dependency |
|---------|---------|-------------|---------------------|
| QuickJS | `qjs` | ~5MB | None (embedded) |
| Boa | `boa` | ~8MB | None (embedded) |
| Node | `external` | - | Requires Node.js |
| Deno | `external` | - | Requires Deno |
| Bun | `external` | - | Requires Bun |

## Benchmark (Ubuntu)

| Runtime | Pass | Fail | Total | Time |
|---------|------|------|-------|------|
| qjs | 316 | 0 | 316 | 80.101s |
| node | 316 | 0 | 316 | 87.947s |
| bun | 316 | 0 | 316 | 147.197s |
| boa | 316 | 0 | 316 | 178.557s |
| deno | 316 | 0 | 316 | 238.250s |

Latest results: [bench.yml](https://github.com/ahaoboy/ytdlp-ejs/actions/workflows/bench.yml)