Repository navigation
Releases
v0.10.0
Built-in pages overhaul with one design system and a first light theme, a command palette, a Settings Performance tab, a bookmarks manager and a new start page, plus crash resilience for renderer and GPU crashes.
Pages and design system
- Every
spatial://page now uses one design system:ui.cssthemed by the current theme, a shared keyboard model, and maud templates that escape all data. - Catppuccin Latte, the first light theme.
- Command palette (
Ctrl+K): open pages, run commands, search bookmarks, history and typed URLs. - Start page (
Ctrl+T): most visited sites, bookmark tiles and recent input. Suggestions work as before. - History, Passwords, Scripts & styles and Downloads now use the new pages. Downloads show live progress. The context menu, find bar, save prompt and workspaces were ported too.
- New Site info and About pages, opened from the palette. From Site info you can forget a site's history (
site://). - To delete items from a list, press
Deletetwice. OSR tiles have no dialogs.
Settings
- New Performance tab:
- frame rate;
- GPU (integrated / discrete);
- page painting (auto / GPU / CPU).
- GPU and painting are saved in
settings.jsonand take effect after a restart.SPATIAL_BROWSER_GPU/SPATIAL_BROWSER_OSRstill take precedence. - Search across all tabs. Custom search engine URL, validated as http(s).
Bookmarks manager (Ctrl+B)
- Folder tree with nested
A/Bfolders, plus search. - Inline rename and move, multi-select delete and move, folder rename.
Crash resilience #16
- When a renderer crashes, only that tile reloads. Retries back off at 1s, 5s and 30s. After 3 crashes in 10 minutes it stops retrying; reload by hand with Ctrl+R.
--disable-gpu-process-crash-limit: repeated GPU-process crashes no longer take down the whole browser.- Lazy restore: a restored tile loads only once it is on screen, topmost first, 150 ms apart. A tile's URL is still saved before it loads.
Security
site://actions are handled like every other page action: they are accepted only from built-in tiles that present their own token.- Site info reads local stores only and never shows passwords.
- The web
password://autofill subset is unchanged.
Logs, docs and CI
- Quieter logs: per-browser, favicon and per-frame shared-texture messages moved to debug/trace. Use
RUST_LOG=debugto see them again. #17 - Pre-release manual checklist added to the wiki. #18
wiki/now syncs to the GitHub Wiki automatically. #19
Linux x86_64 only. See the wiki for configuration and limitations.
Full Changelog: v0.9.0...v0.10.0
v0.9.0
Browser engine update, a security hardening pass across built-in pages and the
password vault, spatial:// built-in pages, idle rendering, find-in-page,
local favicons and a much longer, searchable history.
Engine
- CEF 151.8 → 154.5.0+154.0.34 (cef-rs 154.5). The ReadAnything soft-navigation crash (CEF#4234) is fixed upstream.
Security hardening
- Built-in pages are served from
spatial://page/<kind>/<token>instead ofdata:URLs. The token is issued to that one browser. bookmark://,history://,settings://,password://(vault UI) and the other actions are accepted only from those built-in tiles.- Web pages may send only:
- the
password://autofill subset, from the main frame or the bridge's blank iframe, and bound to the main-frame origin; context://hit, only after a real right-click.
- the
- Autofill works only on HTTPS and on local-network or loopback HTTP.
- SOP/TLS bypass flags removed.
- Page fields are HTML/JS-escaped everywhere (escaping audit). Fixed an XSS through a
data:page. - Clipboard writes from pages need a gesture or Ctrl+C.
wl-copyis fed through stdin. Paste is async. - Popups are gated and opened as real windowless tiles. Risky downloads are quarantined.
- Queued script injections are skipped once the frame has moved to another origin.
- Config dir is private (0700). JSON configs are written atomically with backups, through a symlink-safe background writer. Browsing traces (history, downloads, typed URLs) keep no
.bak.
Password vault v2
- Versioned file header with stored Argon2id parameters (64 MiB, t=3). The header is authenticated as AES-GCM AAD.
- v1 vaults are migrated on unlock.
- Idle auto-lock, zeroized secrets, atomic 0600 writes.
- The save-password prompt is its own compositor tile, outside the page.
- Generated passwords are copied as sensitive data.
Pages, UI and features
- Find in page (Ctrl+F) on CEF's native find. The bar is sized for HiDPI.
- Favicons for bookmarks, history, downloads and the switcher come from a local cache filled on visit. Lists never fetch
favicon.icofrom the listed sites. - History:
- Omnibox (Ctrl+T) suggests from history and typed input. Host-prefix matches rank first. ↑/↓ to choose. #9
- Ctrl+Shift+1..9 moves the focused page to a workspace slot.
- Links can open in the system browser. Launch URLs are forwarded to the running instance.
- The context menu opens only for a real right-click.
Performance
- The app idles when nothing changes (frame pacer). Filter-engine rebuilds run off the render thread.
- The CPU paint texture is reused, and only dirty rects are uploaded.
- Tiles open from a pool of pre-started browsers.
- The first EasyList build finishes before pages are restored.
Code and CI
pending_actionsis split into a module per scheme.vault,navigationandappare split into submodules. Productionunwrap()s are removed. #7- CI runs
cargo fmt --check, clippy-D warningsand tests. GitHub Actions moved to the Node 24 runtime. Tag releases no longer write caches. - More tests: vault, CSV import, scheme parsers, history, suggestions.
- Crate versions now follow the release tag (0.9.0).
Linux x86_64 only. See the wiki for configuration and limitations.
Full Changelog: v0.8.0...v0.9.0
v0.8.0
Passwords CSV import, canvas minimap, bookmarks import, and layout fixes.
Passwords (Ctrl+Shift+P)
- Chrome/Bitwarden CSV import via system file dialog
- Suggest-fill chip on login fields (no silent autofill)
- Tabbed vault UI (Saved / Add·Import / Generator / Never save)
Bookmarks (Ctrl+B)
- In-app Import… for Chromium-style
Bookmarks/AccountBookmarks - Non-blocking file dialog (avoids xdg-portal timeouts)
- Standalone
import-chromeCLI removed
Canvas
- Adaptive minimap when zoomed out (drag viewfinder / click to pan)
- Fix layout drift on restart (no more Resized rescale of world rects)
- Ctrl+Space zoom no longer overwrites saved page geometry
Stability / tooling
- Force software video decode to stop Linux
vaEndPictureVAAPI spam - Machine-local
.cargo/config.toml(example in repo); drop Qt smoke tool
Linux x86_64 only. See the wiki for configuration and limitations.
Full Changelog: v0.7.0...v0.8.0
v0.7.0
Live workspace slots, EasyList-style filtering, and tabbed Settings.
Workspaces
- Numbered live slots (default 3) instead of named snapshots
- Top-edge auto-hide chip HUD;
Ctrl+1…9switch,Ctrl+N/+new slot - Park pages in RAM on switch (no reload); autosave to
workspaces.jsonv2
Content filtering (Ctrl+, → Blocking)
- Tabbed Settings: General / Blocking / Appearance
- EasyList + EasyPrivacy network blocking (Brave
adblock-rust) - Cosmetic hide CSS on document-start
- Optional
##+jsscriptlets (Off by default; classic uBO scriptlets.js) - Peter Lowe hosts + custom hosts still available
- List files under
~/.config/spatial-browser/filters/
Docs
- Wiki updated for slots and filter lists
Linux x86_64 only. See the wiki for configuration and limitations.
Full Changelog: v0.6.0...v0.7.0
Full Changelog: v0.6.0...v0.7.0
v0.6.0
Password vault, context menu, userstyles, and wiki.
Password manager (Ctrl+Shift+P)
- Local encrypted vault (Argon2id + AES-GCM), unlock once per session
- Autofill by origin, multi-account picker, save prompt after login
- Generator, never-save list, optional email field
- Theme-driven chrome; iframe signaling so login pages are not stolen
Context menu (right-click)
- Canvas: new page, save as workspace
- Page: copy URL, reader, generate/fill password, close, new page, save workspace
- Link / image / password-field specific actions
- In-canvas overlay sized for HiDPI (no scrollbars)
Scripts & styles
- Userstyles (
.css) with@match spatial-uifor built-in pages - Userscripts also honor
spatial-ui - Combined list on
Ctrl+Shift+U
Docs
- Short README pointing at the Wiki
Linux x86_64 only. See the wiki for configuration and limitations.
Full Changelog: v0.5.0...v0.6.0
Full Changelog: v0.5.0...v0.6.0
v0.5.0
Touch gestures, userscripts 2.0, CEF 151.8, and GPU shared-texture OSR.
Touch & gestures
- One-finger drag on empty canvas pans; two-finger pinch/drag zooms and pans
- One finger on a page forwards real CEF touch events
- macOS trackpad pinch also zooms the canvas when winit emits it
Userscripts 2.0
- Metadata:
// @name,// @match,// @exclude,// @run-at(document-start/document-end/document-idle) - Minimal GM prelude:
GM_addStyle,GM_getValue,GM_setValue(localStorage-backed) - Ctrl+Shift+U: list, toggle enable/disable, reload from disk, open scripts folder
- Disabled scripts tracked in
~/.config/spatial-browser/userscripts_state.json
Engine / rendering
- CEF bump to 151.8.0 (+ soft-nav crash workaround kept until M152 lands in cef-rs)
- GPU shared-texture OSR on by default; wgpu prefers LowPower/iGPU so DMA-BUF import matches CEF on hybrid laptops
- Overrides:
SPATIAL_BROWSER_OSR=cpu,SPATIAL_BROWSER_GPU=high(dGPU; falls back to CPU OSR unless you also setOSR=gpu)
Linux x86_64 only. See README for architecture/build.
Full Changelog: v0.4.2...v0.5.0
v0.4.2
Userscripts, a much bigger ad-blocklist, clean URLs, and reader mode.
Plugins
- Userscript runner:
.jsfiles with// @match <pattern>under~/.config/spatial-browser/userscripts/, injected into matching pages — real Chrome extensions aren't feasible on this embedding
Ad/tracker blocking
- Blocklist: ~55 domains → Peter Lowe's list (~3500), O(1) lookup instead of linear scan
- Bookmarks folder grouping actually sorts now (ungrouped first, then alphabetical)
Reading
- Clean URLs: strips
utm_*/fbclid/gclid/etc. from links (keeps a couple params that can double as auth/paywall tokens) - Reader mode (Ctrl+Shift+R): extracts article content into a single-column view, 3 themes; toggle off reloads the page
Linux x86_64 only. See README for architecture/build.
Full Changelog: v0.4.1...v0.4.2
v0.4.1
Chrome bookmarks import, @bing/@wiki, and a real 60fps ceiling fix.
Import
import-chrome— a one-time CLI tool that reads Chrome's Bookmarks file and merges the entries into spatial-browser's own bookmarks.json, preserving existing ones. No sync, no live link back to Chrome afterward.
Omnibox
@bingand@wikisearch shortcuts; prefix matching is now case-insensitive (@Gworked the same as@g)
Performance & fixes
- Removed two hardcoded 60fps ceilings (the main event loop's own pacing, and every page's CEF frame rate) unrelated to GPU rendering — Settings (Ctrl+,) now has a frame-rate picker (60/90/120, default 60), applied live to already-open pages
- Ctrl+Shift+C copies the focused page's URL — there's no address bar to select it from
- Fixed a real bug: every generated page was missing a
charset=utf-8on itsdata:URL, so non-ASCII text (e.g. Cyrillic search queries) rendered as mojibake
Linux x86_64 only. See README for architecture/build.
Full Changelog: v0.4.0...v0.4.1
v0.4.0
Ad/tracker blocking and a Settings page.
Ad & tracker blocking
- Blocks ~55 known ad-serving/tracking domains at the request level, on by default, toggleable from Settings
Settings (Ctrl+,)
- Ad-block on/off, default search engine (Google/DuckDuckGo/Bing), a direct theme picker, and your own extra blocked hosts on top of the built-in list
Linux x86_64 only. See README for architecture/build.
Full Changelog: v0.3.0...v0.4.0
v0.3.0
Canvas legibility, keyboard-first list navigation, and an installer.
Canvas
- Unfocused pages get a thin border and a slight dim so the focused page always pops
- A page still loading its first CEF frame shows a pulsing placeholder instead of a blank tile
- A world-space dot grid on the bare canvas, pans/zooms with everything on it
- Ctrl+/ as an alias for F1 (shortcuts page)
Keyboard navigation
- Every list page (bookmarks, downloads, history, workspaces) now supports ArrowUp/ArrowDown + Enter, matching the page switcher
Install
./scripts/install.shadds a proper app-launcher entry (Super/wofi/rofi/...)
Linux x86_64 only. See README for architecture/build.
Full Changelog: v0.2.0...v0.3.0