Metadata-Version: 2.1
Name: skb
Version: 1.0.8.dev2
Summary: SKB - Synth Kit Builder for Synthstrom Deluge
Home-page: https://github.com/neilbaldwin/skb
Author: Neil Baldwin
Author-email: neil.baldwin@mac.com
License: MIT
Project-URL: Source Code, https://github.com/neilbaldwin/skb
Keywords: synthstrom,deluge,utility,synth,kit,builder
Platform: UNKNOWN
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Description-Content-Type: text/markdown
Requires-Dist: lxml (==4.6.2)

# SKB - Synth Kit Builder for Synthstrom Deluve

A Python utility for the Synthstrom Deluge, used for building KITS (drum kits) from existing SYNTH sounds.

## Motivation

Reasoning: whilst you can manually create a KIT using the synthesis engine and you can build a KIT by loadinging one or more samples into a KIT LANE, it's not possible, as of Firmware 3.1.5, to load SYNTH files into KIT LANES. I wrote this utility to enable you to do just that.

## Requirements

- Latest Deluge firmware. At time of first release this is 3.1.5
- The ability to mount your Deluge SD card in your computer and have read/write access
- Python 3 plus Pip tools to install Paython packages
- familiarity with Python command-line tools

## Installation or Getting Started

Provding you have Python 3 and the corresponding Pip installer tools it should be a case of just doing:

```Text
python3 -m pip install skb
```

## Usage

Example"

```Text
skb --sd-root '/Volumes/DELUGE32/' --input-file 'kitfile.xml' --output-file skb.XML
```

skb --sd-root 'path' --input-file 'path' --ouput-file 'path'

```Text
sd-root = full path to root of your mounted SD card e.g. /Volumes/DELUGE/

input-file = name of XML file which describes your KIT contents (see below)

output-file = name of the generated KIT file, including .XML extension
```

## XML Kit File

In order to tell the tool which SYNTH patches you want in your KIT, you need to create a basic XML file e.g.

The script will create the KIT in reverse order meaning the first synth in your XML will be the lowest row etc.

You can specify the same SYNTH more than once and theoretically there should be no (reasonable) limite to how many lanes you can generate.

It's probably worth pointing out that any editing or changes you make to the generated kit on the Deluge will not be reflected in the original SYNTH patches. That's probably a good thing though!

```XML
<?xml version='1.0' encoding='UTF-8'?>
<synthkit>
    <drum synth="KICK.XML" name="BIG KICK" />
    <drum synth="SNARE.XML" name="" />
    <drum synth="CLAP.XML" name="" />
</synthkit>
```

For each 'drum' node there are two attributes

```Text
synth = filename of the SYNTH patch you'd like to load into the KIT LANE

name = optional name to display in the KIT LANE, see below
```

If no 'name' is specified (i.e. "") then the script will create a name from the SYNTH filename.

NOTE:

The script assumes (correctly!) that you have a KITS and SYNTHS folder in the root of your Deluge SD card. It will look for the SYNTH patches in the SYNTHS folder and will output the KIT in the KITS folder.

## Contributors

Contributions welcome!

## License

MIT



