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.1.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.1-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for zenscraper-1.0.1.tar.gz
Algorithm Hash digest
SHA256 7b8bad04e28e20cce5e62e45fdd46c8449a26f76ca5bf10698ced8a93e798950
MD5 0d6506cbd6c0118f1b887e1d432c4e36
BLAKE2b-256 1ce99477aabd3c31f2c8b3cbb66ea2aeb27a85c3cf3737f830fcaa95feddc6ae

See more details on using hashes here.

Provenance

The following attestation bundles were made for zenscraper-1.0.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: zenscraper-1.0.1-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.13

File hashes

Hashes for zenscraper-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cc4a013d6638265a73b8ce03956f85083572ab0f719eb4cc2c8f3426a88f0322
MD5 9a698e510d722053ded3e0c8f783f049
BLAKE2b-256 6ff5f53be4bbc5161e2128d7706e080dfb9481fef0b3b7934d0dcc916feca9e7

See more details on using hashes here.

Provenance

The following attestation bundles were made for zenscraper-1.0.1-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