Skip to content
bazmonk edited this page Dec 14, 2022 · 56 revisions

Digigurdy-baz Documentation Main Page

Welcome to the repository for the digigurdy-baz code. If you're thinking, "What on Earth is a digigurdy-baz?", check out the Digigurdy website at https://digigurdy.com for info on the instrument itself by John Dingley. This is the software that runs it.

Why -baz? I'm Basil, and I didn't want to call it the same thing as the object itself :-)

Refer here for help compiling, installing, and using this code on your Digigurdy.

User Guide

Installing/Upgrading your Digigurdy

  • Updating your Digigurdy (with pre-compiled code) - how to install the "builds" listed below to upgrade the software on your gurdy without having to compile it yourself. Here's a video of the process:

    Loading Software Updates to Digi-Gurdy

    (Performed and narrated by John Dingley himself!)

Latest Builds

NOTE: The versions below (especially the testing version) are not necessarily the latest versions. They're just the latest version with pre-compiled builds available.

These are the latest builds available pre-compiled. The builds are .hex files in the /builds folder in these branches of the repository. Simply download the ZIP file here as-needed, extract it on your computer, and find the builds folder in it.

Crank Style Teensy Board Screen Type Secondary Audio LED/Accessory Pedal? Version Branch ZIP Download
Optical Teensy4.1 - HW SPI "White" and "Blue" OLED MIDI-OUT LED, Pedal (MIDI only) 2.2.1 main https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/main.zip
Optical Teensy4.1 - SW SPI "White" OLED MIDI-OUT, Trigger, Tsunami LED, Pedal (MIDI only) 2.0.0 main https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/2.0.0.zip
LEGACY VERSIONS
Motor Teensy3.5 "White" and "Blue" OLED MIDI-OUT None 1.4.1 v1.4.1 https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/v1.4.1.zip
Motor Teensy4.1 "White" OLED MIDI-OUT None 1.4.1 v1.4.1 https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/v1.4.1.zip

Compiling the Code Manually

Branches can be downloaded as zip files (the green "Code" button on each branch page), but if you're going to be compiling the code I recommend you pull the git repository yourself, especially if you want to submit changes (pull requests).

Hardware SPI

Beginning with version 2.2, your Digi-gurdy must be wired up to use hardware-accelerated SPI for your screen. Digi-gurdies before December, 2022 are not wired up by default for this, and will need to be re-wired to use versions beyond 2.0.

See here for more information.

Digigurdy-baz is the awkward name for the software that powers the Digi-gurdy.

The Digi-gurdy is an electronic/MIDI hurdy gurdy.

Clone this wiki locally