You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This command launches an automated browser instance and listen on requests. Behavior may vary, and it may not work as expected on all websites. This is equivalent to manually doing:
55
+
This command launches an automated browser instance and listen on network requests. Behavior may vary, and it may not work as expected on all websites. This is equivalent to manually doing:
56
56
57
57
Inspect -> Network -> Fetch/XHR -> Filter by extension -> Copy as cURL (bash)
58
58
59
59
```
60
-
vsd capture [OPTIONS] <URL>
60
+
vsd capture [OPTIONS] <INPUT>
61
61
```
62
62
63
63
**Arguments:**
64
64
65
-
-`<URL>`: http(s):// *(required)*
65
+
-`<INPUT>`: HTTP(S):// *(required)*
66
66
67
67
**Options:**
68
68
69
69
| Flag | Description |
70
70
|------|-------------|
71
-
|`--cookies`| Launch browser with cookies loaded from a netscape cookie file |
72
-
|`--extensions`| List of file extensions to be filter out seperated by comma<br>*Default:*`.m3u,.m3u8,.mpd,.vtt,.ttml,.srt`|
73
-
|`--headless`| Launch browser without a window |
71
+
|`--cookies`| Launch browser with cookies (netscape cookie file)|
72
+
|`--extensions`| List of file extensions to be filtered out separated by comma<br>*Default:*`.m3u,.m3u8,.mpd,.vtt,.ttml,.srt`|
73
+
|`--headless`| Launch browser in headless mode (without a window)|
74
74
|`--proxy`| Launch browser with a proxy |
75
-
|`--resource-types`| List of resource types to be filter out seperated by commas<br>*Possible values:*`document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `prefetch`, `eventsource`, `websocket`, `manifest`, `signedexchange`, `ping`, `cspviolationreport`, `preflight`, `fedcm`, `other`<br>*Default:*`fetch,xhr`|
76
-
|`--save-cookies`| Save browser cookies in cookies.txt netscape cookie file |
75
+
|`--resource-types`| List of resource types to be filtered out separated by comma<br>*Possible values:*`document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `prefetch`, `eventsource`, `websocket`, `manifest`, `signedexchange`, `ping`, `cspviolationreport`, `preflight`, `fedcm`, `other`<br>*Default:*`fetch,xhr`|
76
+
|`--save-cookies`| Save browser cookies in cookies.txt (netscape cookie file)|
77
77
78
78
[↑ Back to top](#command-overview)
79
79
80
80
### `vsd extract`
81
81
82
-
Extract subtitles from fragmented MP4 files
82
+
Extract subtitles from a fragmented MP4 file
83
83
84
84
```
85
85
vsd extract [OPTIONS] <INPUT>
86
86
```
87
87
88
88
**Arguments:**
89
89
90
-
-`<INPUT>`: Path to an MP4 file containing WVTT (WebVTT) or STPP (TTML) subtitle boxes.
91
-
92
-
For fragmented MP4 files split across multiple segments, use the `merge` sub-command first to combine them into a single file. *(required)*
90
+
-`<INPUT>`: Path to an MP4 file containing WVTT (WebVTT) or STPP (TTML) subtitle boxes. For fragmented MP4 files split across multiple segments, use the `merge` sub-command first to combine them into a single file *(required)*
|`-o, --output`| Destination file path for extracted subtitles.<br><br>If provided, the codec is inferred from the file extension (`.srt` or `.vtt`). If omitted, subtitles are printed to stdout. |
97
+
|`-o, --output`| Destination file path for extracted subtitles.<br><br>If `provided`, the codec is inferred from the file extension (`.srt` or `.vtt`). If `omitted`, subtitles are printed to stdout. |
100
98
101
99
[↑ Back to top](#command-overview)
102
100
@@ -116,7 +114,7 @@ vsd license [OPTIONS] <INPUT>
116
114
117
115
| Flag | Description |
118
116
|------|-------------|
119
-
|`-H, --header`|Extra headers for license request in same format as curl.<br><br>This option can be used multiple times. |
117
+
|`-H, --header`|Additional headers for license request in same format as curl.<br><br>This option can be used multiple times. |
120
118
121
119
**Playready Options:**
122
120
@@ -161,59 +159,59 @@ At least two files must match the provided patterns. *(required)*
|`--base-url`| Base url to be used for building absolute url to segment. This flag is usually needed for local input files. By default redirected playlist url is used |
179
-
|`-d, --directory`|Change directory path for temporarily downloaded files. By default current working directory is used|
180
-
|`-o, --output`| Mux all downloaded streams to a video container (.mp4, .mkv, etc.) using ffmpeg. Note that existing files will be overwritten and downloaded streams will be deleted|
181
-
|`--parse`|Parse playlist and returns it in json format. Note that --output flag is ignored when this flag is used|
182
-
|`--subs-codec`|Force some specific subtitle codec when muxing through ffmpeg. By default `mov_text`is used for .mp4 and`copy` for others<br>*Default:*`copy`|
176
+
|`--base-url`| Base URL for resolving relative segment paths.<br><br>Required for local playlist files. For remote playlists, the final redirected URL is used by default.|
177
+
|`-d, --directory`|Working directory for temporary segment files.<br><br>Defaults to the current directory.|
178
+
|`-o, --output`| Mux downloaded streams into a video container using ffmpeg (`.mp4`, `.mkv`, etc.).<br><br>Overwrites existing files and deletes intermediate stream files after muxing.|
179
+
|`--parse`|Output parsed playlist metadata as JSON instead of downloading|
180
+
|`--subs-codec`|Subtitle codec to use when muxing with ffmpeg.<br><br>Defaults to `mov_text` for `.mp4` containers,`copy` for others.|
183
181
184
182
**Automation Options:**
185
183
186
184
| Flag | Description |
187
185
|------|-------------|
188
-
|`-i, --interactive`|Prompt for custom streams selection with modern style input prompts. By default proceed with defaults|
189
-
|`-I, --interactive-raw`|Prompt for custom streams selection with raw style input prompts. By default proceed with defaults|
190
-
|`-l, --list-streams`|List all the streams present inside the playlist|
191
-
|`-s, --select-streams`|Filters to be applied for automatic stream selection.<br><br>SYNTAX:`v={}:a={}:s={}` where `{}` (in priority order) can contain<br>\|> all: select all streams.<br>\|> skip: skip all streams or select inverter.<br>\|> 1,2: indices obtained by --list-streams flag.<br>\|> 1080p,1280x720: stream resolution.<br>\|> en,fr: stream language.<br><br>EXAMPLES:<br>\|> v=skip:a=skip:s=all (download all sub streams)<br>\|> a:en:s=en (prefer en lang)<br>\|> v=1080p:a=all:s=skip (1080p with all audio streams)<br><br>*Default:*`v=best:s=en`|
186
+
|`-i, --interactive`|Enable interactive stream selection with styled prompts |
187
+
|`-I, --interactive-raw`|Enable interactive stream selection with plain text prompts |
188
+
|`-l, --list-streams`|Display all available streams without downloading|
189
+
|`-s, --select-streams`|Stream selection filters for automatic mode.<br><br>SYNTAX:<br><br>`v={}:a={}:s={}` where `{}` (in priority order) can contain<br><br>\|> all: select all streams.<br>\|> skip: skip all streams or select inverter.<br>\|> 1,2: indices obtained by --list-streams flag.<br>\|> 1080p,1280x720: stream resolution.<br>\|> en,fr: stream language.<br><br>EXAMPLES:<br><br>\|> 1,2,3 (indices 1, 2, and 3)<br>\|> v=skip:a=skip:s=all (all sub streams)<br>\|> a:en:s=en (prefer en lang)<br>\|> v=1080p:a=all:s=skip (1080p with all aud streams)<br><br>*Default:*`v=best:s=en`|
192
190
193
191
**Client Options:**
194
192
195
193
| Flag | Description |
196
194
|------|-------------|
197
-
|`--cookies`|Fill request client with some existing cookies value. It should be a path to a file containing cookies in netscape format|
198
-
|`-H, --header`|Extra headers for requests in same format as curl.<br><br>This option can be used multiple times. |
199
-
|`--no-certificate-checks`|Skip checking and validation of site certificates|
200
-
|`--proxy`|Set http(s) / socks proxy address for requests|
201
-
|`--query`|Set query parameters for requests |
195
+
|`--cookies`|Path to a netscape cookie file for authenticated requests|
196
+
|`-H, --header`|Additional headers for requests in same format as curl.<br><br>This option can be used multiple times. |
0 commit comments