OctaDoc

This projects aims at documenting the file formats used by the Elektron Octatrack device.

This is far from a polished or foolproof project. Still WIP. No write is made to the CF card whatsoever.

General principle

OT files are synced from CF card to a local copy (in $DATA_REPOSITORY as per local.cfg) they are dumped to hex files, more human readable and easier to track for modifications All files are commited to git and difference between files dumped

Requirements

shell (bash and zsh have been tested so far), git, rsync, command line tools such as cp, cut, grep ...

Initialization

1. clone this repo locally
2. create a directory where to store CF date. Only selected data will be stored ( a few MB )
3. git init in this directory
4. copy ./local.cfg-example to ./local.cfg and edit according to your system configuration

Workflow Sequence after init

1. Open or create new project on the OT
2. save project
3. Enter USB mode
4. from this root directory, run ./octa-sync.sh
5. from this root directory, run ./octa-track.sh ; When prompted, describe what has changed (in one line)
6. eject octatrack drive and leave USB mode
7. change a single thing (or many if you dare !)
8. go back to 2. above

Usable result

The git log and diff shows what bytes were modified at step 7 (e.g. on Audio Track 1, turn knob B of page SRC clockwise)

We now know value for knob B of page SRC in Audio track 1 of bank 01 is recoded at 0x008ef0a and there's a checksum a the end of the file.

TODO

• polish script files
• automate safe setup procedure
• auto inject addresses and content to CSV or HTML file
• ...