Skip to content

README.md

Latest commit

 

History

History
42 lines (33 loc) · 1.68 KB

README.md

File metadata and controls

42 lines (33 loc) · 1.68 KB
Raw

TronBrowser Chromium fork

The build pipeline that turns upstream Chromium + Ungoogled Chromium into the TronBrowser binary. Base: Ungoogled Chromium (see ADR 0001).

Layout

chromium/
  config/
    version.json        # pinned chromium + ungoogled versions
    gn-args/            # compile-time build args (privacy + branding)
  branding/             # product strings + icon assets
  patches/              # TronBrowser patch series (applied after ungoogled)
  scripts/              # fetch / sync / apply-patches / build / package

Build (the real thing is large: ~50GB checkout, hours to compile)

The scripts are guarded: they dry-run unless TB_RUN=1 is set. Source lands outside the repo in $TB_WORKDIR (default ~/.cache/tronbrowser-chromium).

TB_RUN=1 ./scripts/fetch.sh          # depot_tools + ungoogled + chromium src
TB_RUN=1 ./scripts/sync.sh           # gclient hooks
TB_RUN=1 ./scripts/apply-patches.sh  # ungoogled patches + TronBrowser series + branding
TB_RUN=1 ./scripts/build.sh          # gn gen + autoninja
TB_RUN=1 ./scripts/package.sh        # tarball / zip

Privacy posture

  • Compile-time: config/gn-args/common.gni empties Google API keys and disables reporting/RLZ/Safe-Browsing phone-home.
  • Patch-time: patches/ strips residual telemetry and all sponsored / affiliate surfaces.
  • Run-time: ../src/chromium-flags.ts adds privacy launch flags by default and refuses any sponsored/affiliate flag.

Preserved from upstream (PRD §Desktop): Chrome extensions, profiles, bookmarks, downloads, history, PWAs, DevTools.