Noureddine RAMDI / under the hood of nothing archive: archiving nothing os ota firmware with static site automation

Created Mon, 04 May 2026 10:23:02 +0000 Modified Sat, 23 May 2026 20:41:27 +0000

spike0en/nothing_archive

Nothing Archive addresses a challenge familiar to anyone involved in Android device firmware: how to reliably collect, version, and preserve OTA (over-the-air) firmware images for Nothing and CMF devices. Firmware updates come as incremental delta OTAs or full packages, often only available temporarily from OEM servers. This project builds a community-driven, static site archive that catalogs official firmware, community apps, changelogs, and guides — all automated through CI/CD pipelines with self-hosted GitHub runners.

what nothing archive does and how it’s built

At its core, Nothing Archive is a firmware and resource hub focused on Nothing OS devices and related CMF hardware. It serves as the most comprehensive OTA archive for Nothing OS, providing users with access to official firmware packages, incremental delta OTAs, changelogs, and community-developed apps like GCAM ports.

The repo is structured as a static website — primarily CSS-based and likely built on Docusaurus or a similar static site generator. This choice favors simplicity and longevity: the site content is pre-rendered, making hosting lightweight and reliable without dynamic backend dependencies.

The firmware files themselves are not stored in the repo but sourced directly from OEM servers, then archived offline for long-term preservation. This approach respects storage constraints but still ensures users have access to historical OTA versions.

Automation is central to the project’s architecture. Self-hosted GitHub runners execute scripts that scrape OEM servers for new OTA updates, extract and process AOSP delta OTAs, and update the static site content accordingly. The project credits community contributors for specialized OTA extraction tooling and device-specific adaptations, highlighting a collaborative ecosystem.

Licensing is thoughtfully handled with a multi-license strategy: MIT for website and automation code, Creative Commons licenses for documentation and branding assets. This division clarifies usage rights and encourages responsible community contributions.

the technical strengths and tradeoffs of nothing archive

The standout technical aspect of Nothing Archive is its automated pipeline for extracting, processing, and serving OTA firmware images at scale. OTA updates are often delivered as incremental patches (AOSP delta OTAs), which are more complex to handle than full images. The repo integrates tooling that extracts and reconstructs these delta OTAs, enabling the archive to faithfully represent firmware version progression.

Using static site generation for the archive interface is a tradeoff worth noting. It simplifies hosting and reduces infrastructure complexity but limits dynamic user interactions or real-time querying. For a resource focused on archival stability rather than live user data, this tradeoff makes sense.

The use of self-hosted GitHub runners for automation is a practical choice balancing CI/CD flexibility and control over execution environments. However, it requires ongoing maintenance and infrastructure management by the maintainers, which can be a bottleneck if scaling or if runner availability fluctuates.

The multi-licensing approach reflects a mature understanding of open source governance. MIT licensing for code allows broad reuse and contribution, while Creative Commons licenses protect documentation and branding from commercial misuse or unauthorized modifications. This complexity is a tradeoff in clarity but essential for a project mixing technical and community-facing assets.

One limitation is reliance on OEM servers for initial firmware retrieval. If those servers go offline or remove older OTA files, the archive depends on previously cached versions. This makes the project more of a preservation effort than a live OTA source.

explore the project

The repo’s README and accompanying documentation provide detailed insight into the extraction tooling, automation workflows, and licensing policies. Since there is no installation or quickstart section, exploring the project involves:

  • Reviewing the automation scripts and GitHub Actions workflows to understand the scraping and OTA extraction pipeline.
  • Examining the static site source files and CSS to see how firmware versions and community resources are presented.
  • Checking the documentation folders for device-specific guides, changelogs, and community app collections.

This approach helps new contributors or users understand the full pipeline from OEM scraping to static site generation.

verdict

Nothing Archive is a niche but technically interesting project for anyone invested in Nothing OS devices, Android firmware preservation, or OTA management. It showcases a practical pipeline for capturing and archiving complex incremental OTAs, combined with a lightweight static site delivery model.

While it doesn’t solve every challenge around firmware availability — reliance on OEM sources and static site constraints limit some use cases — it provides a valuable community resource and a replicable automation pattern.

It’s relevant for device maintainers, developers working with Android OTAs, and community archivists. The code quality and licensing choices reflect a mature open source project mindful of both technical and community needs.

If you’re interested in firmware pipelines or community-driven archival projects, Nothing Archive is worth a close look.


→ GitHub Repo: spike0en/nothing_archive ⭐ 918 · CSS