Repository navigation
Getting Started
Loafer19 edited this page Oct 11, 2026
·
3 revisions
- Download
spatial-browser-linux-x86_64.tar.gzfrom Releases. - Extract and run:
tar xzf spatial-browser-linux-x86_64.tar.gz
./compositorscripts/run.sh (from a source checkout) wraps the binary and auto-relaunches after the known CEF SPA crash — see Limitations. Restarts are appended to ~/.config/spatial-browser/restarts.log.
Needs a Linux x86_64 machine, Rust toolchain, and a one-time CEF tools install:
cargo install cef --version 154.5.0+154.0.34 --locked \
--root ~/.local/share/cargo-cef-tools
cargo install export-cef-dir --version 154.5.0+154.0.34 --locked \
--root ~/.local/share/cargo-cef-tools
~/.local/share/cargo-cef-tools/bin/export-cef-dir --force ~/.local/share/cef
cargo build
./scripts/bundle.sh compositor
./scripts/run.sh compositor
./scripts/install.sh # optional: desktop launcher entrySet CEF_PATH (usually ~/.local/share/cef): copy .cargo/config.toml.example → .cargo/config.toml (gitignored) or export the env var. Keep cef / export-cef-dir in sync with crates/*/Cargo.toml (also pinned in CI as CEF_VERSION).
| Action | Shortcut |
|---|---|
| New page (omnibox) | Ctrl+T |
| Bookmarks |
Ctrl+D / Ctrl+B
|
| History | Ctrl+H |
| Workspace slots | Top-edge chips / Ctrl+1…9 / Ctrl+N
|
| Move page → slot |
Ctrl+Shift+1…9 (creates slot if missing) |
| Settings | Ctrl+, |
| All shortcuts |
F1 or Ctrl+/
|
| Userscripts | Ctrl+Shift+U |
More: Canvas-and-Shortcuts, Features.
Ctrl+B → Import… → file dialog (always). If a profile is found, it opens in that folder (e.g. ~/.config/google-chrome/Default/) with Bookmarks or AccountBookmarks preselected. Merges by URL; existing entries are kept.