Skip to content

Releases

Persona Studio v0.2.2

Choose a tag to compare

@github-actions github-actions released this 25 Oct 21:21

Download

Windows: PersonaStudio-0.2.2-windows-x64.zip below. Unzip it anywhere and
run PersonaStudio.exe. It starts the engine and the dashboard together and opens
http://localhost:8787. The first start downloads Chromium (about 170 MB).
Bundled engines: Playwright, Patchright, CloakBrowser (Camoufox needs a source
install). Check the download against SHA256SUMS.txt.

From source: see the Quick start.

What's new in 0.2.2

Added

  • Engine downloads you can see. The first launch of a profile on an engine
    that still needs its browser (CloakBrowser: about 560 MB) now opens a
    One-time setup popup first: Download & open, Download only or
    Cancel. The download then shows a progress window with the percentage,
    MB done, speed and time left. Run in background shrinks it to a small
    progress card in the corner, and a notification says when it's ready (and
    the profile opens by itself) or if it failed, with Try again.
  • Settings → Default launch engine lists engines that still need their
    download, with Download now (or Show progress while it runs).
  • persona engine status and persona engine install <cloak|playwright|patchright>
    download with live progress; GET /api/engines/status and
    POST /api/engines/{name}/install do it from the API. A profile can't launch
    on an engine while its download is still running.

Fixed

  • The sidebar showed version 0.1.0 whatever the real version was.
  • A profile created with only a few fields (API, imports) got Chrome 128 and an
    empty User-Agent; it now gets a current Chrome and a matching User-Agent.

Full history: CHANGELOG.md

Persona Studio v0.2.1

Choose a tag to compare

@github-actions github-actions released this 25 Oct 21:07

Download

Windows: PersonaStudio-0.2.1-windows-x64.zip below. Unzip it anywhere and
run PersonaStudio.exe. It starts the engine and the dashboard together and opens
http://localhost:8787. The first start downloads Chromium (about 170 MB).
Bundled engines: Playwright, Patchright, CloakBrowser (Camoufox needs a source
install). Check the download against SHA256SUMS.txt.

From source: see the Quick start.

What's new in 0.2.1

Fixed

  • First launch on CloakBrowser looked dead. The first cloak launch
    silently downloads CloakBrowser's browser (about 560 MB), so nothing opened
    for minutes, the launch log stayed empty (the app's child processes buffered
    their output), and the 5-minute start watchdog could stop a download that was
    still going. Now the app downloads CloakBrowser on its first start, in its
    window, with progress and up to 3 retries; launch logs are written as they
    happen and show engine download progress; and the watchdog only stops a launch
    that has made no progress for 5 minutes.
  • CloakBrowser showed one language. Playwright's locale emulation cut
    navigator.languages down to the locale alone (es-ES, with no es/en
    fallbacks a real browser has). Cloak now gets Chrome's own --lang and
    --accept-lang, so navigator.languages, Intl and the Accept-Language
    header (es-ES,es;q=0.9,en;q=0.8) all match the profile.

Full history: CHANGELOG.md

Persona Studio v0.2.0

Choose a tag to compare

@github-actions github-actions released this 25 Oct 20:38

Download

Windows: PersonaStudio-0.2.0-windows-x64.zip below. Unzip it anywhere and
run PersonaStudio.exe. It starts the engine and the dashboard together and opens
http://localhost:8787. The first start downloads Chromium (about 170 MB).
Bundled engines: Playwright, Patchright, CloakBrowser (Camoufox needs a source
install). Check the download against SHA256SUMS.txt.

From source: see the Quick start.

What's new in 0.2.0

Added

  • Windows app (packaging/PersonaStudio.spec, persona/app.py): one
    PersonaStudio.exe that runs the engine and serves the built dashboard on
    http://localhost:8787, with no Python or Node needed. It downloads Chromium on
    first run and bundles Playwright, Patchright and CloakBrowser. With arguments
    it acts as the persona CLI. persona serve --dashboard dashboard/dist does
    the same from source. Version is now 0.2.0.

Fixed

  • A profile created through the API or an import without tags blanked the
    whole dashboard. The server now fills in missing fields, and the list
    tolerates old records.

Security

  • Local API locked down. persona serve used to accept CORS from any origin
    without auth, so any web page open in the user's browser could launch profiles
    or read their cookies through localhost:8787. It now requires a per-start
    X-Persona-Token (written to <data-dir>/api-token, given via /api/token
    only to the dashboard's origins). CORS is restricted to the dashboard, and
    non-loopback Host headers are rejected to block DNS rebinding.
    /api/health stays open. The dashboard picks up the token automatically.

  • DNS lockdown at launch. With a proxy, Chromium engines now start with
    --host-resolver-rules="MAP * ~NOTFOUND, EXCLUDE <proxy host>, EXCLUDE localhost",
    so prefetching, WebRTC STUN names and the like can't ask the real ISP's
    resolver. Before, DNS leaks were only detected (persona dns), never prevented.

Fixed

  • GPU strings no real Chrome reports. The dashboard's GPU picker used short
    labels (ANGLE (NVIDIA GeForce RTX 3060 Direct3D11)) and sent them to the
    browser as-is, while real Chrome reports ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 Direct3D11 vs_5_0 ps_5_0, D3D11). The picker now offers the exact
    strings, and profiles saved with an old label are upgraded on launch. Picking
    a GPU or switching OS also updates the WebGL vendor to match.
  • macOS GPUs are Metal now. Chrome on macOS renders WebGL through ANGLE's
    Metal backend, so it reports ANGLE (Apple, ANGLE Metal Renderer: Apple M1, Unspecified Version). New macOS profiles use those strings, old OpenGL 4.1
    ones are upgraded, and the coherence check accepts Metal on macOS only.
  • Dashboard: new and bulk-created profiles start on Chrome 148–151 like the
    engine, instead of 125–128.
  • Same device on every launch (Camoufox). Camoufox salted each launch
    randomly, so a profile came up as a new device every session (a different
    screen each time in testing). Each profile's Camoufox fingerprint is now
    generated once and pinned in its user-data dir
    (.persona-camoufox-fingerprint.json). Backup/restore carries the pin along,
    and "duplicate as template" gets a fresh one. Canvas still varies per session
    there, because Firefox's own baseline fingerprinting protection does that for
    every real Firefox user.
  • CloakBrowser presents Persona's fingerprint. Hardware cores, RAM, screen,
    GPU vendor/renderer and platform are now passed as --fingerprint-* flags, and
    the seed comes from the profile (a profile Cloak already opened keeps its
    existing seed). The UA is no longer forced, so UA and Client Hints both come
    from the binary and agree. Before, Cloak showed Chrome/128 in the UA but 146
    in sec-ch-ua.
  • navigator.deviceMemory was impossible. Profiles reported raw RAM (16, 32,
    6, 12); Chrome only ever reports a power of two capped at 8. Fixed in the
    stealth script, Cloak flags, the trust check and auto-adjust.
  • Chrome version follows the engine. At launch, a profile's UA moves to the
    engine's real Chromium major (Playwright 151, Cloak 146 today) and the
    dashboard copy follows. A UA older than the engine is caught by feature
    detection. Default versions for new profiles moved from 125–128 to 148–151.
  • navigator.userAgentData on Playwright/Patchright reported
    HeadlessChrome/Chromium with no "Google Chrome", which contradicted the UA
    and sec-ch-ua. Now set through CDP Emulation.setUserAgentOverride with full
    metadata (brands, full version, platform version, architecture, model), so JS
    and every Client Hints header agree.
  • Dashboard: api.health was defined twice, so the startup liveness probe was
    actually calling /api/profiles/health. The probe is now api.ping().

Added

  • Active session lock (persona/locks.py). A profile can only be open in one
    live process. Opening it twice is the "same account, two devices at once"
    signal, and two browsers writing one user-data dir corrupt it. The lock is a
    file in the profile's user-data dir naming its process, taken atomically by
    every launch path (dashboard, persona launch, attach, warm-up, cookie and
    trust tools). A lock left by a crashed process is detected and taken over.
    The dashboard now shows a profile opened from a terminal as running, and
    refuses to open its session. persona unlock <profile> clears a lock by hand.
  • Profile history (persona/history.py). When a session ends (launch,
    warm-up, automation), the caches the browser rebuilds by itself (HTTP cache,
    code cache, GPU shader caches) are deleted, and the rest of the session is
    saved as a zipped snapshot. The last 5 are kept (history_keep in Settings
    or PUT /api/config, 0 turns it off). An unchanged session isn't saved twice.
    Restore rolls cookies and site data back, and snapshots the current state
    first so a restore can be undone. In the dashboard: editor Session tab →
    Session history. From the CLI: persona history <profile>, with
    --snapshot or --restore <id>. API: GET/POST /api/profiles/{id}/history,
    POST …/history/{snapshot}/restore.
  • Backups leave out those same caches and the browser's lock files, so they're
    much smaller.
  • Per-profile storage toggles (editor Advanced → Keep between
    sessions
    , persona storage <profile> --off history passwords). Local
    storage, IndexedDB, history, saved passwords, open tabs, bookmarks and Web
    Store extensions can each be switched off. Switched-off data is cleared when
    the browser closes (and before the next launch, in case it crashed), so it
    never builds up or lands in snapshots and backups. Works for Chromium engines
    and Camoufox. Cookies are always kept.
  • WebGL capability table (persona/webgl.py). Fingerprinters read the
    whole WebGL table (limits, extensions, shader precision), not just the GPU
    name. The trust check now reads it and verifies two things. First, that the
    limits fit the GPU's graphics API: Chrome's Direct3D 11 backend has a unique
    signature (32767 viewport, 4095 vertex and 1024 fragment uniform vectors,
    measured on Chrome 151), so a profile claiming an Apple GPU on a Windows PC,
    or a Windows GPU on SwiftShader, is caught. Second, that it's the same device
    as before: the first reading is stored with the profile, and a later change
    is flagged. Auto-adjust re-baselines it, validate() and the dashboard's
    coherence meter flag a recorded table that no longer fits the chosen GPU.
    The table is read, never faked: a JS patch can't make the GPU honour limits
    it doesn't have.
  • Headless sessions use the real GPU (--enable-gpu on Playwright and
    Patchright). Headless Chrome otherwise renders WebGL in software
    (SwiftShader), a known headless tell that also contradicts the claimed GPU.
    This affects trust checks, warm-ups and headless automation.
  • Launch-flag denylist, with reasons. Extra launch flags that would change
    the identity behind Persona's back are now ignored too: --user-agent,
    --lang, --window-size (it has to agree with the spoofed screen),
    --force-device-scale-factor, --use-angle/--use-gl (GPU backend),
    --webrtc-ip-handling-policy, --no-sandbox, --headless, and CloakBrowser's
    identity flags (--fingerprint-gpu-renderer and friends; --fingerprint-noise
    stays allowed). Each ignored flag now says why, both in launch warnings and
    live under the field in the editor. A flag must look like a flag
    (--name or --name=value).
  • Languages from the exit IP (opt-in per profile: editor Proxy tab →
    Languages follow the exit IP, or persona edit <profile> --auto-lang on).
    Each launch sets navigator.languages, the locale and the Accept-Language
    header from the proxy's exit country, in the shape real non-English users
    have: de-DE, de, en-US, en. 70 countries are mapped (English where it's the
    usual browser language, e.g. India, Pakistan, Nigeria). The trust check
    expects the launch languages and auto-adjust doesn't write them back. Off by
    default, because moving an existing account to a new language is a signal of
    its own.
  • SOCKS4 proxies work on every engine and in the pool's health check. They
    go through the local bridge, spoken as SOCKS4a so hostnames resolve at the
    proxy (no DNS leak). The dashboard was quietly saving SOCKS4 as HTTP; it's
    now a proxy type of its own.
  • Change-IP URL for rotating and mobile proxies. Save the vendor's
    rotation URL on a proxy, then press Change IP in the editor (or
    persona proxy change-ip <profile>, POST /api/profiles/{id}/proxy/change-ip,
    POST /api/proxies/{id}/change-ip). The next launch re-reads the new exit
    IP's timezone a...
Read more