Home
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.
-
Digigurdy User Guide - setup, operation, and general use
-
Quick Start Guide - UNDER CONSTRUCTION
-
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:
(Performed and narrated by John Dingley himself!)
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,Geared | Teensy3.5,4.1 - HW SPI | "White" OLED | MIDI-OUT | LED (Optical only), Pedal (MIDI only) | 2.3.1 | testing | https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/testing.zip |
| LEGACY VERSIONS | |||||||
| Optical, Crank | Teensy3.5,4.1 - SW SPI | "White" and "Blue"(3.5 only) OLED | MIDI-OUT, Tsunami(3.5) | LED (Optical Only, Pedal (MIDI only) | 2.0.22 | 2.0.0 | https://github.com/bazmonk/digigurdy-baz/archive/refs/heads/2.0.0.zip |
| 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 |
- Building Digigurdy-baz manually - notes for compiling the source code yourself
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).
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.