New Research: Supply Chain Attack on Axios Pulls Malicious Dependency from npm.Details
Socket
Book a DemoSign in
Socket

wavedrom

Package Overview
Dependencies
Maintainers
1
Versions
96
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

wavedrom

Digital timing diagram in your browser

latest
Source
npmnpm
Version
3.6.1
Version published
Weekly downloads
4.4K
-23.44%
Maintainers
1
Weekly downloads
 
Created
Source

CI NPM version PayPal donate button Coverage Status

EDITOR | TUTORIAL

Introduction

WaveDrom is a Free and Open Source online digital timing diagram (waveform) rendering engine that uses javascript, HTML5 and SVG to convert a WaveJSON input text description into SVG vector graphics.

WaveJSON is an application of the JSON format. The purpose of WaveJSON is to provide a compact exchange format for digital timing diagrams utilized by digital HW / IC engineers.

The engine is using WaveDromSkin skin mechanism to render a complete picture.

Server

svg.wavedrom.com

![Alt](https://svg.wavedrom.com/github/<USER>/<REPO>/<BRANCH>/<PATH>/<FILENAME>.json5)
![signal step4](https://svg.wavedrom.com/github/wavedrom/wavedrom/trunk/test/signal-step4.json5)

signal step4

![reg vl](https://svg.wavedrom.com/github/wavedrom/wavedrom/trunk/test/reg-vl.json5)

reg vl

<img src="https://svg.wavedrom.com/{WAVEDROM SOURCE}/>
<img src="https://svg.wavedrom.com/{signal:[{name:'clk',wave:'p......'},{name:'bus',wave:'x.34.5x',data:'head body tail'},{name:'wire',wave:'0.1..0.'}]}"/>

CLI

WaveDrom can be used from the command line to generate SVG files from JSON5 source.

Run with npx

npx wavedrom --input source.json5 > output.svg

Global Installation

npm install -g wavedrom
wavedrom --input source.json5 --indent 2 > output.svg

Options

  • -i, --input <path>: (Required) Path to the WaveJSON source file.
  • -t, --indent <number>: Text indent in the output SVG.
  • -h, --help: Show help message.

Export to PNG

To export a waveform to PNG, you can use the @resvg/resvg-js-cli tool:

npx wavedrom -i source.json5 | npx @resvg/resvg-js-cli - output.png

Web usage

WaveDrom timing diagrams can be embedded into the web pages, blogs, and wikis to be rendered by the most of modern browsers.

HTML pages

There are three steps to insert WaveDrom diagrams directly into your page:

  • Put the following line into your HTML page <header> or <body>:

From a CDN (jsDelivr):

<script src="https://cdn.jsdelivr.net/npm/wavedrom@3/wavedrom.min.js" type="text/javascript"></script>

or (unpkg):

<script src="https://unpkg.com/wavedrom@3/wavedrom.min.js" type="text/javascript"></script>
  • Set the onload event for the HTML body.
<body onload="WaveDrom.ProcessAll()">
  • Insert WaveJSON source inside HTML <body> wrapped with the <script> tag:
<script type="WaveDrom">
{ signal : [
  { name: "clk",  wave: "p......" },
  { name: "bus",  wave: "x.34.5x",   data: "head body tail" },
  { name: "wire", wave: "0.1..0." },
]}
</script>

The script will find all <script type="WaveDrom"> instances and insert a timing diagram at that point.

impress.js

(http://wavedrom.com/impress.html)

Blogs & Wikis

ObservableHQ examples: (https://observablehq.com/collection/@drom/wavedrom)

Blogger integration: (http://wavedrom.blogspot.com/2011/08/wavedrom-digital-timing-diagram-in-your.html)

MediaWiki integration: (https://github.com/Martoni/mediawiki_wavedrom)

Editor

WaveDromEditor is an online real-time editor of digital timing diagrams based on the WaveDrom engine and WaveJSON format.

Standalone WaveDromEditor

Windows

  • Download latest wavedrom-editor-v2.4.2-win-{ia32|x64}.zip release from here: releases
  • Unzip it into a working directory.
  • Run the editor: wavedrom-editor.exe

Linux

  • Download the latest wavedrom-editor-v2.4.2-linux-{ia32|x64}.tar.gz release from here: releases
  • unzip-untar the package: tar -xvzf wavedrom-editor-v2.3.2-linux-x64.tar.gz
  • Run the editor: ./WaveDromEditor/linux64/wavedrom-editor

OS X

  • Download the latest wavedrom-editor-v2.4.2-osx-x64.zip release from here: releases
  • Unzip
  • Run

Community

Please use the WaveDrom user group for discussions, questions, ideas, or whatever.

Contributing

Contributing

License

See LICENSE.

Keywords

waveform

FAQs

Package last updated on 03 Apr 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts