instrument-maker

A framework for making digital instruments with sensors, driven by a need to improve access.


Instrument Maker is an open source framework for digital instrument building with sensors, for Pure Data running on embedded computers such as Bela or Raspberry Pi + Arduino.

Massive overhaul in progress -- watch this space.

Key pages:

Distributed under the terms of the GNU Public license version 3.

The core code was developed by Charles Matthews, as a way to develop collaborative workshops with Gift Tshuma, with more in the pipeline through our project Blurring the Boundaries.


Read about the philosophy behind this framework on the Bela.io blog.


The key ingredients of the instrument maker framework are sensors, musical scales, effects, and code.


How does it work?

Although Instrument Maker was designed as a complete workshop package, the main resource is a library of objects for Pure Data that can be used independently.

Instrument Maker code is designed to complement the existing Pure Data objects

Having downloaded the library, create and connect building blocks in the form of obects with the im. prefix: e.g. inputs, outputs, tuning systems, processors, and synthesisers.

Upload this code to Bela, or use a Raspberry Pi with an Arduino-type device connected.

The Instrument Maker objects in Pure Data sit on a white screen, featuring minimal outlined boxes with black connecting lines. The boxes are labelled: input, scale, sinewave, volume, and they are connected to further boxes labelled echo and output. The lines are drawn from the top, through each of the boxes in various inlets and outlets, into a box labelled output.


Installation

This is for our current demo setup for desktops/RPi. Deken release and instructions for Bela coming soon!

We recommend using Patchbox OS for Raspberry Pi.

Recommended: clone this repo

Clone the repo to a local folder using terminal:

  • git clone https://github.com/matthewscharles/instrument-maker
    • On a Mac, you might be required to download developer tools. There is no need to install Xcode if prompted.
  • Keep up to date by periodically typing git pull within the folder in terminal.

Alternative: direct download

Click the green Clone or Download icon at the top of the GitHub repo to download a zip file. If you choose this option, you will need to download updates manually in the future.

Installation

  • Install Pure Data

    • On a Mac, you may need to right-click on the downloaded application to open it.
  • Add the instrument-maker folder to the search path in Pure Data:

    • from the pd menu (next to file), choose preferences > path
    • click new
    • browse to the folder you cloned to.

  • Find a list of objects by opening _im-object-overview.pd from the main folder

  • Right-click on the objects found here to open help files.

a list of current objects