Dear DROID user,

this package contains the current firmware for the DROID master, the X7 and
the M4 and all sorts of other useful things, which help you when you work
with the DROID:

Release notes.pdf:
    Here you find all new features, new circuits and bugfixes of the
    firmware version that is contained in this package. Sometimes a
    firmware update requires you to adapt things in your DROID patches.
    Please look at this file for notes on that.

firmware:
    In this directory there are the firmware files in case you want
    to update your master or X7. Please refer to the manual on how
    the firmare upgrades are done.

manual:
    Here you find the comprehensive manual of all and everything
    about the DROID, a cheat sheet which just lists all the jacks
    and circuits as a short reference, and last but not least
    a file with all example patch snippets from the manual for
    easy copy & paste into your own patches.

patches:
    A collection of example patches. Each one is accompanied by a
    PDF file that shows you what all the buttons, knobs and jacks
    in that patch do. Each of the pachtes is built upon a certain
    configuration of controllers. The controller declarations are
    on top of the patches. The patches will only work if you have
    (at least) those controllers attached to your master, in that
    order.

graphics:
    Here you find two subdirectories with PNG images of the face plates
    of all Droid modules and of the circuit icons from the Forge and
    from the manual. You are allowed to use these images for private
    projects and for those that you release as open source projects
    under GNU GPL or similar licenses. Other use is restricted. Please
    contact me if you are unsure.

utilities:
    Various mixed utility files.

    In the subdirectory "editors" you find support files for various editors.
    The file droid.vim adds a syntax hiliting for DROID patches for the text
    editor vim. If you are using vim, copy that file to your home directory
    into the sub directory .vim/syntax. There are also circuit snippets
    (code templates) for Visual Studio Code and Sublime.

    The file circuits.json is for developers who want to create
    some sort of syntax support for other browers. It contains
    a database of all circuits and jacks of the current firmware
    version, ready to be used by some script.

    The subdirectory "sysex" contains one subdirectory for each of Windows,
    Mac and Linux. In the Windows directory you find the files sysexhead.txt
    and sysextail.txt for creating sysex files on Windows (see the manual
    for details). Both the Mac and Linux directory contain the script
    "droidpatch" which will upload a patch via your X7. The Mac directory
    also contains a version of sendmidi that can be installed into
    /usr/local/bin and is used by droidpatch.
