qdts-v0.3

Requirements

• Max >= 8
• [Optional] pesto~ External available from https://github.com/QosmoInc/pesto_tilde

Note

pesto~ is only needed if you want to use the audio input feature of the max patch

---

Installation

MacOS

Recommended (Easy one-liner)

Open Terminal and paste the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cordutie/qdts/refs/heads/main/max/patches/install.sh)"

This will automatically detect your architecture, download the correct package, install it to your Max 9 Packages folder, and remove any security flags.

Manual Installation

1. Download the correct zip for your machine from the Assets section below:

   • qdts-v0.3-osx-arm64.zip — Apple Silicon
   • qdts-v0.3-osx-x86_64.zip — Intel

2. Extract the zip file.

3. Move the extracted qdts folder to your Max 8 or 9 Packages directory:

   ~/Documents/Max 8/Packages/     OR    ~/Documents/Max 9/Packages/
   

4. If macOS flags the externals as unverified, remove the security restriction by running the following in Terminal:

   xattr -dr com.apple.quarantine ~/Documents/Max\ 9/Packages/qdts

   Alternatively, follow Apple's official guide for opening software from an unknown developer:
   support.apple.com/guide/mac-help/mh40616

Windows

Manual Installation

1. Download the zip file from the Assets section below:
   • qdts-v0.3-win64.zip
2. Extract the zip file.
3. Move the extracted qdts folder to your Max 9 Packages directory:

   C:\Users\<YourUsername>\Documents\Max 9\Packages\
   

---

Example Patch

Once you finish the installation, run the following patch:

Max 9/Packages/qdts/patches/standalone/solver_nn/main_solver_nn.maxpat

Tip

Refer to here to access a quick guide on how to use the patch above.

qdts-v0.2

Requirements

• Max >= 8

---

Installation

MacOS

Recommended (Easy one-liner)

Open Terminal and paste the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cordutie/qdts/refs/heads/main/max/patches/install.sh)"

This will automatically detect your architecture, download the correct package, install it to your Max 9 Packages folder, and remove any security flags.

Manual Installation

1. Download the correct zip for your machine from the Assets section below:

   • qdts-v0.2-osx-arm64.zip — Apple Silicon (M1, M2, M3, M4)
   • qdts-v0.2-osx-x86_64.zip — Intel

2. Extract the zip file.

3. Move the extracted qdts folder to your Max 9 Packages directory:

   ~/Documents/Max 9/Packages/
   

4. If macOS flags the externals as unverified, remove the security restriction by running the following in Terminal:

   xattr -dr com.apple.quarantine ~/Documents/Max\ 9/Packages/qdts

   Alternatively, follow Apple's official guide for opening software from an unknown developer:
   support.apple.com/guide/mac-help/mh40616

Windows

Manual Installation

1. Download the zip file from the Assets section below:
   • qdts-v0.2-win64.zip
2. Extract the zip file.
3. Move the extracted qdts folder to your Max 9 Packages directory:

   C:\Users\<YourUsername>\Documents\Max 9\Packages\
   

---

Example Patch

Once you finish the installation, run the following patch:

Max 9/Packages/qdts/patches/solver_nn/main_solver_nn.maxpat

Tip

Refer to here to access a quick guide on how to use the patch above.

qdts-v0.1

qdts — Quadratic Distortion Tone Synthesis Package for Max

qdts is a package for Max that generates quadratic distortion tone spectra with controllable timbral characteristics.

---

Requirements

• Max 8 or 9
• Windows (x64) or macOS (arm64)

---

Overview

The package provides tools for generating quadratic distortion tone spectra programmatically and exploring variations in acoustic timbre.

It includes two solver implementations:

1️⃣ qdts.solver

A deterministic, numerical-method-based implementation for generating quadratic distortion tone spectra.

2️⃣ qdts.solver_nn

A shallow neural network–based implementation capable of loading pretrained models from TorchScript files included in the package.

The neural version ships with 10 distinct pretrained models.

Each model targets the same absent sound timbre while producing different acoustic timbral characteristics, enabling exploration of perceptual and spectral variation.

---

Included Components

• qdts.solver (numerical solver)
• qdts.solver_nn (neural network solver with TorchScript model loading)
• 10 pretrained TorchScript models
• Example patchers for:
  • Testing both solvers
  • Switching between models
  • Exploring different timbral outputs