Skip to main content

The Casperaki JSON Format

At the heart of the low-level API is the Casperaki JSON format.

Typical Casperaki JSON structure​

A typical Casperaki JSON file is structured as follows:

{
  "song": {
    "title": "<Song title>",
    "key": "<Key>",
    "genre": "<Genre>",
    "tempo": <Beats per minute (BPM)>,
    "patterns": [],
    "songStructure": [],
    "arrangement": {}
  }
}

In the pages that follow, we will explore the Casperaki JSON format in greater detail.

Using Casperaki JSON files​

You can use a Casperaki JSON file to specify as many attributes of a song as desired, up to and including a complete production with specific instruments and transitions between song segments. This capability is particularly valuable if you aim to programmatically create tracks that meet specific criteria or develop your own Digital Audio Workstation (DAW) based on the Casperaki platform.

All Casperaki applications, including Casperaki Studio, are built on this low-level API. However, for many use cases, such granular control may not be necessary. In these instances, you can concentrate on the elements that are most important to you and leave the rest to the Casperaki engine.