{
  "manifest": {
    "spekkr": 1,
    "id": "onyx/timer-spice",
    "name": "Timer SPICE",
    "summary": "A suite of 555 timer circuits in SPICE: astable, monostable and applications, with plots checked against documented periods and trip points.",
    "keywords": [
      "555",
      "spice",
      "astable",
      "monostable",
      "ngspice"
    ],
    "kind": "circuit design",
    "version": "0.2.1",
    "author": {
      "id": "onyx",
      "name": "Onyx"
    },
    "targets": {
      "stack": [
        "ngspice"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "vcc",
          "label": "Supply, V",
          "default": "5",
          "help": "From 4.5 to 15, the supply used in the default suite."
        },
        {
          "key": "ra",
          "label": "Ra, ohms",
          "default": "10000",
          "help": "A timing resistor, from 1000 to 1e6."
        },
        {
          "key": "rb",
          "label": "Rb, ohms",
          "default": "10000",
          "help": "A second timing resistor, from 1000 to 1e6."
        },
        {
          "key": "c",
          "label": "C, farads",
          "default": "1e-7",
          "help": "The timing capacitor, from 1e-9 to 1e-5."
        }
      ],
      "options": [
        {
          "key": "applications",
          "label": "Two application circuits",
          "default": true,
          "help": "A documented LED flasher and a one-shot, besides the two canonical forms."
        },
        {
          "key": "model_note",
          "label": "A model card",
          "default": true,
          "help": "A shipped 555 model card; if off, a behavioural source with the same trip points may be used, as in the file."
        }
      ],
      "swaps": [
        {
          "key": "engine",
          "label": "Engine",
          "choices": [
            "ngspice",
            "other"
          ],
          "default": "ngspice",
          "help": "other is an equivalent SPICE that still consumes the same netlists and produces comparable plots."
        }
      ]
    },
    "files": [
      {
        "path": "spec.md",
        "about": "Requirements and acceptance checks."
      },
      {
        "path": "design.md",
        "about": "Astable and monostable formulas, trip points, and application circuits."
      },
      {
        "path": "tasks.md",
        "about": "Build tasks in order, each with a check."
      },
      {
        "path": "reference/astable.cir",
        "about": "A starting ngspice netlist for the default astable. A build must match the periods in design.md."
      },
      {
        "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 ngspice or an equivalent SPICE engine",
        "install a tool that can write a plot from a simulation"
      ]
    },
    "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/astable.cir": "files/reference/astable.cir",
      "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": 123603,
      "type": "image/png"
    },
    "shots/loop.webp": {
      "bytes": 1718958,
      "type": "image/webp"
    }
  }
}
