Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


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

DSPnote: Create Notebooks with Interactive Figures

Demo articles:

DSPnote is a static site generator specialized in creating notebooks with interactive figures. Some features:

  • Generative audio scripts with parameters: scripts written in Sporth can be included directly in the text, with an optional block diagram, and run in-browser with sliders to control variables
  • WebGL shaders with parameters: GLSL ES fragment shaders can be included, with auto-generated image fallbacks
  • Math typesetting; code blocks with syntax highlighting

Installing and Using

DSPnote requires Python 3. The following commands should work similarly on all platforms. Clone or download the repository (master branch), and in the resulting folder, run the command:

pip3 install -e .

This installs, along with its dependencies, the tool dspnote-gen, which takes a single argument: a directory containing a dspnote project. An example project is included, and the article can be generated by running:

dspnote-gen example

This will generate the site to example/out. Change to this directory and run the following command to serve the site locally:

python3 -m http.server 8000

Then, point your browser to http://localhost:8000/exampleNote. For a more complex example project, see pac-dev/notes.

To create a new project, copy the example folder and modify it. Each Markdown file in the content subfolder will generate an article. Assets for each article (eg. GLSL sources, images) are in a folder of the same name alongside the Markdown file.

Prior Art


Create Notebooks with Interactive Figures



No releases published


No packages published