{
  "manifest": {
    "spekkr": 1,
    "id": "onyx/chip8-core",
    "name": "CHIP-8 core",
    "summary": "A CHIP-8 core in Verilog, checked with test ROMs and fixture programs, plus golden framebuffer dumps, with no FPGA or handheld required.",
    "keywords": [
      "chip-8",
      "verilog",
      "test roms",
      "framebuffer",
      "testbench"
    ],
    "kind": "HDL",
    "version": "0.2.1",
    "author": {
      "id": "onyx",
      "name": "Onyx"
    },
    "targets": {
      "stack": [
        "Verilog",
        "Icarus",
        "Verilator"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "cycles",
          "label": "Cycles to run",
          "default": "20000",
          "help": "A default cap for a fixture, from 1000 to 200000."
        },
        {
          "key": "scale",
          "label": "Dump scale",
          "default": "4",
          "help": "How many pixels a CHIP-8 pixel becomes in a PNG, 2, 4 or 8."
        }
      ],
      "options": [
        {
          "key": "super",
          "label": "A documented Super extension",
          "default": false,
          "help": "Only if a fixture ROM needs it; default is classic CHIP-8."
        },
        {
          "key": "sound",
          "label": "A sound flag",
          "default": true,
          "help": "The sound timer is dumped; no speaker is required."
        }
      ],
      "swaps": [
        {
          "key": "sim",
          "label": "Simulator",
          "choices": [
            "icarus",
            "verilator"
          ],
          "default": "verilator",
          "help": "Either must pass the same ROMs and dumps."
        }
      ]
    },
    "files": [
      {
        "path": "spec.md",
        "about": "Requirements and acceptance checks."
      },
      {
        "path": "design.md",
        "about": "Test ROMs, original fixtures, framebuffer goldens, and rights notes."
      },
      {
        "path": "tasks.md",
        "about": "Build tasks in order, each with a check."
      },
      {
        "path": "reference/dot-and-line.ch8.txt",
        "about": "A description of the original fixture ROM used for the listing frames."
      },
      {
        "path": "reference/preview.html",
        "about": "A working reference preview of the default view, used to make the listing pictures. A build does not have to start from this file."
      },
      {
        "path": "reference/fonts/fonts.css",
        "about": "Webfont faces for the reference preview."
      },
      {
        "path": "reference/fonts/Geist.ttf",
        "about": "Geist variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/GeistMono.ttf",
        "about": "Geist Mono variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/Fraunces.ttf",
        "about": "Fraunces variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/Fraunces-Italic.ttf",
        "about": "Fraunces italic variable typeface for the reference preview."
      }
    ],
    "needs": {
      "permissions": [
        "shell"
      ]
    },
    "demo": {
      "screenshots": [
        "shots/hero.png",
        "shots/loop.webp"
      ]
    },
    "safety": {
      "commands": [
        "install a Verilog simulator, such as Icarus or Verilator",
        "install a tool that can write a PNG from a framebuffer dump"
      ]
    },
    "lineage": {},
    "changelog": [
      {
        "version": "0.2.1",
        "date": "2026-11-14",
        "note": "Add animated loop to the listing shots."
      },
      {
        "version": "0.2.0",
        "date": "2026-11-14",
        "note": "Polished reference preview and new listing shots, including a short loop."
      },
      {
        "version": "0.1.0",
        "date": "2026-11-14",
        "note": "First version."
      }
    ]
  },
  "links": {
    "page": "./",
    "bundle": "bundle.tar.gz",
    "files": {
      "design.md": "files/design.md",
      "reference/dot-and-line.ch8.txt": "files/reference/dot-and-line.ch8.txt",
      "reference/fonts/Fraunces-Italic.ttf": "files/reference/fonts/Fraunces-Italic.ttf",
      "reference/fonts/Fraunces.ttf": "files/reference/fonts/Fraunces.ttf",
      "reference/fonts/Geist.ttf": "files/reference/fonts/Geist.ttf",
      "reference/fonts/GeistMono.ttf": "files/reference/fonts/GeistMono.ttf",
      "reference/fonts/fonts.css": "files/reference/fonts/fonts.css",
      "reference/preview.html": "files/reference/preview.html",
      "shots/hero.png": "files/shots/hero.png",
      "shots/loop.webp": "files/shots/loop.webp",
      "spec.md": "files/spec.md",
      "tasks.md": "files/tasks.md"
    }
  },
  "publishedBy": "onyx",
  "uploaded": {
    "reference/fonts/Fraunces-Italic.ttf": {
      "bytes": 407304,
      "type": "font/ttf"
    },
    "reference/fonts/Fraunces.ttf": {
      "bytes": 357632,
      "type": "font/ttf"
    },
    "reference/fonts/Geist.ttf": {
      "bytes": 168804,
      "type": "font/ttf"
    },
    "reference/fonts/GeistMono.ttf": {
      "bytes": 173204,
      "type": "font/ttf"
    },
    "shots/hero.png": {
      "bytes": 106885,
      "type": "image/png"
    },
    "shots/loop.webp": {
      "bytes": 1855830,
      "type": "image/webp"
    }
  }
}
