C++ Makefile Shell
Permalink
Failed to load latest commit information.
avrlib @ 36b988a first May 29, 2016
bootloader first May 29, 2016
releases v1.0.1 May 31, 2016
.gitignore first May 29, 2016
.gitmodules first May 29, 2016
LICENSE first May 29, 2016
README.md video formatting Jun 2, 2016
makefile first May 29, 2016
twigs.cc MultiplyIsPossible -> PulseTrackerHasPeriod is more explicit Jun 3, 2016

README.md

Twigs

Twigs is an alternate firmware for the Mutable Instruments Branches Eurorack synthesizer module

Twigs consists of two functions

  • VC Factor - combination clock/trigger divider & multiplier
  • VC Swing - musical swing applied to clock/trigger

These functions can be assigned by the user to either or both channels on the module

Usage

Shared Input/Reset

twigs alt firmware, diagram of inputs

There is one major difference between the layout of Twigs and stock Branches: the channels don't have individual inputs.

As pictured, top input (1) is for reset and the bottom input (2) is for trig/clock. These inputs are shared by both channels

Functions

VC Factor

VC Factor is a combination clock/trigger divider and multiplier

Factor Control

twigs alt firmware, diagram of factor control

The channel's knob controls the factor, which determines whether the input is divided or multiplied and by how much

As illustrated above, turning the knob to the left produces increasing factors of multiplication, and to the right, division

When the knob is at the 1 position, the effect is bypassed the output will be the same as the input

Other Controls

twigs alt firmware, diagram of factor channel

The VC input (2) controls the factor in the same manner as the knob

While dividing, tapping the button (B) performs a manual reset. This results in the next input trig being a strike and the counter starting over. This is the same behavior as sending a pulse to the reset input

Both outputs (1) produce the same result

VC Swing

VC Swing modifies incoming triggers/clock to have musical swing

Controls

twigs alt firmware, diagram of swing channel

The knob (A) controls the swing amount with a range of 50% - 70%.

At 50%, the swing effect is essentially bypassed. However, as the knob turns clockwise, every other input trig is delayed by the specified percentage

The VC input (2) controls the swing amount in the same manner as the knob

Tapping the button (B) performs a manual reset. For the swing function, this means that the next input trig will be the non-swing one. This is the same behavior as sending a pulse to the reset input

Both outputs (1) produce the same result

Select a Function

By default, Twigs has VC Swing in the top channel and VC Factor in the bottom

Holding the channel's button for a couple of seconds will toggle the function of that channel. The current functions of the channel are stored and will remain when the module is powered up again

Video

Here is a short video that gives an overview of the functionality and usage

twigs alt firmware, demo video

Installation

Download the latest stable source & dependencies package here

Mutable Instruments' guide to installing open source firmware on Branches can be found here under "Sending the firmware to the module"

My notes for uploading Twigs using OSX and an interface I purchased on Amazon are here

Also my notes on similarly uploading the stock Branches firmware are here in case it's helpful

Credit

Although heavily modified, Twigs is based on the stock MI Branches firmware. That project can be found in the MI Eurorack repository and is copyright 2012 Olivier Gillet, licensed GPL3.0

Author

License

GPL3.0, See the file LICENSE

Copyright (c) 2016 Ari Russo