Skip to content

Commit cce7ba9

Browse files
committed
docs(readme): add prebuilt HackBrowserData variant download instructions
Document downloading and running the hbd-<os>-<arch> release assets (gh release download + run), with a per-platform pattern table and provenance verification, alongside the existing -tags hbd build-from-source note.
1 parent bf39cb0 commit cce7ba9

1 file changed

Lines changed: 25 additions & 1 deletion

File tree

README.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,31 @@ gh extension install .
6060

6161
Requires Go 1.26+.
6262

63-
The cookie backend defaults to [`kooky`](https://github.com/browserutils/kooky); `go build -tags hbd` uses [`hackbrowserdata`](https://github.com/moonD4rk/HackBrowserData) instead, also shipped as `hbd-<os>-<arch>` release assets. The `hbd` build pins a hackbrowserdata commit carrying the macOS securityd-dump gate and library log silencing until its next release; override either dep with `go get <module>@<ref>` or a `go.mod` `replace`.
63+
The cookie backend defaults to [`kooky`](https://github.com/browserutils/kooky); `go build -tags hbd` uses [`hackbrowserdata`](https://github.com/moonD4rk/HackBrowserData) instead. The `hbd` build pins a hackbrowserdata commit carrying the macOS securityd-dump gate and library log silencing until its next release; override either dep with `go get <module>@<ref>` or a `go.mod` `replace`.
64+
65+
</details>
66+
67+
<details>
68+
<summary>HackBrowserData cookie backend (prebuilt)</summary>
69+
70+
An alternate build swaps the browser-cookie reader from `kooky` to [`hackbrowserdata`](https://github.com/moonD4rk/HackBrowserData) for broader browser coverage (Arc, Vivaldi, Firefox WAL, …). It ships as separate `hbd-<os>-<arch>` release assets — `gh extension install` still gets the default `kooky` build. Download one and run it directly:
71+
72+
```bash
73+
gh release download <tag> --repo drogers0/gh-image \
74+
--pattern hbd-darwin-arm64 --output gh-image --clobber # pick your platform
75+
chmod +x gh-image
76+
./gh-image screenshot.png
77+
```
78+
79+
| Platform | `--pattern` |
80+
| --- | --- |
81+
| macOS Apple Silicon | `hbd-darwin-arm64` |
82+
| macOS Intel | `hbd-darwin-amd64` |
83+
| Linux x86-64 | `hbd-linux-amd64` |
84+
| Linux arm64 | `hbd-linux-arm64` |
85+
| Windows x64 | `hbd-windows-amd64.exe` |
86+
87+
Pre-releases need the explicit tag (`gh` won't treat them as latest). Verify provenance with `gh attestation verify gh-image --owner drogers0`, or build it yourself with `-tags hbd` (see *Build from source*).
6488

6589
</details>
6690

0 commit comments

Comments
 (0)