mirror of
https://github.com/Such-Software/adaptive-multi-protocol-browser.git
synced 2026-10-17 14:31:46 +02:00
45 lines
1.7 KiB
Markdown
45 lines
1.7 KiB
Markdown
# Desktop Vertical
|
|
|
|
> Status: draft | Updated 2026-07-07 | Applies to: AMPB desktop builders
|
|
|
|
The first AMPB browser proof is desktop-first with mobile constraints kept in view. The
|
|
vertical is a bundled Gecko desktop runtime, AMPB-owned profile state, and a managed Tor
|
|
runtime for `.onion` browsing. Android and iOS follow the same routing and transport
|
|
contracts after the desktop path is proven.
|
|
|
|
## Build Path
|
|
|
|
Use the external build workspace:
|
|
|
|
```sh
|
|
sh tools/browser-build-workspace.sh
|
|
sh tools/browser-source-sync.sh
|
|
AMPB_DESKTOP_BUILD_PROBE_MODE=build sh tools/browser-desktop-build-probe.sh
|
|
```
|
|
|
|
The desktop probe keeps Gecko source, object files, downloaded toolchains, Python
|
|
virtualenvs, pip cache, and logs under `/tmp/ampb-browser-build`.
|
|
|
|
The default build flavor is the verified source build. Use
|
|
`AMPB_DESKTOP_BUILD_FLAVOR=artifact` only as a faster optional probe when upstream
|
|
artifacts are available for the selected checkout.
|
|
|
|
## Transport Path
|
|
|
|
The first transport target is Tor through an AMPB-owned Arti/Tor runtime. The desktop
|
|
vertical is not complete until AMPB can start the runtime, verify the SOCKS endpoint, and
|
|
launch the bundled browser profile without clearnet fallback. I2P and Reticulum use the
|
|
same route, consent, state, and health-check model after Tor works.
|
|
|
|
## Desktop Shell
|
|
|
|
`ampbrowser shell <url>` is the first desktop shell bridge. It prepares the same open plan
|
|
as `ampbrowser open`, renders first-use transport consent as a desktop dialog when a
|
|
prompt is required, and then launches the bundled browser through the shared runner after
|
|
approval. Use `--yes` for scripted verification without showing the dialog.
|
|
|
|
```sh
|
|
python3 -m ampbrowser shell http://example.onion/
|
|
python3 -m ampbrowser shell http://example.onion/ --yes
|
|
```
|