Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This program converts JSON netlist output generated by Yosys circuit synthesis software (Github repo here) for use with the DigitalJS graphical circuit simulator.


You need to have Yosys installed to run yosys2digitaljs. For example, in Debian/Ubuntu, run:

apt install yosys

Clone the repository and install dependencies using npm:

git clone
cd yosys2digitaljs
npm install

Now you can run yosys2digitaljs on your Verilog or SystemVerilog files:

./process.js file.v ...

The generated JSON is printed on standard output.


Yosys2digitaljs can be used as a library. The API is promise (or async/await) based. Available functions are:

  • yosys2digitaljs(json, options) - converts the Yosys JSON output json (passed as an JS object) to a DigitalJS representation of the same circuit.
  • process_sv(sv_text, options) - converts a single SystemVerilog source passed as a string.
  • process_files(texts, options) - converts multiple Verilog/SystemVerilog sources. The texts parameter is an object, with keys being file names, and corresponding values containing the file contents as strings. Example: { '': 'module test; ...' }.
  • process(filenames, dirname, options) - converts Verilog/SystemVerilog sources saved on the filesystem under names filenames in the directory dirname.

The functions return a promise, which fulfills with an object value with following keys:

  • output: the conversion result as JS object, which can be stringified to JSON.
  • yosys_stdout and yosys_stderr: standard output and error output received from Yosys.

For bigger example, see the online app demo.