Skip to main content

ZenScraper

Build CodeQL PyPI version Python versions Snyk package health OpenSSF Scorecard

A command line tool to collect AMD uCode!

Overview

ZenScraper gathers AMD CPU microcode (uCode) patches from public upstream repositories, extracts the individual patches from their containers, and stores them under a single directory with a consistent, content-addressed naming scheme. Patches that already exist are de-duplicated by SHA-256, and a hash mismatch on a same-named patch is reported as an error.

Currently supported sources:

  • Linux Firmware — the linux-firmware repository (amd-ucode containers, extracted into individual patches).
  • Platomav CPUMicrocodes — the platomav/CPUMicrocodes repository (AMD patches).

Each source is walked across its full git history, so superseded patches are collected as well as current ones.

Installation

pip install zenscraper

Usage

Run the tool to scrape every supported source into the current directory:

zenscraper

Options:

Option Default Description
--workdir, -w ./workdir Directory for temporary and cached files (the cloned repos are kept here between runs).
--outdir, -o . (current directory) Directory where the collected patches are stored.

Output

Collected patches are written to a patches/ subdirectory of --outdir. Each file is named after its parsed header fields and a short content hash, for example:

family19_cpuidA20F12_rev0A201210_date20240611_enc00_sha1a2b3c4d5e6f.bin

The fields encode the CPU family, CPU ID, update revision, build date, encryption flag (when present) and the first 12 hex digits of the patch's SHA-256 hash.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zenscraper-1.0.2.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

zenscraper-1.0.2-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file zenscraper-1.0.2.tar.gz.

File metadata

  • Download URL: zenscraper-1.0.2.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for zenscraper-1.0.2.tar.gz
Algorithm Hash digest
SHA256 8533a7fc9229825c92ac3f4a77227443f834802629f26de74f6deba14a5fe817
MD5 0383ceb3f8cf952f49ee7553c82274b2
BLAKE2b-256 5bc1449e9cc08b374e9b6e614ad091dc74073a4e18de8cea0d802707e9477dac

See more details on using hashes here.

Provenance

The following attestation bundles were made for zenscraper-1.0.2.tar.gz:

Publisher: build.yml on amd-zenith/zenscraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file zenscraper-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: zenscraper-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for zenscraper-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6e36e281caa0bf4e65b2fb45e6ed3f7add02bf12c8591189662ba9c7c166fb48
MD5 4d1c44d3bf2f1a94cdd21ee64e14459b
BLAKE2b-256 6628ca36978fdca16c5aa47140f4b5c7652f5b2ca1edb9febe3dfe65d477ca5a

See more details on using hashes here.

Provenance

The following attestation bundles were made for zenscraper-1.0.2-py3-none-any.whl:

Publisher: build.yml on amd-zenith/zenscraper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page