CloakHQ
67efadef26
feat: auto-detect timezone/locale from proxy IP via geoip
...
Adds geoip=True parameter to launch(), launch_async(), and
launch_context(). Resolves proxy exit IP → MaxMind GeoLite2-City
lookup → timezone + locale. Downloads ~70MB DB on first use from
P3TERX mirror, caches in ~/.cloakbrowser/geoip/.
Optional deps: pip install cloakbrowser[geoip] / npm install mmdb-lib
Explicit timezone/locale always override auto-detected values.
2026-03-01 01:53:50 +01:00
CloakHQ
59b9d71684
docs: add fixed fingerprint seed tip for site revisiting
2026-02-28 04:38:27 +01:00
CloakHQ
f480958ba7
test: add real bot detection assertions to stealth tests
...
Replace hollow page-load checks with actual verdict parsing for 6
detection sites: sannysoft, incolumitas, browserscan, deviceandbrowserinfo,
fingerprintjs, and recaptcha v3. Add proxy support via CLOAKBROWSER_TEST_PROXY
env var. All 12 stealth tests pass.
2026-02-27 09:20:56 +01:00
CloakHQ
8c76a68cb5
fix: macOS binary download — preserve .app symlinks, remove quarantine xattrs
...
macOS downloads were broken: symlinks in Chromium.app Framework layout were
skipped and flatten logic removed the .app bundle structure. Now allows safe
symlinks, skips flattening .app dirs, and runs xattr -cr post-extraction to
prevent Gatekeeper prompts. Also adds Turnstile GIF to README proof section.
2026-02-27 07:32:43 +01:00
CloakHQ
cee166c2d2
docs: add links section, fix download badges, post-download CTAs
...
- Add Links section to both READMEs (website, issues, PyPI, npm, email)
- Replace broken pepy.tech badge with shields.io PyPI + npm download badges
- Post-download messages: website, issues link, star CTA (Python + JS)
- Fix CLOAKBROWSER_DOWNLOAD_URL default in docs (github → cloakbrowser.dev)
- Fix tests: download URL assertions, platform-aware stealth args test
2026-02-27 03:52:53 +01:00
CloakHQ
b07797f963
feat: add macOS platform support, GPG-signed release workflow
...
- Native macOS fingerprint config (platform=macos, skip GPU/concurrency spoofing)
- Enable darwin-arm64 and darwin-x64 in AVAILABLE_PLATFORMS (Python + JS)
- Update release workflow: multi-platform title, patch count, GPG key reference
- Update platform tables in both READMEs: macOS Intel now available
- Fix stealth test timeouts
2026-02-27 02:15:36 +01:00
CloakHQ
31c04d5bcc
docs: add fingerprint management section, document all 10 fingerprint flags
...
- Document default fingerprint config (5 flags set per launch)
- Document additional 5 flags (brand, platform-version, location, timezone)
- Add usage examples for seed pinning, GPU override, timezone
- Update roadmap: fingerprint rotation per session → Released
- Bump Python 0.1.11 → 0.1.12, JS 0.1.9 → 0.1.10
2026-02-26 08:42:36 +01:00
CloakHQ
cc501d8ef6
fix: use mirror for binary downloads, imgur for images while GitHub org is flagged
2026-02-26 06:20:33 +01:00
CloakHQ
8cecebf118
feat: move binary releases to wrapper repo, add auto-update check
...
- Binary downloads now served from CloakHQ/cloakbrowser releases (chromium-v* tags)
- Auto-update: background version check on launch, downloads newer binary for next use
- Graceful error on macOS/Windows (Linux-only binaries for now)
- Rate-limited (1hr), opt-out via CLOAKBROWSER_AUTO_UPDATE=false
- Add release-binary.yml workflow for anonymous binary releases
2026-02-25 19:38:32 +01:00
CloakHQ
179531fd17
docs: add PyPI downloads badge, note Puppeteer reCAPTCHA limitation
2026-02-25 18:32:09 +01:00
CloakHQ
4e809b9678
feat: add JavaScript/TypeScript wrapper with Playwright + Puppeteer support
...
Adds js/ package mirroring the Python wrapper architecture:
- Dual API: import from 'cloakbrowser' (Playwright) or 'cloakbrowser/puppeteer'
- TypeScript with full type definitions
- Same binary download/cache logic, same stealth args, same env vars
- Optional peer deps: users install only the runtime they need
- Full 6-site stealth test suite (sannysoft, incolumitas, BrowserScan, deviceandbrowserinfo, FingerprintJS, reCAPTCHA v3)
- Published to npm as cloakbrowser@0.1.2
2026-02-24 07:33:18 +01:00
CloakHQ
23ae521832
docs: add headed mode guide, JS roadmap, bump to 0.1.5
...
- Add Headed Mode section for DataDome/Cloudflare Turnstile sites
- Add Xvfb setup instructions + residential proxy tip
- Add JavaScript/Puppeteer support to roadmap
2026-02-23 18:13:07 +01:00
CloakHQ
2d7894ad68
docs: add Docker section to README, expand Dockerfile deps, bump to 0.1.3
2026-02-23 07:16:02 +01:00
CloakHQ
efab732142
fix: use absolute image URLs for PyPI, bump to 0.1.2
...
PyPI doesn't render relative image paths — switched to raw GitHub URLs.
Also updated pyproject.toml metadata (author, URLs).
2026-02-23 02:53:36 +01:00
CloakHQ
924f401265
docs: improve README for launch — logo, scannable bullets, roadmap, troubleshooting
...
- Add cloaked Chrome logo as hero banner
- Replace dense blockquote intro with 6 emoji feature bullets
- Move reCAPTCHA proof image above the fold
- Tighten "Why CloakBrowser?" to 3 bullet points
- Add 3 badges (stars, downloads, last commit)
- Add Roadmap section with star CTA
- Add Troubleshooting section (4 common issues)
- Fix version references from 145 to 142
2026-02-22 23:32:02 +01:00
Durafen
6ea8391fac
docs: add reCAPTCHA v3 score 0.9 screenshot to README
2026-02-22 20:19:27 +01:00
CloakHQ
840dc8f88d
feat: cloakbrowser v0.1.0 — stealth Chromium wrapper for Playwright
...
Drop-in Playwright replacement with source-level fingerprint patches.
Auto-downloads patched Chromium 142 from GitHub Releases on first use.
17/17 stealth tests passing (reCAPTCHA 0.9, Cloudflare Turnstile, BrowserScan).
2026-02-22 10:30:25 +01:00
CloakHQ