Files
CloakBrowser/CHANGELOG.md
T
CloakHQ 650ba36549 fix: sync wrapper with v11-v13 binary changes
- Rename --timezone to --fingerprint-timezone (breaking binary change in v13)
- Remove --fingerprint-taskbar-height from defaults (binary auto-applies per platform)
- Update viewport height 955→947 (48px Win taskbar default)
- Update patch count 26→25 (patch 003 deleted in v11)
- Document new flags: --fingerprint-fonts-dir, --enable-blink-features=FakeShadowRoot, --fingerprint-taskbar-height (optional override)
- Fix README: remove incorrect "defaults to windows" claim
2026-03-02 22:36:16 +01:00

5.3 KiB
Raw Blame History

Changelog

All notable changes to CloakBrowser — wrapper and binary — are documented here.

Changes are tagged: [wrapper] for Python/JS wrapper, [binary] for Chromium patches.


[0.3.0] — Unreleased

Chromium v145 upgrade. 25 fingerprint patches (up from 16). New download verification and fallback system. Pending: macOS v145 binary builds.

Breaking

  • [wrapper] Python dependency changed from playwright to patchright (CDP stealth fork). Patchright is API-compatible, but if you import playwright directly elsewhere, add it as a separate dependency. Replace from playwright.sync_api with from patchright.sync_api (or keep using cloakbrowser.launch() which handles this automatically).
  • [wrapper] launch_context() / launchContext() now defaults viewport to 1920×947 (realistic maximized Chrome on 1080p Windows with 48px taskbar) instead of Playwright's default 1280×720. Pass viewport={"width": 1280, "height": 720} explicitly to restore old behavior.

2026-03-02

  • [binary] Full stealth audit — multiple detection vectors eliminated, improved cross-API consistency
  • [binary] Platform-aware fingerprint defaults: screen dimensions, taskbar, and layout auto-adjust per spoofed platform
  • [binary] Stability and performance improvements across fingerprint patches
  • [binary] New optional flags: --fingerprint-fonts-dir, --fingerprint-taskbar-height
  • [wrapper] Sync wrapper with latest binary changes: updated flag names, viewport, and defaults

2026-03-01

  • [wrapper] Upgrade wrapper to Chromium v145.0.7632.109
  • [wrapper] Add GitHub Releases fallback when primary download mirror is unavailable
  • [wrapper] Add SHA-256 checksum verification for binary downloads
  • [wrapper] Wire timezone and locale params to Chromium binary flags
  • [wrapper] Add device memory to default stealth args
  • [wrapper] JS: add colorScheme support, guard download fallback against partial failures

2026-02-28

  • [binary] Enforce strict flag discipline — patches only activate when explicitly configured via command-line flags
  • [binary] Improved fingerprint consistency across multiple browser APIs
  • [binary] 3 new fingerprint patches + bug fixes in existing patches
  • [binary] New command-line flag for device memory spoofing
  • [infra] Automated test matrix: 8 groups, 41+ tests across core stealth, fingerprint noise, bot detection, reCAPTCHA, TLS, Turnstile, residential proxy, and enterprise reCAPTCHA
  • [infra] Docker-based test runner with subprocess isolation per test group

2026-02-25

  • [binary] Reduced automation markers visible to detection scripts
  • [binary] Added browser API support at build time
  • [binary] Improved screen property consistency

2026-02-24

  • [binary] Comprehensive fingerprint audit and hardening pass
  • [binary] Fixed font rendering edge case on cross-platform spoofing
  • [binary] 4 new fingerprint patches

2026-02-22

  • [binary] Start Chromium v145 build (v145.0.7632.109)
  • [binary] 24 fingerprint patches ported and adapted

[0.2.2] — 2026-03-01

2026-03-01

  • [wrapper] Fix: replace page.wait_for_timeout() with time.sleep() to avoid timing leak
  • [wrapper] Add auto-detect timezone and locale from proxy IP via GeoIP lookup
  • [binary] CDP detection vector audit and hardening

[0.2.0] — 2026-02-27

macOS platform release. JavaScript/TypeScript wrapper. Self-hosted binary mirror.

2026-02-27

  • [wrapper] Add macOS support: Apple Silicon (arm64) and Intel (x64) binary downloads
  • [wrapper] Add GPG-signed release workflow via GitHub Actions
  • [wrapper] Fix macOS binary download: preserve .app symlinks, remove quarantine xattrs
  • [wrapper] Add real bot detection assertions to stealth tests
  • [wrapper] Bump version to 0.2.0

2026-02-26

  • [wrapper] Switch binary downloads to self-hosted mirror (cloakbrowser.dev) as GitHub backup
  • [wrapper] Set up GitLab mirror at gitlab.com/CloakHQ/cloakbrowser

2026-02-25

  • [wrapper] Move binary releases from separate repo to wrapper repo
  • [wrapper] Add auto-update check on launch
  • [infra] Initial Docker test infrastructure + matrix test runner

2026-02-24

  • [wrapper] Add JavaScript/TypeScript wrapper with Playwright + Puppeteer support (npm install cloakbrowser)
  • [wrapper] Fix proxy authentication credentials support in URL (closes #4)

[0.1.4] — 2026-02-23

2026-02-23

  • [wrapper] Stealth hardening: additional launch args and detection evasion improvements
  • [wrapper] Full test suite rewrite with real detection site assertions
  • [wrapper] Add Docker support with Dockerfile and compose config
  • [wrapper] Add headed mode documentation

[0.1.0] — 2026-02-22

Initial release. Chromium v142 with 16 fingerprint patches.

2026-02-22

  • [binary] Chromium v142.0.7444.175 with 16 source-level fingerprint patches
  • [binary] Fix browser brand string to match Chrome 142 format
  • [wrapper] launch() and launch_async() — drop-in Playwright replacements
  • [wrapper] Auto-download binary from GitHub Releases, cached in ~/.cloakbrowser/
  • [wrapper] Linux x64 platform support
  • [wrapper] Passes 14/14 bot detection tests
  • [wrapper] reCAPTCHA v3: 0.9 (server-verified), Cloudflare Turnstile: pass