Skip to content

The headless browser for AI agents and web scraping

fix(install): correct Scoop manifest and Windows instructions

SGavrl8b1841adf5cf
diff --git a/README.md b/README.md
index c448e057..3302efca 100644
--- a/README.md
+++ b/README.md
@@ -132,14 +132,28 @@ tar xzf obscura-aarch64-macos.tar.gz
# macOS Intel
curl -LO https://github.com/h4ckf0r0day/obscura/releases/latest/download/obscura-x86_64-macos.tar.gz
tar xzf obscura-x86_64-macos.tar.gz
+```
+
+### Windows
+
+x86_64 Windows only (no 32-bit build).
-# Windows
-Download the `.zip` from the releases page and extract it manually.
+Download `obscura-x86_64-windows.zip` from
+[Releases](https://github.com/h4ckf0r0day/obscura/releases),
+extract it, and add the folder to your PATH. No C++ build tools are required.
+
+Alternatively, with [Scoop](https://scoop.sh/) installed:
+
+```powershell
+# Direct manifest install (available once this change merges to main):
+scoop install https://raw.githubusercontent.com/h4ckf0r0day/obscura/main/scoop/obscura.json
```
No Chrome, no Node.js, no dependencies. Release archives include both
-`obscura` and `obscura-worker`; keep them in the same directory for the
-parallel `scrape` command.
+`obscura` and `obscura-worker`: manual zip installs should keep both in
+the same directory for the parallel `scrape` command; scoop handles
+placement automatically (both binaries land in the app dir with shims
+on PATH).
| Archive suffix | Rendering | Stealth transport |
|----------------|-----------|-------------------|
@@ -148,6 +162,9 @@ parallel `scrape` command.
| `-no-render` | No | No |
| `-no-render-stealth` | No | Yes |
+The scoop install pulls the default variant (rendering, no stealth). For
+stealth on Windows, download the `-stealth` archive manually.
+
Linux release builds target Ubuntu 22.04 so the downloaded binary remains
usable on common LTS servers with glibc 2.35+.
diff --git a/scoop/obscura.json b/scoop/obscura.json
new file mode 100644
index 00000000..c397ada9
--- /dev/null
+++ b/scoop/obscura.json
@@ -0,0 +1,26 @@
+{
+ "$schema": "https://raw.githubusercontent.com/ScoopInstaller/Scoop/master/schema.json",
+ "version": "0.2.2",
+ "description": "Headless browser engine with a real DOM, CDP, and zero dependencies",
+ "homepage": "https://github.com/h4ckf0r0day/obscura",
+ "license": "Apache-2.0",
+ "notes": "Default variant (rendering, no stealth); both binaries are installed with shims on PATH.",
+ "bin": [
+ "obscura.exe",
+ "obscura-worker.exe"
+ ],
+ "architecture": {
+ "64bit": {
+ "url": "https://github.com/h4ckf0r0day/obscura/releases/download/v0.2.2/obscura-x86_64-windows.zip",
+ "hash": "db5a3c951f7172eb8f25e6d71bd7120c7128f70f6daed55a6cc4caaabe1674d6"
+ }
+ },
+ "checkver": "github",
+ "autoupdate": {
+ "architecture": {
+ "64bit": {
+ "url": "https://github.com/h4ckf0r0day/obscura/releases/download/v$version/obscura-x86_64-windows.zip"
+ }
+ }
+ }
+}
diff --git a/scripts/ci/test_scoop_manifest.py b/scripts/ci/test_scoop_manifest.py
new file mode 100644
index 00000000..c9b32e6b
--- /dev/null
+++ b/scripts/ci/test_scoop_manifest.py
@@ -0,0 +1,40 @@
+import json
+from pathlib import Path
+import unittest
+
+
+class ScoopManifest(unittest.TestCase):
+ def setUp(self):
+ path = Path(__file__).resolve().parents[2] / "scoop" / "obscura.json"
+ self.manifest = json.loads(path.read_text(encoding="utf-8"))
+
+ def release_url(self, version):
+ return ("https://github.com/h4ckf0r0day/obscura/releases/download/"
+ f"v{version}/obscura-x86_64-windows.zip")
+
+ def test_install_uses_a_literal_versioned_url_and_sha256(self):
+ download = self.manifest["architecture"]["64bit"]
+ self.assertEqual(download["url"], self.release_url(self.manifest["version"]))
+ self.assertRegex(download["hash"], r"\A[0-9a-f]{64}\Z")
+
+ def test_no_download_fallback_for_unsupported_architectures(self):
+ self.assertEqual(set(self.manifest["architecture"]), {"64bit"})
+ self.assertNotIn("url", self.manifest)
+ self.assertNotIn("hash", self.manifest)
+
+ def test_autoupdate_expands_scoop_version_for_the_same_asset(self):
+ update = self.manifest["autoupdate"]
+ downloads = update.get("architecture", {})
+ self.assertEqual(set(downloads), {"64bit"})
+ self.assertNotIn("url", update)
+ for version in (self.manifest["version"], "10.20.30"):
+ with self.subTest(version=version):
+ url = downloads["64bit"]["url"].replace("$version", version)
+ self.assertEqual(url, self.release_url(version))
+
+ def test_cli_and_worker_both_have_path_shims(self):
+ self.assertEqual(self.manifest["bin"], ["obscura.exe", "obscura-worker.exe"])
+
+
+if __name__ == "__main__":
+ unittest.main()