$ show ungoogled-software/ungoogled-chromium
This repository is a build tooling and patching infrastructure for producing a de-Googled Chromium browser. It does not contain the browser itself but provides the configuration files, patches, and scripts needed to download, modify, and build Chromium without Google web service dependencies. The architecture consists of several layers: configuration files (flags.gn, pruning.list, domain_substitution.list, downloads.ini) that define what to remove or alter; source file processors (binary pruning, domain substitution) that modify the Chromium source tree; a quilt-based patch system with core and extra patches organized by origin (ungoogled-chromium, Bromite, Inox, Iridium, Debian); and utility scripts in the `utils/` and `devutils/` directories for downloading, patching, validating, and building. Key entry points include `utils/downloads.py` for fetching Chromium source, `utils/patches.py` for applying patches, `utils/domain_substitution.py` for replacing Google domains, and `devutils/validate_config.py` for sanity checks. The primary data flow is: clone Chromium source → prune binaries → apply patches → substitute domains → build with GN flags. External dependencies include the Chromium source tree, quilt, Python 3, and platform-specific build tools (e.g., ninja, clang). The project is actively maintained with CI workflows that validate patches and check for new Chromium versions, but it is tightly coupled to specific Chromium releases, requiring constant patch updates.
The LLM identified 4 files worth highlighting for reuse:
A self-contained Python module that performs domain substitution on Chromium source files using regex patterns from domain_regex.list and domain_substitution.list. It replaces Google domains with non-existent TLDs (e.g., qjz9zk) to block requests. The module is well-structured, handles file I/O efficiently, and can be extracted and reused in any project that needs to systematically replace domain strings in source code. It demonstrates non-obvious skill in balancing performance with correctness across a large codebase.
A Python module that manages GNU quilt patches: applying, refreshing, and merging patch series. It reads the patches/series file, handles patch ordering, and integrates with the build process. The module is reusable for any project using quilt for patch management, and its clean API (apply, unapply, refresh) makes it easy to adapt. It demonstrates solid engineering with error handling and logging.
A robust download and extraction utility that fetches Chromium source tarballs, verifies SHA256 checksums, and extracts them with fallback extractors for Windows and UNIX. It supports resumable downloads and handles various archive formats. The module is self-contained and could be reused in any project requiring reliable download and extraction of large archives. It demonstrates careful handling of edge cases (network failures, partial downloads, platform differences).
A comprehensive validation script that checks all configuration files (flags.gn, pruning.list, domain_substitution.list, downloads.ini) and patches for consistency and correctness. It verifies that patches apply cleanly, flags are valid, and required files exist. This module is reusable as a template for validating complex build configurations in any project. It demonstrates a systematic approach to preventing configuration drift and build failures.