getraw 0.1.0 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/release.yml +43 -0
- package/CLAUDE.md +1 -1
- package/README.md +15 -15
- package/RESEARCH.md +109 -109
- package/STATUS.md +1 -1
- package/docs/plugin-guide.md +1 -1
- package/docs/supported-sites.md +1 -1
- package/package.json +4 -4
- package/src/cli/index.ts +1 -1
- package/src/cli/options.ts +2 -2
- package/src/core/types.ts +1 -1
- package/src/downloaders/dash.ts +1 -1
- package/src/downloaders/fragment.ts +1 -1
- package/src/downloaders/hls.ts +1 -1
- package/src/downloaders/http.ts +1 -1
- package/src/extractors/niconico/index.ts +1 -1
- package/src/extractors/reddit/gallery.ts +1 -1
- package/src/extractors/reddit/index.ts +3 -3
- package/src/extractors/twitter/index.ts +1 -1
- package/src/networking/cookies.ts +1 -1
- package/src/networking/tls.ts +1 -1
- package/tests/unit/extractors/misc.test.ts +1 -1
- package/tools/dashboard.ts +1 -1
- package/video/.hyperframes/expanded-prompt.md +173 -0
- package/video/design.md +82 -0
- package/video/index.html +684 -0
- package/video/renders/video_2026-06-16_23-50-45.meta.json +1 -0
- package/video/renders/video_2026-06-16_23-50-45.mp4 +0 -0
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
name: Release
|
|
2
|
+
on:
|
|
3
|
+
push:
|
|
4
|
+
tags: ["v*"]
|
|
5
|
+
|
|
6
|
+
permissions:
|
|
7
|
+
contents: write
|
|
8
|
+
id-token: write
|
|
9
|
+
|
|
10
|
+
jobs:
|
|
11
|
+
release:
|
|
12
|
+
runs-on: ubuntu-latest
|
|
13
|
+
environment: release
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v4
|
|
16
|
+
|
|
17
|
+
- uses: oven-sh/setup-bun@v2
|
|
18
|
+
with:
|
|
19
|
+
bun-version: latest
|
|
20
|
+
|
|
21
|
+
- run: sudo apt-get update && sudo apt-get install -y ffmpeg
|
|
22
|
+
|
|
23
|
+
- run: bun install
|
|
24
|
+
|
|
25
|
+
- run: bun test
|
|
26
|
+
|
|
27
|
+
- uses: actions/setup-node@v4
|
|
28
|
+
with:
|
|
29
|
+
node-version: "22"
|
|
30
|
+
registry-url: "https://registry.npmjs.org"
|
|
31
|
+
|
|
32
|
+
- name: Publish to npm
|
|
33
|
+
run: npm publish --access public
|
|
34
|
+
env:
|
|
35
|
+
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
|
36
|
+
|
|
37
|
+
- name: Create GitHub Release
|
|
38
|
+
run: |
|
|
39
|
+
gh release create ${{ github.ref_name }} \
|
|
40
|
+
--title "${{ github.ref_name }}" \
|
|
41
|
+
--generate-notes
|
|
42
|
+
env:
|
|
43
|
+
GH_TOKEN: ${{ github.token }}
|
package/CLAUDE.md
CHANGED
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# getraw
|
|
2
2
|
|
|
3
3
|
Fast media downloader CLI built natively in Bun/TypeScript.
|
|
4
4
|
|
|
@@ -7,14 +7,14 @@ Fast media downloader CLI built natively in Bun/TypeScript.
|
|
|
7
7
|
### Global install (Bun required)
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
bun install -g
|
|
10
|
+
bun install -g getraw
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
### From source
|
|
14
14
|
|
|
15
15
|
```sh
|
|
16
|
-
git clone https://github.com/web3mikee/
|
|
17
|
-
cd
|
|
16
|
+
git clone https://github.com/web3mikee/getraw
|
|
17
|
+
cd getraw
|
|
18
18
|
bun install
|
|
19
19
|
```
|
|
20
20
|
|
|
@@ -28,7 +28,7 @@ Build a standalone binary:
|
|
|
28
28
|
|
|
29
29
|
```sh
|
|
30
30
|
bun run build
|
|
31
|
-
./
|
|
31
|
+
./getraw <URL>
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
## Quick Start
|
|
@@ -36,37 +36,37 @@ bun run build
|
|
|
36
36
|
Download a video at best quality:
|
|
37
37
|
|
|
38
38
|
```sh
|
|
39
|
-
|
|
39
|
+
getraw https://www.youtube.com/watch?v=dQw4w9WgXcQ
|
|
40
40
|
```
|
|
41
41
|
|
|
42
42
|
Extract audio as MP3:
|
|
43
43
|
|
|
44
44
|
```sh
|
|
45
|
-
|
|
45
|
+
getraw -x --audio-format mp3 https://soundcloud.com/artist/track
|
|
46
46
|
```
|
|
47
47
|
|
|
48
48
|
List all available formats before downloading:
|
|
49
49
|
|
|
50
50
|
```sh
|
|
51
|
-
|
|
51
|
+
getraw -F https://vimeo.com/123456789
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
Download a specific format and write subtitles:
|
|
55
55
|
|
|
56
56
|
```sh
|
|
57
|
-
|
|
57
|
+
getraw -f "bestvideo[height<=1080]+bestaudio" --write-subs --sub-langs en https://www.youtube.com/watch?v=dQw4w9WgXcQ
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
Dump extracted metadata as JSON without downloading:
|
|
61
61
|
|
|
62
62
|
```sh
|
|
63
|
-
|
|
63
|
+
getraw -j https://www.reddit.com/r/videos/comments/abc123/some_post/
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
## CLI Reference
|
|
67
67
|
|
|
68
68
|
```
|
|
69
|
-
Usage:
|
|
69
|
+
Usage: getraw [OPTIONS] URL [URL...]
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
| Flag | Short | Type | Default | Description |
|
|
@@ -87,7 +87,7 @@ Usage: dlpx [OPTIONS] URL [URL...]
|
|
|
87
87
|
| `--rate-limit` | `-r` | number | none | Rate limit in bytes/sec |
|
|
88
88
|
| `--proxy` | | string | none | Proxy URL |
|
|
89
89
|
| `--cookies` | | string | none | Cookie file path |
|
|
90
|
-
| `--user-agent` | | string | `
|
|
90
|
+
| `--user-agent` | | string | `getraw/0.0.0` | Custom User-Agent |
|
|
91
91
|
| `--referer` | | string | none | Custom Referer header |
|
|
92
92
|
| `--embed-thumbnail` | | boolean | false | Embed thumbnail in output file |
|
|
93
93
|
| `--embed-subs` | | boolean | false | Embed subtitles in output file |
|
|
@@ -145,10 +145,10 @@ See [docs/supported-sites.md](docs/supported-sites.md) for full format and URL p
|
|
|
145
145
|
Requires [Bun](https://bun.sh) v1.0 or later.
|
|
146
146
|
|
|
147
147
|
```sh
|
|
148
|
-
git clone https://github.com/web3mikee/
|
|
149
|
-
cd
|
|
148
|
+
git clone https://github.com/web3mikee/getraw
|
|
149
|
+
cd getraw
|
|
150
150
|
bun install
|
|
151
|
-
bun run build # produces ./
|
|
151
|
+
bun run build # produces ./getraw binary
|
|
152
152
|
```
|
|
153
153
|
|
|
154
154
|
Run tests:
|