# [EN] Antigone Documentation

# Welcome

**Welcome to the documentation of Antigone, the versatile Eurorack module designed and distributed by Nanopolis.**

[![antigone_front.jpg](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-02/scaled-1680-/antigone-front.jpg)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-02/antigone-front.jpg)

Antigone takes a hybrid approach that stands out from traditional Eurorack modules. It has been designed to suit both beginners discovering this world and experienced musicians seeking an expressive and powerful tool.

Its sonic identity is unique. Thanks to distinctive components and an innovative synthesis algorithm, Antigone delivers warmth and power usually reserved for analog synthesizers.

Find more information at:  
🔗 [nanopol.is](https://nanopol.is/)

Connect with the user community:

Enjoy your reading, and happy music-making!

# Module's description



# Front panel

### Front Panel Representation

###   
[![doc-layout.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/scaled-1680-/doc-layout.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/doc-layout.png)

<table border="1" id="bkmrk-boutons-1-4-les-bout" style="width: 100%; height: 645.517px;"><colgroup><col style="width: 15.3086%;"></col><col style="width: 84.5679%;"></col></colgroup><tbody><tr style="height: 154.719px;"><td style="height: 154.719px;"><span style="color: rgb(224, 62, 45);">**Buttons 1-4**</span></td><td style="height: 154.719px;">Buttons 1 to 4 are contextual to the current screen.  
  
**Short Click** : They allow you to switch tabs or pages on the current screen, or perform a specific action when a modal window is displayed.  
  
**Long Click** : Opens the parameter modulation assignment located above on the screen.

</td></tr><tr style="height: 80.1719px;"><td style="height: 80.1719px;">**<span style="color: rgb(45, 194, 107);">360° Rotary Potentiometers 1-4</span>**</td><td style="height: 80.1719px;">Potentiometers 1 to 4 are contextual to the parameters displayed on the screen. There are up to 4 parameters presented simultaneously on the screen, each potentiometer controls the parameter located above it on the screen.

</td></tr><tr style="height: 123.516px;"><td style="height: 123.516px;"><span style="color: rgb(53, 152, 219);">**Digital Encoder**</span></td><td style="height: 123.516px;">The encoder is contextual to the current screen. It allows you to navigate through menus, different instruments, or scroll through various wavetables or samples.

**Short Click**: Confirms a selection on the screen.

</td></tr><tr style="height: 147.344px;"><td style="height: 147.344px;"><span style="color: rgb(241, 196, 15);">**Exit / Alt Button**</span></td><td style="height: 147.344px;">**Short Click**: "EXIT" Button: Returns to the previous page.

  
**Long Click: "ALT" Button**: Accesses alternative functionalities, generally allows access to additional tabs in the modules.

  
**Long Click + Potentiometer 1-4**: Resets the parameter above the potentiometer to its default value.

**Short click + encoder click:** preview the current instrument; the note lasts as long as the encoder is held.

**Long click + turn encoder**: opens a shortcut menu.

</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"><span style="color: rgb(255, 0, 184);">**Audio Outputs 1-4**</span></td><td style="height: 46.5938px;">Audio outputs 1-4 are AC-Coupled, with a voltage range of -7.5V to 7.5V.</td></tr><tr style="height: 63.375px;"><td style="height: 63.375px;"><span style="color: rgb(132, 63, 161);">**CV Inputs A-F**</span></td><td style="height: 63.375px;">CV inputs A-F operate within a voltage range of -5V to 5V. These inputs can be used for pitch control (standard 1V/oct) or modulation. Assignments are made in the software.

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><span style="color: rgb(230, 126, 35);">**Gate Inputs 1-4**</span></td><td style="height: 29.7969px;">Gate inputs 1-4 operate within a voltage range of 0 to 40V. The trigger threshold is approximately 0.7V.</td></tr></tbody></table>

### Front Panel Representation of the expander  


[![antigone expander front.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/scaled-1680-/antigone-expander-front.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/antigone-expander-front.png)

<table border="1" id="bkmrk-entr%C3%A9es-cv-g-l-cv-in" style="border-collapse: collapse; width: 100%; height: 744.531px;"><colgroup><col style="width: 20.926%;"></col><col style="width: 79.1976%;"></col></colgroup><tbody><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**<span style="color: rgb(132, 63, 161);">Entrées CV G-L</span>**</td><td style="height: 80.1875px;">CV inputs G-L operate within a voltage range of -5V to 5V. These inputs can be used for pitch control (standard 1V/oct) or modulation. Assignments are made in the software.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;"><span style="color: rgb(230, 126, 35);">**Entrées Gate 5-6**</span></td><td style="height: 46.5938px;">Gate inputs 5-6 operate within a voltage range of 0 to 40V. The trigger threshold is approximately 0.7V.</td></tr><tr><td><span style="color: rgb(34, 198, 230);">**MIDI In**</span></td><td>Midi input is compatible with midi to jack 3.5 adapter (format TRS A or TRS B)</td></tr></tbody></table>

# Back of the module & connectors

### Representation of the back of the module

### [![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/scaled-1680-/image.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/image.png)  


<table border="1" id="bkmrk-power-standard-euror" style="border-collapse: collapse; width: 100%; height: 204.547px;"><colgroup><col style="width: 30.5556%;"></col><col style="width: 69.568%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;"><span style="color: rgb(224, 62, 45);">**Power**</span></td><td style="height: 29.7969px;">Standard eurorack power -12V / GND / +12V , Red stripe of the ribbon is on the left</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**<span style="color: rgb(230, 126, 35);">MicroUSB</span>**</td><td style="height: 29.7969px;">Micro USB socket, to connect to a computer, used to update the firmware</td></tr><tr style="height: 144.953px;"><td style="height: 144.953px;"><span style="color: rgb(10, 56, 255);">**Extension**</span></td><td style="height: 144.953px;">Extension port, used to plug the CV/Gate &amp; Midi extension

<p class="callout warning">Warning ! The ribbon cable must be plugged in the right direction. There is a "RED" inscription on the PCB which indicates where the red stripe of the ribbon should be.</p>

</td></tr></tbody></table>

### Representation of the back of the expander module

[![expander back.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/scaled-1680-/expander-back.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/expander-back.png)

<p class="callout warning">  
Warning ! The ribbon cable must be plugged in the right direction. There is a "RED" inscription on the PCB which indicates where the red stripe of the ribbon should be.</p>

# Screen navigation (todo)

# Understanding Antigone's architecture

## Introduction  


Antigone offers an architecture that may seem complex, but it is ultimately quite simple to understand if you take the time to explore it.

## The Projects

The concept of a project is very similar to the projects offered by Elektron machines (such as the Digitakt, …). The project is the foundation of everything within Antigone.

Projects can be compared to presets, patches, or programs found in some other modules or synthesizers.

Here is the general schematic of a sample project that we will refer to multiple times in this section of the documentation. Keep an eye on it as you read.

<div drawio-diagram="106"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2024-09/drawing-4-1725196981.png" alt=""/></div>

A project consists of 2 main sets organizing 3 major concepts:

- **The VOICES LAYOUT** which organizes **the INSTRUMENTS**
- **The GLOBAL** (or global parameters)

While the **VOICES LAYOUT** defines how the **INSTRUMENTS** of your project are distributed across all available voices, **GLOBAL** defines the common behavior of all **INSTRUMENTS** in a given project.

### The Concept of Voice: The Voices Layout

Before diving into how the **INSTRUMENTS** and **GLOBALs** work, let's take a moment to understand the concept of voices.

Antigone offers a maximum of **6 voices per project**. Voices are the circuits capable of emitting sound. Being able to use 6 voices means, for example, that it will be possible to create a 6-voice polyphonic instrument (capable of playing 6-note chords) or to create 6 monophonic instruments (each instrument can only play one note at a time), and all possible intermediate combinations (e.g., 2 instruments with 3 voices each, 3 instruments with 2 voices each, etc...)

In the above diagram, you can see an example of a project consisting of 3 instruments, each distributed with 3, 2, and 1 voice respectively.

### The Instruments

A project can contain from 1 to 6 instruments depending on how they are distributed across the 6 available voices (as defined by the VOICES LAYOUT)

An instrument is composed of 3 different components

<table border="1" id="bkmrk-composants-r%C3%B4le-en-s" style="border-collapse: collapse; width: 100%; height: 395.079px;"><colgroup><col style="width: 15.3276%;"></col><col style="width: 63.5201%;"></col><col style="width: 21.1523%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Components**</td><td style="height: 29.7969px;">**Role**</td><td style="height: 29.7969px;">**Learn More**</td></tr><tr style="height: 147.344px;"><td style="height: 147.344px;">a machine</td><td style="height: 147.344px;">an algorithm capable of generating sound using a specific sound synthesis.

At the time of writing this documentation, there are 4 different types of machines, each offering very different sounds, giving Antigone a wide range of sound palettes.

</td><td style="height: 147.344px;">*coming soon*</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">a controller</td><td style="height: 46.5938px;">whose parameters define how the instrument behaves when you control it</td><td style="height: 46.5938px;">*coming soon*</td></tr><tr style="height: 171.344px;"><td style="height: 171.344px;">4 modulators</td><td style="height: 171.344px;">capable of running in parallel, these modulators will allow you to complicate the behavior of their instrument over time.

<p class="callout info">Although common to an instrument, you will be able to define specific modulation parameters for each of its voices. This makes Antigone very, very powerful.</p>

</td><td style="height: 171.344px;">*coming soon*</td></tr></tbody></table>

### Global: The Global Parameters

The global parameters define the overall behavior of your project.

A global is composed of 5 different components

<table border="1" id="bkmrk-composants-r%C3%B4le-en-s-1" style="border-collapse: collapse; width: 100%; height: 135.984px;"><colgroup><col style="width: 15.3276%;"></col><col style="width: 63.5201%;"></col><col style="width: 21.1523%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Components**</td><td style="height: 29.7969px;">**Role**</td><td style="height: 29.7969px;">**Learn More**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">a mixer</td><td style="height: 29.7969px;">A mixing table defining the behavior of each instrument in the project at the audio level: volume, pan

</td><td style="height: 29.7969px;">*coming soon*</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">a scale quantizer</td><td style="height: 46.5938px;">This component confines the notes played within a defined scale and transposed pitch.

</td><td style="height: 46.5938px;">*coming soon*</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">a clock</td><td style="height: 29.7969px;">This module allows you to define the clock parameters used to synchronize the module's behaviors. This clock can be either internal or external to the module.</td><td style="height: 29.7969px;">*coming soon*</td></tr><tr><td>4 global modulators</td><td>Capable of running in parallel, these modulators will allow you to complicate the overall behavior of the project over time.

</td><td>*coming soon*</td></tr><tr><td>A modulation matrix</td><td>This component allows you to visualize the entirety of a project's modulations within a matrix.

</td><td>*coming soon*</td></tr></tbody></table>

## File Content by Type

Now that we know how the different components of a project in Antigone are organized, it is important to understand how these same concepts are structured as files on your SD card.

<div drawio-diagram="266"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-04/drawing-3-1745047226.png" alt=""/></div>

For the 3 concepts mentioned above (PROJECT, VOICES LAYOUT, and INSTRUMENT) there is a file type.

<table border="1" id="bkmrk-concepts-contenu-du-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 17.8222%;"></col><col style="width: 67.8391%;"></col><col style="width: 14.2151%;"></col></colgroup><tbody><tr><td>**Concepts**</td><td>**File Content**</td><td>**File Type**</td></tr><tr><td>Project</td><td>All the components that define it (the global parameters, the voice layout used, and the configuration of each instrument).

It is, therefore, complete and autonomous.

</td><td>.nagp</td></tr><tr><td>Instrument</td><td>A machine and its modulations.

<p class="callout info">You can use this file type to save a reusable instrument in another project.</p>

</td><td>.navp</td></tr></tbody></table>

# Quick start

### Introduction  
  


<span lang="EN-GB" style="mso-ansi-language: EN-GB;">You have just received the Antigone module, and I thank you for that. </span>Let's get straight to the point and ensure we play our first instrument.

<span style="color: rgb(185, 106, 217);">*<span lang="EN-GB" style="mso-ansi-language: EN-GB;">This documentation refers to firmware version 1.1.4 (if you do not have the correct firmware, I encourage you to update your module) : [How to update the firmware](https://doc.nanopol.is/books/en-antigone-documentation/page/how-to-update-the-firmware "How to update the firmware ?")</span>*</span>

## <span lang="EN-GB" style="mso-ansi-language: EN-GB;">The Init project</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">On first power-up, your module will start with the Init project.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-x75fl3yw.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">The concept of a project is quite similar to the projects offered by Elektron machines (such as the Digitakt, etc.). A project can encompass one or more instruments and define the playing characteristics for each of them: the number of voices used, the playing mode (Monophonic, Legato, Stereo), the type of control (MIDI, CV/Gate), and more.</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">By default, the Init project only uses one instrument (INST 1), assigned to a single voice of the module (which has 6 voices in total). The sound produced by this voice is routed to outputs 1 and 2 of the module. </span>

<span style="color: rgb(185, 106, 217);">*<span lang="EN-GB" style="mso-ansi-language: EN-GB;">All of this can be modified later, but for now, let's stick with this simple configuration.</span>*</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">By default, the control type is set to "CV/Gate," but if you also have the "MIDI/CV Expander," the default control type will be configured as MIDI.</span>

## <span lang="EN-GB" style="mso-ansi-language: EN-GB;">Connect an audio cable</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Now connect a cable to the "Out 1" output of your module and connect the other end to your mixer, amplifier, or audio interface. Do the same with a second cable on the "Out 2" output.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-pg3bg0qt.png)  
</span>

<span style="color: rgb(185, 106, 217);"><span lang="EN-GB" style="mso-ansi-language: EN-GB;"> </span>*<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Tip: You can play a note right away by pressing and holding the ALT button, and while holding ALT, pressing the encoder will play the C2 note of your project.</span>*</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-xpovo7wk.png)  
</span>

## <span lang="EN-GB" style="mso-ansi-language: EN-GB;">Connect a keyboard</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">In the global settings of your project, you define the control type you want for this project: You can choose between CV/Gate or MIDI\*.</span>

*<span lang="EN-GB" style="mso-ansi-language: EN-GB;">\*Note: MIDI will only be available if you have the expander.</span>*

<span style="font-size: 17.0pt; line-height: 107%; font-family: Montserrat; mso-fareast-font-family: 'Times New Roman'; mso-fareast-theme-font: major-fareast; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: major-bidi; color: gray; mso-themecolor: background1; mso-themeshade: 128;">Set the control type.</span>

<p class="callout warning"><span style="background-color: rgb(48, 23, 10); color: rgb(222, 138, 90);"><span lang="EN-GB" style="font-size: 11.0pt; line-height: 107%; font-family: 'Aptos',sans-serif; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: Aptos; mso-fareast-theme-font: minor-latin; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: Arial; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-GB; mso-fareast-language: EN-US; mso-bidi-language: AR-SA;">Important concept: For each project, you will be able to define the control type. It is crucial to understand that the control type is not set globally for your module, but rather within each individual project. Therefore, changing the control type of one project will not affect other projects on the SD card.</span></span></p>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">From the project's home screen, select instrument number 1, then click on the encoder.</span>

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/scaled-1680-/eyJimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/eyJimage.png)

Once you're in the instrument, turn the encoder all the way to the right to reach the last item, "CONTROL".

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/scaled-1680-/0A3image.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/0A3image.png)

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Once on "CONTROL", press the encoder. You'll arrive at the "Instrument Control" screen.</span><span style="mso-no-proof: yes;"></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-53lajxcp.png)</span><span lang="EN-GB" style="mso-ansi-language: EN-GB;"> </span>

Select the type of control you want by turning the first potentiometer located directly below the "Control" parameter.

You can also change the mode by turning the second potentiometer.

### CV/Gate

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">In CV/Gate control mode, you can use a compatible keyboard or controller.</span>

<span style="mso-no-proof: yes;">[![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/5xRscreenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/5xRscreenshot-004.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Connect a cable to the "Gate 1" input of the module, and the other end to the "Gate" output of your keyboard.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Connect another cable to the "CV IN A" input of the module, and the other end to the "CV" (or Control Voltage, or Pitch, etc.) output of your keyboard.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-s17gyz8o.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">You should now be able to play and hear the sound being sent to outputs 1 and 2.<span style="mso-spacerun: yes;"> </span></span>

### Midi

<span style="mso-ansi-language: EN-GB;"><span style="mso-spacerun: yes;"> </span><span lang="EN-GB" style="mso-no-proof: yes;">If you choose the MIDI protocol, you will need to have the MIDICVExpander.</span></span>

<table border="1" id="bkmrk-%C2%A0-you-can-connect-a-" style="border-collapse: collapse; width: 100%; height: 699.906px;"><colgroup><col style="width: 81.333%;"></col><col style="width: 18.667%;"></col></colgroup><tbody><tr style="height: 699.906px;"><td style="height: 699.906px;">[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/ZA2screenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/ZA2screenshot-002.png)

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">You can connect a TRS Type A or B cable to the designated input on the expander and connect the other end to the MIDI OUT of your MIDI-compatible keyboard.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-b84tj19r.png)From the MIDI tab, accessible by pressing button 2 on this screen, you will have the option to set the MIDI channel and the Pitch Bend range.</span>

</td><td style="height: 699.906px;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-sozhcnjy.png)

 MIDICV Expander

</td></tr></tbody></table>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">The channel MIDI 1 is always used by default.</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">From the MIDI tab, accessible by pressing button 2 on this screen, you will have the option to change it.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-h9hj9hpx.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;"> </span>

## Save your project

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Save your project.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">You can return to the original screen by pressing the ALT button multiple times, which activates the "back" function.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-7ssievu1.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Once on this screen, access the "burger" menu in the top left corner of your screen by turning the encoder to the left.</span>

<span style="mso-no-proof: yes;"></span>![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-p5mk5t4n.png)

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Then, click the encoder to open the selection menu.</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-znrv5nx7.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Turn the encoder to make your selection:<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">- Save project: Replaces the current project on the SD card.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">- Save project as..: Saves the current project as a new project on the SD card.</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;"> </span>

### <span lang="EN-GB" style="mso-ansi-language: EN-GB;">Name your file</span>

<span style="mso-no-proof: yes;">![](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/embedded-image-vexdf9qm.png)  
</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Select the character to modify using buttons 1 and 2.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Choose the symbol by turning the encoder.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Clicking the encoder confirms the character and moves the cursor to the right.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Button 3 allows you to erase everything.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">Button 4 confirms the save.<span style="mso-spacerun: yes;"> </span></span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;">The ALT button cancels the save.</span>

<span lang="EN-GB" style="mso-ansi-language: EN-GB;"> </span>

# The projects



# How projects works ?

In the "[Understanding Antigone's Architecture](https://doc.nanopol.is/books/en-antigone-documentation/page/understanding-antigones-architecture "Understand Antigone's architecture")" section, we covered the topic of project structure. In this section, we'll see how to use projects.

As you’ve understood, in Antigone, the project is the container that holds all the Antigone modules. You can save and load as many projects as you want on the SD card.

### Main Project Screen:

[![screenshot_019.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/KjYscreenshot-019.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/KjYscreenshot-019.png)

The project screen is the first screen displayed when the module is powered on. It provides an overview of the instruments and their voices. On this screen, you can create a new project, save it, load an existing one, and access all of Antigone’s functionalities.

### INSTR Tab

#####   
Representation of Instruments and Voices

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/FQBimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/FQBimage.png)

These numbers from 1 to 6 represent the 6 voices of Antigone. In the example configuration above, we can see 3 groups of voices representing 3 instruments:

- A first instrument with 3 polyphonic voices (voices 1-2-3). The highlighted square on main voice 1 indicates a machine is loaded in this instrument. A brighter border also surrounds this instrument, indicating it is currently selected. (You can change this selection by turning the encoder left or right)
- A second instrument with 2 polyphonic voices (voices 4-5). The highlighted square on main voice 4 shows that a machine is loaded in this instrument.
- The third instrument has no machine loaded, and is therefore not usable.

Each time a note is played on a voice, a highlighted square is also displayed.

<p class="callout info">This voice configuration is what we call the "VOICE LAYOUT" in Antigone. A full section on configuring this layout is available in this documentation.</p>

This voice representation is always visible in the screen header: [![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/kgTimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/kgTimage.png) and always lets you know which instrument you're currently editing. The voices also light up when a note is played.

##### Instrument Name and Icon

<table border="1" id="bkmrk-en-dessous-du-voice-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/FiKimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/FiKimage.png)  
</td><td>Below the voice layout, you’ll see the name of the selected instrument. Here, it's labeled "INST 1" by default. If a preset exists, its name will be used instead.</td></tr><tr><td>[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/eV5image.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/eV5image.png)  
</td><td>And to the right of the voice layout, there is the icon representing the machine loaded into the instrument.</td></tr></tbody></table>

##### Instrument Volume

A volume parameter for the selected instrument is directly accessible from this page and can be adjusted using the potentiometer below (4). This same parameter is also available in the "[MIXER](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer "Mixer")"

#### Accessing an Instrument’s Parameters  


To access the selected instrument, simply press the encoder. You’ll then enter the configuration screen of an "[INSTRUMENT](https://doc.nanopol.is/books/en-antigone-documentation/page/how-instruments-work "Instrument Functionality")".

### GLOBAL Tab

[![screenshot_022.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/9zDscreenshot-022.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/9zDscreenshot-022.png)

  
The second tab, "Global", gives access to all global modules, including:

- [MACROS](https://doc.nanopol.is/books/en-antigone-documentation/page/macros "Macros")
- [MIXER](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer "Mixer")
- [GLOBAL MODULATIONS](https://doc.nanopol.is/books/en-antigone-documentation/page/global-modulation "Global Modulations")
- [SCALE QUANTIZER](https://doc.nanopol.is/books/en-antigone-documentation/page/scale-quantizer "Scale Quantizer")
- [MODULATION MATRIX](https://doc.nanopol.is/books/en-antigone-documentation/page/modulation-matrix "Modulation Matrix")
- [CLOCK](https://doc.nanopol.is/books/en-antigone-documentation/page/clock-internal-external "Internal & External Clock") (internal/external clock)

### PROJECTS Tab

[![screenshot_023.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-023.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-023.png)This tab allows you to quickly browse through saved projects in the current directory. Turn the encoder left or right to directly load the next or previous project.

### Burger Menu

Located in the top-left corner, the burger menu becomes accessible when highlighted (turn the encoder fully to the left to select it)

From the burger menu, you’ll be able to:

- PROJECT (For more details about files and templates, visit the page: "[FILES &amp; TEMPLATES](https://doc.nanopol.is/books/en-antigone-documentation/page/files-templates-todo "Files and Templates (todo)")") 
    - PROJECT BROWSER (Access the project explorer on the SD card)
    - SAVE PROJECT (Save the current project)
    - SAVE PROJECT AS... (Save the project under a new name)
    - NEW PROJECT (Opens a submenu with project templates stored on the SD card)
- VOICE LAYOUT (For more details, visit the page: "[VOICE LAYOUT](https://doc.nanopol.is/books/en-antigone-documentation/page/voice-layout "Voice Layout (todo)")") 
    - LAYOUT BROWSER (Access the layout explorer on the SD card)
    - SAVE LAYOUT (Save the current voice layout)
    - SAVE PROJECT AS... (Save the voice layout under a new name)
    - NEW LAYOUT (Opens a submenu with layout templates stored on the SD card)
- SETTINGS 
    - CALIBRATION (For more information, visit the page "[CALIBRATION](https://doc.nanopol.is/books/en-antigone-documentation/page/calibration "Calibration")")
- SYSTEM INFO (For more information, visit the page "[SYSTEM INFO](https://doc.nanopol.is/books/en-antigone-documentation/page/system-info "System Info")")

# Files & templates (todo)



# Voice layout

### How the Voice Layout Works

On the page "[How Projects Work](https://doc.nanopol.is/books/en-antigone-documentation/page/how-projects-works "Project Operation")" we saw how voice allocation is represented for each instrument. Antigone has a total of 6 voices, distributed among the 6 instruments. The combination of all instruments will always total 6 voices or less.  
  
Voice configuration is done on the main "PROJECT" screen. If you want to change the number of voices allocated to an instrument, it's very simple:

- Turn the encoder to highlight the instrument you want to edit, as shown in the example below.

[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/scaled-1680-/screenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/screenshot-002.png)

- Hold down the encoder until the selection starts blinking. From that moment on, you can turn the encoder to the right to add voices or to the left to remove them. Let's add a voice, as shown on the following screen:

  
[![commit voice.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/scaled-1680-/commit-voice.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-04/commit-voice.png)

- Press button 4 "COMMIT" to validate the new Voice Layout. Instrument number 1 now has 4 voices!
- Press button 3 "UNDO" if you want to cancel the changes and revert to the current voice layout.

# System info

[![screenshot_011.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-011.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-011.png)

The system information page provides an overview of the project's memory usage as well as the firmware version.

<table border="1" id="bkmrk-used-sys-memory-this" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 26.3581%;"></col><col style="width: 73.7655%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Used Sys Memory</td><td style="height: 29.7969px;">This is the memory occupied by the system. This memory space is managed automatically and cannot be modified. This allocation represents approximately 4 MB of memory.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Used Wave Memory</td><td style="height: 29.7969px;">This memory is used for loading samples and wavetables. This allocation represents approximately 12 MB of memory.  
If memory usage approaches 100%, you may no longer be able to load additional samples or wavetables. (A warning message will be displayed when loading in this case.)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Firmware version</td><td style="height: 29.7969px;">Indicates the firmware version currently installed on the Antigone.</td></tr></tbody></table>

### How to access system information?

From the "PROJECT" page (main screen), tap the burger menu located at the top left, then scroll down to "SYSTEM INFO" and select this option.  
  
The page may take several seconds to load while calculating memory usage.

[![sys_info.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/sys-info.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/sys-info.png)

# The instruments



# How instruments work ?

In Antigone, an instrument consists of multiple modules that can work together.

- 1 slot that can host a machine of your choice, acting as the sound generator (usually composed of one or more oscillators, filters, and effects). See the "[MACHINES](https://doc.nanopol.is/books/en-antigone-documentation/chapter/synthesis-machines "Machines")" section for more details.
- 4 slots that can host modulators of your choice (envelopes, LFO, S&amp;H, shape sequencer), which can be triggered when a note is played on this instrument. See the "[MODULATORS](https://doc.nanopol.is/books/en-antigone-documentation/chapter/modulators "Modulators")" section for more details.
- A voice controller that determines how the instrument is triggered and controlled (MIDI, CV/Gate). See the "[Voice Control](https://doc.nanopol.is/books/en-antigone-documentation/page/voice-control-instrument-control "Voice Controllers (Instrument control)")" section for more details.

An instrument in Antigone can have between 1 and 6 voices of polyphony. The allocation of the number of voices for an instrument is done in the "[PROJECT](https://doc.nanopol.is/books/en-antigone-documentation/page/how-projects-works "Project Functionality (todo)")" section. The configuration of the voice control mode (mono, legato, unison, poly, etc.) is done in "[INSTRUMENT/VOICE CONTROL](https://doc.nanopol.is/books/en-antigone-documentation/page/voice-control-instrument-control "Voice Controllers (Instrument control)")".  
  
The maximum number of polyphony voices depends on the available resources of Antigone. The more active elements there are (oscillators, filters, modulators), the more polyphony will be limited.

<p class="callout info">An instrument can also be used as a simple oscillator, without filters, effects, or modulators. This is one of Antigone's strengths: a highly flexible architecture, seamlessly integrable into a modular environment, covering a wide range of uses.  
</p>


All parameters of an instrument (excluding the controller) can be saved on the SD card as a preset or template for later reuse. See the "[FILES AND TEMPLATES](https://doc.nanopol.is/books/en-antigone-documentation/page/file-templates-todo "Files & Templates (todo)")" section.

#### Instrument Positioning Diagram in the Chain

<div drawio-diagram="221"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741900010.png" alt=""/></div>

#### Main Instrument Screen

[![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/AcJscreenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/AcJscreenshot-004.png)

On the main screen, you can see 4 slots (out of 5 available). The "machine" is always in the first slot, while the modulators are in the following slots. To scroll through the slot selection, turn the encoder to the right.  
  
At the top, "INST2/V4" means that we are configuring Instrument 2, with Voice 4 as its master voice.  
  
The buttons 3 "&lt; INSTR 1" and 4 "INSTR 3 &gt;" on Antigone allow you to quickly switch from one instrument to another without returning to the project page.

### How to Access an Instrument?

From the "PROJECT" page (the module's main page), you can select the instrument you want to access using the encoder. See the "[PROJECT](https://doc.nanopol.is/books/en-antigone-documentation/page/how-projects-works "Project Functionality (todo)")" section for more details.

### Slot Management

#### Adding a Machine or Modulator to a Slot

[![screenshot_005.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/ZSKscreenshot-005.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/ZSKscreenshot-005.png)

To add a machine or modulator, select an empty slot by turning the encoder left or right, then click the encoder or press the "ADD" button.

This will open a list of available modulators that you can assign to this slot.

[![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/0uDscreenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/0uDscreenshot-004.png)

Confirm your selection by clicking the encoder.

#### Replacing a Machine or Modulator

If a slot already contains a machine or a modulator, you can replace it by selecting the "REPLACE" option. This allows you to quickly change the type of modulator assigned to that slot.

[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/A4vscreenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/A4vscreenshot-002.png)

#### Navigating Between Slots

The encoder allows you to navigate between different slots. A simple click on an occupied slot gives access to the parameters of the modulator it contains.

### Burger Menu

The burger menu, located at the top right of the screen, can be accessed by turning the encoder all the way to the left. When the menu is highlighted, click the encoder to access the next menu:

[![burger.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/burger.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/burger.png)

I invite you to check the "[FILES AND TEMPLATES](https://doc.nanopol.is/books/en-antigone-documentation/page/file-templates-todo "Files & Templates (todo)")" section for more information on loading and saving instruments.

# File & Templates (todo)



# Voice control (Instrument control)

### Functionality

The "Instrument Control" section manages how instrument voices are controlled. Each instrument can have between 1 and 6 voices, set in a fixed manner (the number of allocated voices is defined from the project’s main page).

Antigone allows instrument control either through CV/Gate inputs or via MIDI if the MIDI expander is connected.

Each instrument can be configured to operate in one of the following modes: Mono, Legato, Unison, Unison Legato, or Polyphonic.

<p class="callout info">**Note:** Instrument control parameters are not saved within instrument presets.  
  
Since voice allocation is fixed to ensure usability and predictability in a modular environment, these settings are stored at the project level.</p>

### Accessing the voice controller

[ ![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-001.png)  
From the "PROJECT" main screen, select an instrument by clicking the encoder, then navigate to the "CONTROL" module on the far right. Click again to enter the "INSTR. CONTROL" screen.

### Configuration Page

##### [ ![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/HGGscreenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/HGGscreenshot-002.png)

<table border="1" id="bkmrk-name-function-control" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 50%;"></col> <col style="width: 50%;"></col> </colgroup><thead><tr><td>**Name**</td><td>**Function**</td></tr></thead><tbody><tr><td>**Control**</td><td>Defines how the instrument is controlled:  
- **Off**: Disabled
- **CV/Gate**: Controlled via the CV/Gate inputs of Antigone and its expander
- **MIDI**: Controlled via the MIDI input of the expander

</td></tr><tr><td>**Mode**</td><td>The mode depends on the number of voices in the instrument.  
- **Mono**: Monophonic
- **Legato**: Monophonic with legato (the envelope is not retriggered when changing notes)

For instruments with multiple voices: - **Unison**: Plays the same note across all voices
- **Unison Legato**: Unison mode with legato
- **Poly**: Polyphonic mode

</td></tr><tr><td>**Spread &amp; Drift**   
(available for instruments with 2 or more voices)</td><td>**Spread**: In Unison mode, this parameter controls the amount of detuning between voices.  
**Drift**: In Poly mode, this simulates analog-style detuning between voices, adding warmth and character to the sound.</td></tr><tr><td>**Glide**</td><td>Enables a portamento effect (smooth pitch transition between notes). When set to 0.0%, this effect is completely disabled.</td></tr></tbody></table>

### Configuring an Instrument in MIDI

To control an instrument via MIDI, first set the "Control" parameter to "MIDI".

Then, go to the "MIDI" tab to select the MIDI channel used to control this instrument. A single MIDI channel can be used to control multiple instruments simultaneously.

The "Pitchbend" parameter defines the maximum pitch bend range in semitones.

[ ![screenshot_006.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-006.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-006.png)

### Configuring an Instrument in CV/Gate

To control an instrument via CV/Gate, set the "Control" parameter to "CV/Gate".

From the "CV" tab, choose which CV inputs (on the main module or the expander) will control the instrument’s pitch.

<p class="callout info">**Reminder:** Antigone’s CV inputs are calibrated for the standard 1V/octave.</p>

The following example shows a polyphonic instrument with 3 voices, controlled by CV inputs A, B, and C.  
CV inputs A-F belong to the main module, while inputs G-L belong to the expander.  
[ ![screenshot_007.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-007.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-007.png)

To configure which GATE inputs trigger envelopes (and other events) for each voice, go to the "GATE" tab and select the desired GATE inputs.  
GATE inputs 1-4 belong to the main module, while inputs 5 and 6 belong to the expander.

[ ![screenshot_008.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-008.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-008.png)

# Synthesis Machines

There are 4 different Machines available in Antigone: Algorithmic Synth, Wavetable Synth, Sample Player and Crossmod.

# Algorithmic Synth

## General information  


This Machine features 2 identical oscillators with 16 different algorithms to choose from. Each oscillator can be tuned, transposed and have its own algorithm (model).

<div drawio-diagram="180"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741437619.png" alt=""/></div>

  
The oscillators go into a [<span style="text-decoration: underline;">**Filter section**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/filter-section), then a Drive section and finally an [**<span style="text-decoration: underline;">Amp section</span>**](https://doc.nanopol.is/books/en-antigone-documentation/page/amp-section) before going to the[ <span style="text-decoration: underline;">**Mixer**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer).

#### Main screen of the algorithmic synth  
  
[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/uDxscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/uDxscreenshot-001.png)

  
When opening the Algorithmic Synth Machine you will land on page 1 of tab 1. Use the first 2 tabs to configure oscillator 1 and 2 respectively. Use Tab 3 to configure the Filter section and Tab 4 to configure the Amp section.

The oscillator tabs (Tab 1 and Tab 2) will have a number of pages containing different controls depending on the selected model. When a Tab header displays small bar icons, click its corresponding button underneath to jump between its pages.  
  
When you adjust a parameter on one the pages, a wave display is briefly shown to reflect the changes on the output wave. Click Button 4 while the wave display is shown to lock it on. Click Button 4 again to unlock the display.

The first page of an oscillator tab is always the same:

<table border="1" id="bkmrk-model-frequency-tran" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.964%;"></col><col style="width: 24.964%;"></col><col style="width: 24.964%;"></col><col style="width: 24.964%;"></col></colgroup><tbody><tr><td>**Model**  
</td><td>**Frequency**  
</td><td>**Transpose**  
</td><td>**Volume**  
</td></tr><tr><td>Select the synthesis type used in the oscillator  
</td><td>Fine-tune the oscillator. This can be used to achieve beating-effects by having th two oscillators slightly out of tune with each other  
</td><td>Tune the oscillator by one semitone increments. This can be used to have the Machine play a paraphonic interval, or use one oscillator as a sub  
</td><td>Adjust the volume at which the oscillator is sent down the signal path (to the Filter section, or directly the the Amp section if all filters are turned off). 100% is unity gain, but it can go up to 200% if you can to overdrive the Filters, Amps or even the final DAC.</td></tr></tbody></table>

### Saw model  


[![screenshot_012.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-012.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-012.png)

A saw wave with Virtual sync capabilities.  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Sync**  
</td><td>**PhaseMod**  
</td><td> </td><td> </td></tr><tr><td>Above 0%, the saw wave is synced to a master oscillator. This adjusts the frequency of the slave oscillator you're hearing. Modulate for classic sync sounds</td><td>Above 0%, the saw wave's phase is modulated by another oscillator tuned at 0.75 times the frequency of the Saw. Increasing the parameter augments the modulation depth  
</td><td> </td><td> </td></tr></tbody></table>

### SuperSaw model

[![screenshot_013.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-013.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-013.png)

A swarm of detuned saw waves.  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-density-spread-fade-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Density**  
</td><td>**Spread**  
</td><td>**Fade**  
</td><td> </td></tr><tr><td>Choose the number of saw waves in the swarm, up to 12  
</td><td>Adjust the amount of detuning between the waves  
</td><td>Apply a volume fade on the most detuned saw waves to make the output less chaotic  
</td><td> </td></tr></tbody></table>

### Square model

[![screenshot_014.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-014.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-014.png)

A Square wave with PWM capabilities.  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-simple%3C%3Edual-pw-----" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Simple&lt;&gt;Dual**  
</td><td>**PW**  
</td><td>**-**</td><td>**-**</td></tr><tr><td>Add harmonics by dividing the positive part of the pulse in three pulse segments  
</td><td>Adjust the pulse-width of the output wave. Modulate for classic PWM sounds  
</td><td>**-**</td><td>**-**</td></tr></tbody></table>

### Fold1 model

[![screenshot_015.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/upcscreenshot-015.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/upcscreenshot-015.png)

A sine wave is folded using the Chebyshev method  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-fold-decimator-----i" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Fold**  
</td><td>**Decimator**  
</td><td> </td><td> </td></tr><tr><td>Increase the number of folds in the wave to add harmonics.  
</td><td>Reduces the bit rate to add harmonics  
</td><td> </td><td> </td></tr></tbody></table>

### Fold2 model

[![screenshot_017.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-017.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-017.png)

Two different out-of-phase waves are folded using the sinusoidal fold method  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-fold-sine%3C%3Etriangle-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Fold**  
</td><td>**Sine&lt;&gt;Triangle**  
</td><td>**Transform**  
</td><td>**Decimator**  
</td></tr><tr><td>Increase the number of folds in the wave to add harmonics.</td><td>Crossfade between a sine and a triangle wave, which are out-of-phase with each other  
</td><td>Adjust the phase of the sine and skew the triangle  
</td><td>Reduces the bit rate to add harmonics</td></tr></tbody></table>

### FM1 to FM8 model

4-Ops FM algorithms (TZFM, Linear &amp; Exponential modes)  
  
You will find a diagram of the different FM algorithms at the end of this section.  
  
Each algorithm has its own configuration, but it shares some common features :

- There is always 2 outputs from different operators (A/B), you can mix these 2 outputs
- All operators are sine oscillators, but the operator 1 has a phase distortion to twist the sine, this allows you to add more harmonics / harshness to the sound
- Each algorithm has 4 different modulation mode : TZFM Linear 1, TZFM Linear 2, Linear, Exponential.
- You can adjust the ratio / depth of each operator
- There is no integrated enveloppes on operators, but you can modulate every parameters with internal or external enveloppes (or other modulations)

The oscillator tabs have 4 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-depth-op1-ratio-op1-" style="border-collapse: collapse; width: 100%; height: 59.2666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**OP4: Ratio**  
</td><td style="height: 29.6333px;">**OP3: Ratio**  
</td><td style="height: 29.6333px;">**OP2: Ratio**</td><td style="height: 29.6333px;">**OP1: Ratio**</td></tr><tr style="height: 29.6333px;"><td style="height: 29.6333px;">Adjust Operator 4 frequency, in multiples of the Carrier frequency  
</td><td style="height: 29.6333px;">Adjust Operator 3 frequency, in multiples of the Carrier frequency</td><td style="height: 29.6333px;">Adjust Operator 2 frequency, in multiples of the Carrier frequency  
</td><td style="height: 29.6333px;">Adjust Operator 1 frequency, in multiples of the Carrier frequency</td></tr></tbody></table>

<p class="callout info">Ratio parameters are stepped by 0.25 by default for more ease of use, but this can be free'd : Hold the button below the ratio parameter of the desired operator, then go to "SETTINGS" tab, then put "Stepped" parameter to off.</p>

Page 3:

<table border="1" id="bkmrk-op4-%3A-depth-op3-%3A-de" style="border-collapse: collapse; width: 100%; height: 92.1875px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 28.7969px;"><td style="height: 28.7969px;">**OP4 : Depth**</td><td style="height: 28.7969px;">**OP3 : Depth**</td><td style="height: 28.7969px;">**OP2 : Depth**</td><td style="height: 28.7969px;">**OP1 : Ph.Dis**</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">Amount at which Operator 4 modulates the target operator(s)  
</td><td style="height: 63.3906px;">Amount at which Operator 3 modulates the target operator(s)  
</td><td style="height: 63.3906px;">Amount at which Operator 2 modulates the target operator(s)  
</td><td style="height: 63.3906px;">Amount of Phase distortion applied on the Sine.

</td></tr></tbody></table>

Page 4:

<table border="1" id="bkmrk-offset-op1-offset-op" style="border-collapse: collapse; width: 100%; height: 109.984px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Mix B&lt;&gt;A**</td><td style="height: 29.7969px;">**OP3 : Mode**</td><td style="height: 29.7969px;">**OP2 : Mode**  
</td><td style="height: 29.7969px;">**OP1 : Mode**  
</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">Mix between the outputs from 2 different operators, by default, it's 50% / 50%  
</td><td style="height: 80.1875px;">It's how this operator is modulated, TZFM Linear 1, TZFM Linear 2, Linear or Exponential</td><td style="height: 80.1875px;">It's how this operator is modulated, TZFM Linear 1, TZFM Linear 2, Linear or Exponential</td><td style="height: 80.1875px;">It's how this operator is modulated, TZFM Linear 1, TZFM Linear 2, Linear or Exponential  
</td></tr></tbody></table>

#### FM1 diagram

[![FM1.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm1.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm1.png)

#### FM2 diagram

[![FM2.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/OD7fm2.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/OD7fm2.png)

#### FM3 diagram

[![FM3.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm3.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm3.png)

#### FM4 diagram

[![FM4.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm4.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm4.png)

#### FM5 diagram

[![FM5.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm5.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm5.png)

#### FM6 diagram

[![FM6.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm6.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm6.png)

#### FM7 diagram

[![FM7.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/8tCfm7.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/8tCfm7.png)

#### FM8 diagram

[![FM8.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/fm8.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/fm8.png)

### Ringmod model

[![screenshot_019.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-019.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-019.png)

Two Ring Modulation algorithms where one oscillator's frequency is a multiple of the other one.  
Algorithm A is a Saturated Ring Modulation and algorithm B is more like a Diode-Based Ring Modulation.  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
Page 2:

<table border="1" id="bkmrk-ratio-strength-twist" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Ratio**  
</td><td>**Strength**  
</td><td>**Twist**  
</td><td>**Timbre**  
</td></tr><tr><td>Select the modulator frequency, being a multiple of the carrier frequency.  
</td><td>Non-linear gain of both the carrier and modulator signals  
</td><td>Distort the phase of the modulator oscillator  
</td><td>Morph from algorithm A to algorithm B  
</td></tr></tbody></table>

### CZ model

[![screenshot_020.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-020.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-020.png)

A phase modulation and wave windowing algorithm inspired by the Casio CZ series.  
The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.  
  
8 waveforms are availables, and can be combined (Saw, Square, Pulse, Double Sin, Saw Pulse, Reso1, Reso2, Reso3)  
  
Page 2:

<table border="1" id="bkmrk-wave-dcw-wave-dcw-se" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Wave**  
</td><td>**DCW**  
</td><td>**Wave**  
</td><td>**DCW**  
</td></tr><tr><td>Select a target wave. If the second Wave parameter is not OFF, then this one will select a target wave for every odd cycle of the main sine.</td><td>Simulates a filter sweep by using a different phase modulation on each wave (combined with windowing on the Reso1, 2 and3 waves). At 0% only the main sine is heard, and at 100% only the target wave is heard.  
</td><td>Select a target wave for every even cycle of the main sine.  
</td><td>Simulates a filter sweep by using a different phase modulation on each wave (combined with windowing on the Reso1, 2 and3 waves). At 0% only the main sine is heard, and at 100% only the target wave is heard.</td></tr></tbody></table>

### Noise model

[![Noise.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/noise.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/noise.png)

A filtered noise with sample &amp; hold.

The oscillator tabs have 2 pages. Page 1 is the same as mentioned earlier.

Page 2:

<table border="1" id="bkmrk-s%26h-color-%C2%A0-%C2%A0-the-am" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**S&amp;H**</td><td>**Color**  
</td><td> </td><td> </td></tr><tr><td>The amout of time to hold the current sample.</td><td>To the left : cutoff from 0 to 100% Low pass filter.  
  
To the right : cutoff from 0 to 100% High pass filter</td><td>  
</td><td> </td></tr></tbody></table>

# Wavetable Synth

## General information  


This Machine features a wavetable oscillator with additional wave transformation capabilities, a sub oscillator and noise generator.

<div drawio-diagram="193"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741724597.png" alt=""/></div>

  
The oscillator, Sub and Noise go into a [<span style="text-decoration: underline;">**Filter section**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/filter-section), then a Drive section and finally an [**Amp section**](https://doc.nanopol.is/books/en-antigone-documentation/page/amp-section) before going to the[ **Mixer**](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer). Go to the respective sections of the manual for more information on the Filter and Amp Sections.

#### Main screen of the wavetable synth

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/6ePscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/6ePscreenshot-001.png)

When opening the Wavetable Synth Machine you will land on page 1 of tab 1. Use the first 2 tabs to configure the wavetable oscillator and the sub oscillator + noise generator.  
Use Tab 3 to configure the Filter section and Tab 4 to configure the Amp section.

The wavetable oscillator tab (Tab 1) has 3 pages containing different controls. When a Tab header displays small bar icons, click its corresponding button underneath to jump between its pages.

On any Tab in the Wavetable Synth Machine, the encoder is used to select wavetables in the current folder. Click the encoder, then "Load wavetable" to load other wavetable folders.

  
[![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/Y4Bscreenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/Y4Bscreenshot-004.png)  
When turning the encoder (or the Position knob), a dedicated display will pop-up, showing the name of the wavetable, the position you're in, the number of waves in the wavetable and a wave display. This screen will stick for a couple of seconds, but you can lock it if you press button 4, labeled "Lock". Use knobs 2 and 3 to adjust the X and Y axis of the wave display to your liking.

You can see on this screen that there are 8 waves in total in the wavetable. The *position* parameter can therefore range from 1 to 8. Intermediate (non-integer) values are interpolated between the previous and next waves when the oscillator is in "MORPH" mode.

#### Wavetable Oscillator tab

There are 65 factory wavetables, licensed with Galbanum ([https://www.galbanum.com/)](https://www.galbanum.com/) derived from their "Architecture Waveform 2010" library. These wavetables are 16-bits, 2048 samples per wave (in the ANTIGONE\_2048 folder or 256 samples per wave in ANTIGONE\_256 folder)

<p class="callout info">Note that using 2048 samples wavetables are more CPU intensive than 256 sample wavetables. The sonic differences are negligible especially with the antialiasing enabled (Quality parameter)</p>

680 free to use wavetables from WaveEdit Online [https://waveeditonline.com/](https://waveeditonline.com/) (released under the CC0 1.0 Universal Public Domain Dedication) are pre-loaded on the SD Card.   
  
You can also load custom wavetables using the SD card, you are only limited by the size of the SD Card. The oscillator will read 32/24/16 bits wavetables but play them in 16-bits. It will function with 2048, 1024, 512, 256 and 128 samples wavetables.

<p class="callout warning">User wavetables have to be put in folders, anywhere on the SD card. You can't mix different sample formats within a folder, and the folder name has to end with "\_XXX", with XXX being the sample format of the waves in the folder. For example "MyCustomWavetables\_1024" if the wavetables are in the 1024 samples-per-wave format.  
</p>

  
The excellent wavetable editor from Synthesis Technology can be used to edit all these 256 samples wavetables: [https://synthtech.com/waveedit/](https://synthtech.com/waveedit/)  
  
The wavetable oscillator tab has 3 pages.

Page 1:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Position**</td><td>**Frequency**</td><td>**Transpose**  
</td><td>**Volume**  
</td></tr><tr><td>Navigate the wavetable.

Modulate for classic wavetable morph sounds.

</td><td>Fine-tune the oscillator. This can also be used to detune the oscillator from the sub oscillator for chorusing or dissonance effects</td><td>Tune the oscillator in semitone increments</td><td>Set the amplitude at which the oscillator is sent into the Filter Section. 100% is unity gain, beyond that the output is amplified, useful for driving the Filter or Amp sections or even overdriving the final DAC.</td></tr></tbody></table>

  
Page 2:

When you adjust a parameter on page 2, a wave display is briefly shown to reflect the changes on the output wave. Click Button 4 while the wave display is shown to lock it on. Click Button 4 again to unlock the display.

[![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/eBZscreenshot-003.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/eBZscreenshot-003.png)

<table border="1" id="bkmrk-width-phase-transfor" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Width**</td><td>**Phase**</td><td>**Transform**  
</td><td>**Depth**  
</td></tr><tr><td>Reduces the width of the waveform, without changing its pitch, by windowing it between blank spaces. It will affect the harmonics of the wave.</td><td>Change the starting point of the waveform. When using Width, it will scroll which segment of the wave is heard</td><td>Select one of the 6 wave-altering effects. See below for a reference of those.</td><td>Control the selected Transform effect</td></tr></tbody></table>

  
Oscillator Transform effects reference:

<table border="1" id="bkmrk-off-sync-sync-window" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td class="align-center">**Off**</td><td class="align-center">**Sync**

</td><td class="align-center">**Sync Window**</td><td class="align-center">**Asymmetry +/-**</td></tr><tr><td class="align-center">The Transform effect is inactive</td><td class="align-center">Simulates a sync effect. Depth will change the tuning of the master oscillator, the result is phase distortion.</td><td class="align-center">Same as Sync but there is a "fade-in/fade-out" effect on the edges of the waveform in order to smooth out artifacts</td><td class="align-center">Classic Phase Distortion. Depth is at 0% at noon, and turning it clockwise or counter-clockwise will distort the phase in either direction.</td></tr><tr><td class="align-center">**Sine**</td><td class="align-center">**Decimator**</td><td class="align-center">**Folder**</td><td class="align-center">**-**</td></tr><tr><td class="align-center">Phase distortion, but with a sine function instead of a linear function.</td><td class="align-center">A bit-reducer effect. Turn Depth clockwise to reduce, down to 2bits, with an audio crossfading between the bit-rates.</td><td class="align-center">A Chebyshev wavefolder</td><td class="align-center">-</td></tr></tbody></table>

#####   
Page 3 

[![screenshot_005.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/Zpuscreenshot-005.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/Zpuscreenshot-005.png)

It contains general settings regarding the wavetable generation:

<table border="1" id="bkmrk-quality-transition--" style="border-collapse: collapse; width: 100%; height: 108.667px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Quality**</td><td style="height: 29.6333px;">**Transition**</td><td style="height: 29.6333px;">**-**  
</td><td style="height: 29.6333px;">**-**  
</td></tr><tr style="height: 79.0333px;"><td style="height: 79.0333px;">The amount of oversampling while reading the wavetable. Draft means no oversampling, resulting in aliasing on complex waves but low CPU usage.  
Above Draft, an anti-aliasing filter is present.

Medium is x2 oversampling  
Great is x3  
Highest is x4. It will use a lot of CPU power.

</td><td style="height: 79.0333px;">Select between classic wave interpolation or discrete change from one wave to another (no morph)</td><td style="height: 79.0333px;">**-**</td><td style="height: 79.0333px;">**-**</td></tr></tbody></table>

#### Sub + Noise tab

A sub oscillator with extra features and a simple noise generator.  
The Sub+Noise tab has 2 pages

##### Page 1:  


[![screenshot_006.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/k0Hscreenshot-006.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/k0Hscreenshot-006.png)

<table border="1" id="bkmrk-density-spread-fade-" style="border-collapse: collapse; width: 100%; height: 109.667px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Wave**</td><td style="height: 29.6333px;">**Ratio**</td><td style="height: 29.6333px;">**Detune**</td><td style="height: 29.6333px;">**Volume**</td></tr><tr style="height: 80.0333px;"><td style="height: 80.0333px;">Select the sub oscillator's waveform between Saw, Square, Triangle, and Sine</td><td style="height: 80.0333px;">Select the Octave at which the sub oscillator will play, in relation to the tuning of the wavetable oscillator.  
From -3 to +3 octaves, in 1 octave increments, with the additional intermediate settings of -1/2 octave, +1/2 octave and +1.5 octave to form perfect fifth intervals (power chords) with the main oscillator.</td><td style="height: 80.0333px;">Detune the sub oscillator from the main oscillator for chorusing or dissonance effects</td><td style="height: 80.0333px;">Set the amplitude at which the sub oscillator is sent into the Filter Section</td></tr></tbody></table>

#####   
Page 2:  


[![screenshot_007.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/Ifvscreenshot-007.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/Ifvscreenshot-007.png)

<table border="1" id="bkmrk-noise-------set-the-" style="border-collapse: collapse; width: 100%; height: 109.667px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Noise**</td><td style="height: 29.6333px;">**-**</td><td style="height: 29.6333px;">**-**</td><td style="height: 29.6333px;">**-**</td></tr><tr style="height: 80.0333px;"><td style="height: 80.0333px;">Set the amplitude at which the noise generator is sent into the Filter Section  
</td><td style="height: 80.0333px;">-</td><td style="height: 80.0333px;">-</td><td style="height: 80.0333px;">-</td></tr></tbody></table>

# Sample Player

## General Information  


This machine is a basic sample player with looping capabilities and a couple of lo-fi effects.

<div drawio-diagram="202"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741811445.png" alt=""/></div>

  
  
The sample and noise generator is processed through the Lofi FX, followed by a [**Filter section**](https://doc.nanopol.is/books/en-antigone-documentation/page/filter-section), then a Drive section, and finally an [**Amp section**](https://doc.nanopol.is/books/en-antigone-documentation/page/amp-section) before reaching the [**Mixer**](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer). Refer to the corresponding manual sections to learn more about the Filter and Amp sections.

It operates in mono at a 48kHz sample rate with a bit depth of 16 bits. It is compatible with PCM Wave files (converted on the fly if the bit depth or sample rate does not match; if a stereo file is loaded, only the left channel is used).

#### Main screen of the sample player

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/DzPscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/DzPscreenshot-001.png)

  
Upon opening the Sample Player Machine, you will land on Page 1 of Tab 1. Use the first two tabs to configure the sample player. Use Tab 3 to adjust the Filter section and Tab 4 for the Amp section.  
  
Press the encoder to load a specific sample from the browser. In the browser, press Button 4 to enable auto-loading for a quick preview. Once a sample is loaded, turning the encoder scrolls through other samples in the current folder. A pop-up screen will appear, displaying the sample waveform in the same way as on Tab 2.

#### General Tab

This tab contains basic utilities

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> </colgroup><tbody><tr><td>**Frequency**</td><td>**Transpose**</td><td>**-**  
</td><td>**Volume**</td></tr><tr><td>Fine-tune the sample</td><td>Tune the sample in semitone increments  
</td><td>**-**</td><td>Set the amplitude at which the sample enters the Filter Section. 100% is unity gain; beyond that, the output is amplified, useful for quiet samples or driving the Filter and Amp sections (or even overdriving the final DAC).</td></tr></tbody></table>

#### Sample Tab

[ ![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/71Rscreenshot-003.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/71Rscreenshot-003.png)

Use this tab to manipulate the sample file and its playback.  
The Sample tab (Tab 2) consists of two pages with different controls. If a tab header displays small bar icons, press the corresponding button underneath to switch between its pages.

Page 1:

<table border="1" id="bkmrk-density-spread-fade-" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> </colgroup><tbody><tr><td>**Start**</td><td>**Loop**</td><td>**Length**</td><td>**Playmode**</td></tr><tr><td>Set the starting point of the sample file</td><td>Set the loop point if one of the loop modes is activated</td><td>Set the sample's stopping point</td><td>Select the sample playback mode:

- Forward
- Forward Loop
- Reverse
- Reverse Loop  
      
    This parameter cannot be modulated.

</td></tr></tbody></table>

Page 2:

<table border="1" id="bkmrk-decimator-sample-rat" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> <col style="width: 24.9383%;"></col> </colgroup><tbody><tr><td>**Decimator**</td><td>**Sample Rate Reducer**</td><td>**Noise**</td><td>**-**</td></tr><tr><td>A bit-depth reduction effect. Turn Depth clockwise to reduce, down to 2 bits, with audio crossfading between bit rates.</td><td>An audio-rate sample-and-hold effect that introduces classic digital brightness and harmonics. Turn clockwise to lower the sample rate.</td><td>Mix white noise with the sample. The noise plays continuously, so adding an envelope to this parameter is recommended.</td><td>**-**</td></tr></tbody></table>

# Crossmod

### General information  


This Machine features a choice of different cross-modulation algorithms combining two of Antigone's voices to form a third one. The results can be hard to predict and this feature is more of a bonus to see what you can get out of the voices you have set up already.

<div drawio-diagram="208"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741815638.png" alt=""/></div>

  
The cross-modulated output go into a [<span style="text-decoration: underline;">**Filter section**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/filter-section), then a Drive section and finally an [**<span style="text-decoration: underline;">Amp section</span>**](https://doc.nanopol.is/books/en-antigone-documentation/page/amp-section) before going to the[ <span style="text-decoration: underline;">**Mixer**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer).. Go to the respective sections of the manual for more informations on the Filter and Amp Sections.

#### Main screen of the crossmod

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/Cy1screenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/Cy1screenshot-001.png)

#### Input tab

Select the Carrier and Modulator voices using the first two knobs.

#### Crossmod tab  
  


<table border="1" id="bkmrk-width-phase-transfor" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Vol In 1**</td><td>**Vol In 2**</td><td>**Algo**</td><td>**Timbre**</td></tr><tr><td>Controls the volume of the Carrier voice</td><td>Controls the volume of the Modulator voice</td><td>Select one of the 6 cross-modulation algorithms. Refer to the chart below for an overview of those.  
  
This parameter cannot be modulated.</td><td>Depending on the choosen algorithm, it changes the timbre of the sound.  
  
(crossfade between dry and modulated sound for example)</td></tr></tbody></table>

  
Cross-modulation algorithms reference :

<table border="1" id="bkmrk-xor-modulo-ring-modu" style="border-collapse: collapse; width: 100%; height: 59.2666px;"><colgroup><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col><col style="width: 16.6667%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td class="align-center" style="height: 29.6333px;">**XOR**</td><td class="align-center" style="height: 29.6333px;">**Modulo**</td><td class="align-center" style="height: 29.6333px;">**Ring Modulation**</td><td class="align-center" style="height: 29.6333px;">**Ring Modulation 2**</td><td class="align-center" style="height: 29.6333px;">**Sub**</td><td class="align-center" style="height: 29.6333px;">**Negative - Positive**</td></tr><tr style="height: 29.6333px;"><td class="align-center" style="height: 29.6333px;">Performs cross-modulation between two audio signals using the bitwise XOR (exclusive OR) operation.</td><td class="align-center">Performs cross-modulation between two audio signals using the modulo operation.</td><td class="align-center">Performs a ring modulation between two audio signals.</td><td class="align-center">Performs a diode based ring modulation between two audio signals.</td><td class="align-center">Performs a gain then a substraction between two signals.</td><td class="align-center">Keep the positive part of the first signal, and the negative part of the second signal.</td></tr></tbody></table>

####   
How to use it ?

As it is a particular machine that require 2 others instruments as source to works, it can be more tricky to use.

What I recommend is to create 3 mono instruments:

- The first two instruments with the machines of your choice—load only the machines without envelopes to use them as oscillators.
- The third instrument with the crossmod machine.
- Configure the *Instrument Control* of each instrument so they respond to the same CV/Gate input or the same MIDI channel.
- In the crossmod machine, select *Voice 1* as the *carrier* and *Voice 2* as the *modulator* (corresponding to your mono instruments 1 and 2).
- You can add envelopes to the filter and a DCA in the crossmod machine.

# Filter & Amp Sections



# Filter Section

Within each Machine, the sound source is always routed through a similar Filter section, available on Tab 3.  
Each Filter section then goes to an [**<span style="text-decoration: underline;">Amp section</span>**](https://doc.nanopol.is/books/en-antigone-documentation/page/amp-section) before going to the [<span style="text-decoration: underline;">**Mixer**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer).

The Filter section is always on Tab 3 in every Machine.  
This filter tab has 3 pages containing different controls. When a Tab header displays small bar icons, click its corresponding   
button underneath to jump between its pages.

#### Main screen of Filter section

[![screenshot_022.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-022.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-022.png)

Page 1:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Filter 1 Frequency**</td><td style="height: 29.6333px;">**Filter 1 Resonance**</td><td style="height: 29.6333px;">***(Filter Morph)  
-or-  
(Filter Gain)***</td><td style="height: 29.6333px;">**Filter 1 Type**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Controls the filter's cutoff frequency

</td><td style="height: 35.2333px;">Controls the filter's resonance amount</td><td style="height: 35.2333px;">*Morph between the filter types, from Low-Pass to Notch to High-pass. This parameter is only available when the filter type is set to SVF for State Variable Filter.*

 *-or-*

*Set the EQ gain. This parameter is only available when the filter type is set to Bell EQ.*

</td><td style="height: 35.2333px;">Select a filter type and slope. Read the filter types reference below for details on every filter available.  
This parameter cannot be modulated.</td></tr></tbody></table>

  
Page 2 is the same as page 1, but controls Filter 2. In order to unlock it, you need to have the Routing on page 3 on a setting other than Single.

#####   
Filter types reference:

<table border="1" id="bkmrk-off-the-filter-is-by" style="border-collapse: collapse; width: 100%; height: 296.969px;"><colgroup><col style="width: 20.4322%;"></col><col style="width: 79.6914%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Off**</td><td style="height: 29.7969px;">The filter is bypassed</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**SVF**</td><td style="height: 29.7969px;">State Variable Filter model. Use Knob 3 to morph between filter types</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**K35 LP12 / HP6**</td><td style="height: 29.7969px;">Korg 35. Inspired by the MS-20 filter. </td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**TLD LP 6/12/18/24**</td><td style="height: 29.7969px;">Transistor Ladder Filter model. Inspired by the classic Moog filter. Low-Pass with a selection of slopes from 6dB/oct to 24/dB/oct</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**TLD N 12/24**</td><td style="height: 29.7969px;">Transistor Ladder Filter model. Inspired by the classic Moog filter. Notch filter with 12dB/oct and 24dB/oct slopes</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**TLD BP 12/24**</td><td style="height: 29.7969px;">Transistor Ladder Filter model. Inspired by the classic Moog filter. Band-pass with 12dB/oct and 24dB/oct slopes</td></tr><tr style="height: 28.7969px;"><td style="height: 28.7969px;">**DLD LP24**</td><td style="height: 28.7969px;">Diode Ladder Filter model. Inspired by the TB-303 filter. Low-pass with a steep 24dB/oct slope.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**COMB +/-**</td><td style="height: 29.7969px;">Comb filter for hollowed-out sounds and wooshes effects. With positive or negative feedback (resonance)</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**FORMANT**</td><td style="height: 29.7969px;">Formant filter for vowel sounds. Morph through A-E-I-O-U with Knob 1.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**BELL EQ**</td><td style="height: 29.7969px;">Simple 1-band equalizer to increase or decrease a selected frequency region. Knob 2 will adjust the bell width and Knob 3 will set the gain</td></tr></tbody></table>

  
  
Page 3 allows for filter routing options:

<table border="1" id="bkmrk-width-phase-transfor" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr><td>**Routing**</td><td>**Balance between filter 1 and 2**</td><td>**-**</td><td>**-**</td></tr><tr><td>Select a routing configuration for the filters.  
  
Single enables only filter 1.  
  
Serial routes the output of Filter 1 to Filter 2.  
  
Para will route both filters in parallel  
  
Split will split the sound sources into the two filters, depending on the Machine select.</td><td>Controls the volume of both filters at the output. Fully clockwise only filter 2 will be heard, and fully counter-clockwise it will be only filter 1.</td><td>-</td><td>-</td></tr></tbody></table>

### Filter routing  
  


##### Single filter :  


<div drawio-diagram="210"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741853257.png" alt=""/></div>

##### Serial filters :

<div drawio-diagram="211"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741853313.png" alt=""/></div>

##### Parallel filters :

<div drawio-diagram="213"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741853475.png" alt=""/></div>

##### Split filters :

<div drawio-diagram="214"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1741853499.png" alt=""/></div>

##### Input reference (per machines types)

<table border="1" id="bkmrk-machine-input-1-inpu" style="border-collapse: collapse; width: 100%; height: 148.984px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Machine</td><td style="height: 29.7969px;">Input 1</td><td style="height: 29.7969px;">Input 2</td></tr></thead><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Algo synth</td><td style="height: 29.7969px;">Oscillator 1</td><td style="height: 29.7969px;">Oscillator 2</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Wavetable synth</td><td style="height: 29.7969px;">WT Oscillator + Noise</td><td style="height: 29.7969px;">Sub oscillator</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Sample player</td><td style="height: 29.7969px;">Sample</td><td style="height: 29.7969px;">Noise</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Crossmod</td><td style="height: 29.7969px;">Crossmodulated output</td><td style="height: 29.7969px;">-</td></tr></tbody></table>

# Amp Section

Within each Machine, the sound source goes through a Filter section and is then routed to the same Amp section.  
Each Amp section is then routed to the [<span style="text-decoration: underline;">**Mixer**</span>](https://doc.nanopol.is/books/en-antigone-documentation/page/mixer).

#### Main screen of Amp section

[![screenshot_026.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-026.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-026.png)  
  
The Amp section is always on Tab 4 in every Machine.  
This amp tab offers settings related to amplitude and distortion:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Drive Type**</td><td style="height: 29.6333px;">**Drive**</td><td style="height: 29.6333px;">***DCA1***</td><td style="height: 29.6333px;">**DCA2**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Select one of the 29 distortion algorithms. Read the chart below for details regarding each one.

</td><td style="height: 35.2333px;">Controls the amount of distortion</td><td style="height: 35.2333px;">The first Digitally Controlled Amplifier. DCA1 and DCA2 are routed in series, with 1 usually modulated by velocity and 2 modulated by an envelope. But you can set modulations as you wish.</td><td style="height: 35.2333px;">The second Digitally Controlled Amplifier. DCA1 and DCA2 are routed in series, with 1 usually modulated by velocity and 2 modulated by an envelope. But you can set modulations as you wish.  
</td></tr></tbody></table>

#####   
Distortion algorithms reference

<table border="1" id="bkmrk-off-soft-medium-hard" style="border-collapse: collapse; width: 100%; height: 1645.97px;"><colgroup><col style="width: 24.8766%;"></col><col style="width: 75.247%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Type**</td><td style="height: 29.7969px;">**Description**</td></tr></thead><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Off**</td><td style="height: 29.7969px;">Bypassed</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Soft**</td><td style="height: 63.3906px;">Applies a soft saturation effect to an audio sample by adjusting the input sample's amplitude based on a calculated drive factor, using a hyperbolic tangent function for non-linear distortion</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Medium**</td><td style="height: 63.3906px;">Applies a medium saturation effect to an audio sample by scaling the input sample's amplitude with a drive factor and using an arctangent function to achieve a smoother, non-linear distortion.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Hard**</td><td style="height: 63.3906px;">Applies a hard saturation effect to an audio sample by manipulating the sample's amplitude with a drive factor and employing a combination of hyperbolic tangent and arctangent functions for a more aggressive, non-linear distortion.</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Diode**</td><td style="height: 80.1875px;">Applies a diode-based non-linear distortion to an audio sample. It scales the input sample by a drive factor, processes it through a diode model for non-linear distortion, and then blends the processed signal with the original signal based on the drive amount, including a volume compensation factor.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Demon**</td><td style="height: 63.3906px;">Applies a distortion effect to an audio sample by scaling the sample with a drive factor, processing it through a sine function, and then applying a diode-like non-linearity, blending the result with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Soft Fold**</td><td style="height: 63.3906px;">Applies a soft folding distortion to an audio sample by scaling the sample with a drive factor, processing it through a sine function to create a folding effect, and blending the result with the original sample based on the drive amount</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Diode Fold**</td><td style="height: 80.1875px;">Applies a diode-based folding distortion to an audio sample by scaling the sample with a drive factor, processing it through a diode model and a sine function to create a folding effect, and blending the result with the original sample based on the drive amount, including volume compensation</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Dual Frequency**</td><td style="height: 80.1875px;">Applies a frequency-dependent distortion to an audio sample by splitting the sample into low and high frequency components using simple filters, applying different saturation levels to each band, and then blending the processed bands with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Tube**</td><td style="height: 63.3906px;">Simulates tube-like distortion by scaling the input sample with a drive factor, applying a non-linear transformation to mimic the tube saturation effect, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Sigmoid**</td><td style="height: 63.3906px;">Applies a tube-like distortion using a sigmoid function to achieve smooth non-linear saturation, scaling the input sample with a drive factor and blending the processed signal with the original sample based on the drive amount.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Tape Dynamics**</td><td style="height: 63.3906px;">Applies dynamic saturation by using a high-pass pre-emphasis filter, followed by a hyperbolic tangent saturation, and then a low-pass de-emphasis filter, blending the processed signal with the original sample based on the drive amount.</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Tape Hysteresis**</td><td style="height: 80.1875px;">Models tape hysteresis by simulating magnetic hysteresis behavior, adjusting the input sample based on coercivity and remanence factors, and applying a hyperbolic tangent function to saturate the magnetization, blending the processed signal with the original sample based on the drive amount.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Tape Curve**</td><td style="height: 63.3906px;">Applies a tape saturation effect by approximating a saturation curve, scaling the input sample with a drive factor, and using a non-linear transformation to mimic the characteristic response of tape saturation</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**Tape Noise**</td><td style="height: 80.1875px;">Simulates tape saturation with added noise by generating white noise, applying a hyperbolic tangent saturation to the noisy signal, and blending the processed signal with the original sample based on the drive amount, including volume compensation for higher drive levels.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Hard Clipping**</td><td style="height: 63.3906px;">Applies a hard clipping distortion to an audio sample by limiting the sample's amplitude to a threshold determined by the drive factor, normalizing the output, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Fuzz**</td><td style="height: 63.3906px;">Applies a fuzz distortion effect to an audio sample by scaling the sample with a drive factor, using an exponential function to create a non-linear distortion, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Chebyshev**</td><td style="height: 63.3906px;">Applies a series of Chebyshev polynomials to an audio sample, using a normalized drive factor to create a complex harmonic distortion effect, and then blends the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Half Rectifier**</td><td style="height: 63.3906px;">Applies a half-wave rectification effect to an audio sample by zeroing out negative values, scaling the rectified signal with a drive factor, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Full Rectifier**</td><td style="height: 63.3906px;">Applies a full-wave rectification effect to an audio sample by taking the absolute value of the input sample, scaling it with a drive factor, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Transistor**</td><td style="height: 29.7969px;">Simulates transistor-like saturation by scaling the input sample with a drive factor, applying a non-linear transformation to mimic transistor saturation characteristics, and blending the processed signal with the original sample based on the drive amount.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Dynamic**</td><td style="height: 29.7969px;">Applies a dynamic distortion effect to an audio sample by scaling the sample with a drive factor that is modulated by the sample's envelope, using a hyperbolic tangent function for non-linear distortion, and blending the processed signal with the original sample based on the drive amount.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Asymmetric**</td><td style="height: 29.7969px;">Applies an asymmetric clipping distortion to an audio sample by limiting the sample's amplitude to different positive and negative thresholds based on a scaled drive factor, normalizing the clipped signal, and blending it with the original sample based on the drive amount.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Feedback**</td><td style="height: 29.7969px;">Applies a feedback-based distortion effect to an audio sample by adding a feedback signal, scaled by a gain factor derived from the drive, to the input sample and then applying a hyperbolic tangent function for non-linear distortion, updating the feedback with the processed sample</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Zero Crossing**</td><td style="height: 29.7969px;">Introduces distortion at zero crossings by adding a small spike to the audio sample whenever it crosses zero, with the spike's magnitude determined by a normalized drive factor, and updates the last sample for future comparisons.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Bit Reaper**</td><td style="height: 29.7969px;">Applies a bit reduction effect to an audio sample by scaling the drive factor, using it to determine a decimation factor, and then applying a bitwise reduction to the sample, followed by a non-linear saturation using a hyperbolic tangent function, blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Sample Reaper**</td><td style="height: 29.7969px;">Applies a sample rate reduction effect by holding the last sample value for a duration determined by the drive factor, updating the sample only when a counter exceeds a threshold, and blending the processed signal with the original sample based on the drive amount</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Sample Reduction**</td><td style="height: 29.7969px;">Reduces the sample rate of an audio signal by holding the current sample value for a number of iterations determined by a drive-scaled reduction factor, effectively lowering the perceived sample rate</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Bitwise**</td><td style="height: 29.7969px;">Applies a bitwise distortion effect to an audio sample by performing an XOR operation between the sample and a drive-scaled value, then normalizing the result and scaling it based on the drive amount</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Ring Modulation**</td><td style="height: 29.7969px;">Applies a ring modulation effect to an audio sample by multiplying the sample with a sine wave at a frequency determined by the drive factor, updating the phase of the modulating signal to maintain continuous modulation</td></tr></tbody></table>

# Modulators



# ADSR

The ADSR is an essential modulator for synthesis. In this case, it is a DAHDSR (Delay-Attack-Hold-Decay-Sustain-Release) envelope.

The main features of this ADSR are:

- 6-stage envelope (Delay-Attack-Hold-Decay-Sustain-Release)
- Configurable curve for Attack, Delay, and Release stages
- Multiple modes (Gate, Trig, Loop, and Gated Loop)
- The envelope can restart when retriggered before finishing (or continue)
- Like other modulators, the output gain can be modulated to function as a "Depth" parameter.

  
Keep in mind that every envelope parameter can be modulated, except those in the Settings tab, which define the envelope's behavior.  
  
All values are displayed in %. Time values depend on the Range settings (Snap, Fast, Medium, Slow).

#### Main ADSR Screen

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/OdNscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/OdNscreenshot-001.png)

#### ADSR Tab

The ADSR tab consists of two pages, navigable by pressing the corresponding button (button 1).  
  
Page 1 allows you to modify (and modulate) envelope times:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Attack</th><th>Decay</th><th>Sustain</th><th>Release</th></tr></thead><tbody><tr><td>Sets the time for the envelope to reach its peak level after the gate is activated (or a key is pressed in MIDI).</td><td>Sets the time for the envelope to drop to the Sustain level after Attack completes, while the gate remains high (or the key stays pressed in MIDI).</td><td>Defines the level at which the envelope remains as long as the gate is high (or the key is held in MIDI).</td><td>Sets the time for the envelope to return to its lowest level after the gate is released (or a key is released in MIDI).  
  
If the gate is released before Decay (or Attack) finishes, the envelope directly starts the Release stage from its current level, skipping Sustain (or both Decay and Sustain).</td></tr></tbody></table>

  
Page 2 allows you to modify (and modulate) envelope curves:

[![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/qXJscreenshot-003.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/qXJscreenshot-003.png)

<table border="1" id="bkmrk-curve-a-curve-b---cu" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Curve A</th><th>Curve B</th><th>-</th><th>Curve C</th></tr></thead><tbody><tr><td>Sets the Attack stage curve, from Logarithmic to Linear to Exponential.</td><td>Sets the Decay stage curve, from Exponential to Linear to Logarithmic.</td><td>-</td><td>Sets the Decay stage curve, from Exponential to Linear to Logarithmic.</td></tr></tbody></table>

#### Delay/Hold Tab

This tab allows you to add segments to the ADSR envelope:

<table border="1" id="bkmrk-predelay-hold-----se" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Predelay</th><th>Hold</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>Sets the delay time before the Attack stage starts ramping up after the gate is activated (or a key is pressed in MIDI).</td><td>Sets the time the envelope is held at its peak after Attack completes and before Decay starts.</td><td>-</td><td>-</td></tr></tbody></table>

#### Settings Tab

This tab contains settings that define the envelope behavior. These settings cannot be modulated.

<table border="1" id="bkmrk-trigger-mode-range-r" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Trigger</th><th>Mode</th><th>Range</th><th>Retrig</th></tr></thead><tbody><tr><td>Defines the source that triggers the envelope:  
- Disabled
- Any of the 6 Gate inputs
- Voice trigger (note on)
- Clock signals

</td><td>Defines how the envelope responds to gate signals:  
  
- **Gate**: Standard operation mode.
- **Trigger**: The Sustain stage is skipped, and the envelope goes into Release after Decay.
- **Loop**: The envelope cycles like a free-running LFO.
- **Gated Loop**: The loop resets to the beginning of the Attack phase each time the gate goes high.

</td><td>Selects the time range for the envelope:  
- Slow
- Medium
- Fast
- Snap (optimized for percussive sounds)

</td><td>Restarts the envelope from the beginning if retriggered before completion.</td></tr></tbody></table>

#### Output Tab

A final gain stage for the envelope, which can be modulated:

<table border="1" id="bkmrk-gain-------set-the-a" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Gain</th><th>-</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>Adjusts the amplitude of the envelope signal, typically used for Velocity modulation.  
  
-100% means no output.</td><td>-</td><td>-</td><td>-</td></tr></tbody></table>

# LFO Wavetable

This is a Low-Frequency Oscillator (LFO) that provides a wide range of waveforms through wavetables.

**Main features of this LFO:**

- Any wavetable can be used, allowing you to browse and select individual waves as modulation sources.
- In Free mode, multiple frequency ranges are available:  
    \- Slow: 0.0003 Hz to 2.22 kHz  
    \- Medium: 0.01 Hz to 81.9 Hz  
    \- Fast: 0.5 Hz to 4095 Hz
- Synchronization options allow the LFO to sync to an external clock signal.
- Syncing to the Voice's main oscillator frequency is possible, enabling FM-like modulation (0.25× to 24× the oscillator frequency).
- The LFO can be retriggered at the start by a trigger source (note, clock, or gate input).

##### Main screen of the Wavetable LFO

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/1Upscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/1Upscreenshot-001.png)

On any page of the Wavetable LFO, turn the Encoder to browse through wavetables. Click the Encoder to access the Browser and manually load a wavetable.  
  
In the Browser:  
\- Press Button 1 to navigate up a folder level.  
\- Press Button 4 to enable Autoload, allowing real-time auditioning.  
\- Click the Encoder to open a selected folder or load a chosen wavetable file.

#### Wave/Speed Tab

This section allows you to configure basic LFO parameters:

<table border="1" id="bkmrk-wave-phase-speed-%2F-c" style="width: 100%;"><thead><tr><th>Wave</th><th>Phase</th><th>Speed / Clock / Ratio</th><th>-</th></tr></thead><tbody><tr><td>Select an LFO wave by navigating the wavetable.</td><td>Adjust the phase offset, shifting the starting point of the waveform.</td><td>Set the LFO frequency. This parameter adapts based on the synchronization mode: - Free mode: frequency in Hz
- Clock mode: divisions or multiplications of the MIDI Clock
- Ratio mode: multiples of the Voice's oscillator frequency

</td><td>-</td></tr></tbody></table>

#### Settings Tab

This section defines the LFO's run mode and retrigger behavior. These settings cannot be modulated.

<table border="1" id="bkmrk-mode-trigger-----cho" style="width: 100%;"><thead><tr><th>Mode</th><th>Trigger</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>Choose the LFO synchronization mode: - **Free**: The LFO runs independently.
- **Clock**: The LFO syncs to the incoming MIDI Clock signal.
- **Ratio**: The LFO syncs to the Voice's oscillator frequency, tracking its pitch (useful for FM, AM, and other audio-rate modulations).

</td><td>Defines the source that resets the LFO phase. Options include: - Any Gate input
- Voice trigger signal
- MIDI Clock divisions/multiplications

  
Only available in Free mode.</td><td>-</td><td>-</td></tr></tbody></table>

#### Output Tab

Modify the LFO signal before sending it to modulation targets:

<table border="1" id="bkmrk-polarity-gain-----se" style="width: 100%;"><thead><tr><th>Polarity</th><th>Gain</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>Select LFO polarity: - Bipolar
- Unipolar positive
- Unipolar negative

</td><td>Adjust the LFO output level (can be modulated).</td><td>-</td><td>-</td></tr></tbody></table>

# Shape sequencer

This is an advanced modulator that lets you draw complex automation envelopes, create wave-sequencing effects, or even simple sequences, on a per-step basis.

Main features of this shape sequencer :

- Sequence from 1 to 256 steps
- Can be played in forward, reverse, ping-pong or random
- Steps can be synchronized to a clock (1/64, 1/32, 1/16, 1/4, 1/2, 1 BAR, 2BAR, 4BAR, 8BAR, 16BAR)...
- ...or be trigged manually using a gate input, or a Note On (if used as an instrument modulator)
- Multiple parameters per step (Shape, min value, max value, repeat (from 1 to 8), chance, fade in/out
- 34 different shapes available

#### Main screen of the shape sequencer (in edit mode)

[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/0DRscreenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/0DRscreenshot-002.png)

The shape sequencer comes in two different working modes :

- **Edit mode** : more suitable to precisely edit all parameter for a selected step. The 4 potentiometers in this case controls different parameters of this step
- **Perf mode** : more suitable in "live", to edit the same parameter on different step using the four potentiometers (corresponding to 4 different steps)

#### Menu

[![screenshot_008.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/afVscreenshot-008.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/afVscreenshot-008.png)

Click the Encoder to bring up a contextual menu which contains the following operations:

- Perf Mode : switch to Performance Mode (Please refer to the paragraph below for more informations on this)
- Randomize This Step - selects a random shape for the currently selected step
- Randomize All Steps - selects a random shape for each and every step of the sequencer
- Randomize All : Note Seq - generates a random sequence of fixed values, like a standard step-sequencer
- Randomize All : Pluck Seq - generates a sequence of plucked shapes with ratcheting
- Reset all - initializes the entire sequence to the default template  
      
    Click the encoder to launch the selected operation.

#### Steps Tab

##### Edit Mode

This is the default mode of operating the sequencer, and the one you land on when first opening the Shape Sequencer.  
  
Turn the Encoder to scroll to the step you want to edit, which is the one highlighted, one page contains 8 steps, it automatically change the page after 8 steps.

The Steps tab has 2 pages. Click its button (Button 1) to cycle between pages.  
  
Page 1 allows you to select and modify the shape of the selected step. Note that these parameters cannot be modulated.

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Shape**</td><td style="height: 29.6333px;">**Minimum**</td><td>**Maximum**</td><td style="height: 29.6333px;">**Repeat**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Select one of the 34 shapes available</td><td style="height: 35.2333px;">Stretch the shape by "squashing it" towards the top when you turn clockwise. Like resizing a picture.</td><td>Stretch the shape by "squashing it" towards the bottom when you turn counter-clockwise. Like resizing a picture.  
</td><td style="height: 35.2333px;">A ratcheting effect. Set how many times the shape cycles, for the duration of the step. Select between 1 and 8 repeats</td></tr></tbody></table>

  
Page 2 contains more parameters for the selected step. Note that these parameters cannot be modulated.

<table border="1" id="bkmrk-chance-fade-----set-" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Chance**</td><td style="height: 29.6333px;">**Fade**</td><td>**-**</td><td style="height: 29.6333px;">**-**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Set the probability for the step to play. If a step does not play, the sequencer output stays at the previous value until the step is completed.</td><td style="height: 35.2333px;">Apply a fade-in (counter-clockwise) or a fade-out (clockwise) to the shape</td><td>-</td><td style="height: 35.2333px;">-</td></tr></tbody></table>

#####   
Performance Mode

[![screenshot_011.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/9bCscreenshot-011.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/9bCscreenshot-011.png)

It's an alternative display mode for the Shape Sequencer where all the parameter of the Steps tab from Edit Mode are remapped so you can edit the same parameter across multiple steps quickly. Note that these parameters cannot be modulated.  
  
4 steps are displayed at a time, and you can drag the display across the sequence by scrolling the encoder.  
  
Click one of the buttons to select the parameter you want to edit, which is labelled on the corresponding tab.  
Tab 2 and Tab 4 have two pages each, respectively Min/Max and Chance/Fade.  
Knob 1 will edit the selected parameter for step 1, Knob 2 will edit the selected parameter for step 2, and so on.  
  
It's always the same sequence that you're editing, so you can freely toggle between Edit and Performance Mode.  
Click the Encoder to bring up the same contextual menu as in Edit Mode, but in this one the first option is to switch back to Edit Mode.  
You will need to be in Edit Mode to access the other tabs of the Shape Sequencer :

#### Sequence Tab

Here you will find the main parameter of the sequencer:

<table border="1" id="bkmrk-steps-play-mode-----" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Steps**</td><td style="height: 29.6333px;">**Play Mode**</td><td>**-**</td><td style="height: 29.6333px;">**-**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Select the number of steps in the sequence, from 1 to 256.   
  
Can be modulated.</td><td style="height: 35.2333px;">Select how the sequence is played.  
The options are: Off (freezes on the currently playing step, looping it), Forward, Reverse, Ping-Pong and Random.  
  
Can be modulated.</td><td>-</td><td style="height: 35.2333px;">-</td></tr></tbody></table>

#### Trigger / Speed Tab

Here you will find parameters regarding the sequence playback. Note that these parameters cannot be modulated.

<table border="1" id="bkmrk-trig-mode-clock-trig" style="border-collapse: collapse; width: 100%; height: 160.066px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Trig Mode**</td><td style="height: 29.6333px;">**Clock**</td><td style="height: 29.6333px;">**Trigger**</td><td style="height: 29.6333px;">**-**</td></tr><tr style="height: 130.433px;"><td style="height: 130.433px;">Select how the sequencer moves to the next step.  
Clock means it advances at the selected clock rate, Trigger means it advances each time the specified trigger is received.</td><td style="height: 130.433px;">Select the rate at which the steps and their shapes are played back, in divisions or multiplications of the Clock.  
  
 If the sequencer is in Clock mode, this will also be the rate at which the sequencer moves to the next step.  
</td><td style="height: 130.433px;">Select a source to advance the sequencer in Trigger Mode. It can be any of the Gate Inputs, or the same signal that triggers the Voice.</td><td style="height: 130.433px;">-</td></tr></tbody></table>

#### Output Tab

Here you can sculpt the sequence output before it's sent to the modulation targets:

<table border="1" id="bkmrk-polarity-gain-----se" style="border-collapse: collapse; width: 100%; height: 64.8666px;"><colgroup><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col><col style="width: 24.9383%;"></col></colgroup><tbody><tr style="height: 29.6333px;"><td style="height: 29.6333px;">**Polarity**</td><td style="height: 29.6333px;">**Gain**</td><td>**-**</td><td style="height: 29.6333px;">**-**</td></tr><tr style="height: 35.2333px;"><td style="height: 35.2333px;">Select the sequence output polarity between :

- bipolar
- unipolar positive
- unipolar negative.

Can be modulated.

</td><td style="height: 35.2333px;">Set the level of the sequence output.

Can be modulated

</td><td>-</td><td style="height: 35.2333px;">-</td></tr></tbody></table>

### Shapes reference  
  


[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/KwTimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/KwTimage.png)

# Sample & Hold

A Sample &amp; Hold virtual circuit that reads an input in real time (external or internal) and takes a "snapshot" of this input whenever it receives a trigger signal. This snapshot is a fixed value that will be output until a new "snapshot" is taken.  
  
On any page of the S&amp;H modulator, a visual display provides a rough outline of the source signal and the sampled value.

#### Main screen of the Sample &amp; Hold modulator

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/zsTscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/zsTscreenshot-001.png)  
On the real-time chart displayed on the screen, the input source is shown in a faded background, while the sampled output appears in black.

The trigger parameter has a small indicator that lights up whenever a trigger signal is received.

#### S&amp;H Tab

This section allows you to configure the basic parameters for the Sample &amp; Hold:

<table border="1" id="bkmrk-sync-phasemod-----ab" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Source</th><th>Trigger</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>The signal to be sampled can be internal noise, any CV input, modulators from any voice or global sources, Macros, or even any Voice output. Additionally, it includes a selection of MIDI parameters such as Velocity, Key Follow, Aftertouch, and ModWheel.</td><td>The S&amp;H can be triggered by any of the Gate inputs, the Voice trigger, or various divisions and multiplications of the MIDI clock.  
  
A small dot indicator will activate each time a trigger is received, signaling that a new sample has been taken.</td><td>-</td><td>-</td></tr></tbody></table>

#### Output Tab

This section allows you to shape the S&amp;H signal before it is sent to modulation targets:

<table border="1" id="bkmrk-polarity-gain-----se" style="border-collapse: collapse; width: 100%;"><thead><tr><th>Polarity</th><th>Gain</th><th>-</th><th>-</th></tr></thead><tbody><tr><td>Select the polarity of the S&amp;H signal:

- Bipolar
- Unipolar Positive
- Unipolar Negative

</td><td>Adjust the level of the S&amp;H signal. This parameter can be modulated.</td><td>-</td><td>-</td></tr></tbody></table>

# Modulations System



# How modulations work ?

### General Information

**Antigone features a highly flexible modulation system:**

- Almost all parameters of machines, modulators, mixer, scale quantizer, etc., are modulatable.
- All modulation sources are buffered and sample-accurate.
- They operate at the same frequency as the audio engine (48 kHz).
- Modulation sources can be internal or external to the module.
- Each parameter can have up to 3 simultaneous modulations + 1 absolute MIDI Control Change assignment (expander MIDI required).
- All active modulations have an independent smooth parameter that allows for value smoothing (slew limiter), preventing instabilities from an incoming modulation or unwanted "plops" from an envelope, for example.
- The modulation system operates in floating point for optimal sound quality and precision.

### Modulation Flow Diagram

<div drawio-diagram="240"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1742140959.png" alt=""/></div>

The diagram below illustrates how a modulation affects a given parameter. Three modulation sources are combined at different intensities using a virtual attenuverter. Then, they are limited (Clamp) to stay within the parameter limits. Finally, the resulting modulation is smoothed (Smooth).   
  
MIDI CC is not considered a modulation source itself, as it has an absolute effect on the parameter value.

### Modulation Representation

[ ![modulations.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/modulations.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/modulations.png)

As previously mentioned in the documentation, each screen is divided into four sections corresponding to the four parameters controlled by the four infinite rotary encoders below them.

A (\*) symbol under the parameter "Freq F1" indicates that one or more modulations are active on this parameter.   
  
The horizontal gauge represents the parameter range: the left side shows the minimum value, while the right side shows the maximum value. The black marker within the gauge represents the unmodulated value of the parameter, which is set by the rotary encoder or via MIDI CC (expander required). The highlighted area extending from the black marker represents the modulated value, which is the actual value applied to the parameter.   
  
When using a polyphonic instrument, the displayed modulation will always correspond to the first note played (if multiple notes are active at the same time).

### How to Add a Modulation to a Parameter?

Adding a modulation to a parameter is very simple: just hold down Button 1 to 4 located under the parameter you want to modulate. This will open the screen that allows you to configure all modulations for the selected parameter.   
  
Visit the page "[MODULATION ASSIGNMENT](https://doc.nanopol.is/books/en-antigone-documentation/page/assign-modulations "Modulation Assignment (todo)")" for more details.

### How to Find the List of Active Modulations?

To view the list of active modulations, go to the "[MOD MATRIX](https://doc.nanopol.is/books/en-antigone-documentation/page/modulation-matrix "Modulation Matrix (todo)")" screen.

# Assign modulations

In the previous chapter, "[How modulations work](https://doc.nanopol.is/books/en-antigone-documentation/page/how-modulations-work "How modulations work")", we saw how to assign a new modulation to a parameter. As a reminder, simply press and hold button 1–4 located below the parameter you want to modulate. This opens the modulation assignment screen and parameter options.

### Modulation Assignment Screen

[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/RAdscreenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/RAdscreenshot-002.png)

The modulation screen allows you to assign up to three internal or external modulations to a specific parameter on the module.

##### Screen Structure

The screen is divided into four tabs:

- The first three tabs MOD 1 to MOD 3: each one lets you assign a modulation to the selected parameter.
- "Settings" tab: gives access to advanced settings specific to the selected parameter.

### Modulation Operation

A modulation is composed of a modulation source (Source) and an adjustable amount via a virtual attenuator (Attnv). The three modulations assigned to a parameter are summed together. Start by choosing a source from the list below:

##### Available Modulation Sources:

<table border="1" cellpadding="0" cellspacing="0" class="MsoTableGrid" id="bkmrk-source-description-v" style="border-collapse: collapse; border: none; width: 108.148%; height: 404.781px;"><thead><tr><td style="width: 32.0223%;">**<span lang="EN">SOURCE</span>**</td><td style="width: 67.9777%;">**<span lang="EN">Description</span>**</td></tr></thead><tbody><tr style="height: 47px;"><td valign="top"><span lang="EN">VOICE M1 to M4  
&lt;NAME&gt;</span></td><td valign="top"><span lang="EN">Modulator loaded in slots 1 to 4 of the instrument  
&lt;NAME&gt; is the name of the modulator (ADSR, LFOWT, ...)</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">VELOCITY (MIDI only)</span></td><td valign="top">Note velocity</td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">KEYFOLLOW</span></td><td valign="top"><span lang="EN">Keyboard tracking based on the played note</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">MIDI AT (MIDI only)</span></td><td valign="top"><span lang="EN">MIDI Aftertouch control</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">MIDI MW (MIDI only)</span></td><td valign="top"><span lang="EN">MIDI Mod Wheel control</span></td></tr><tr style="height: 47px;"><td valign="top"><span lang="EN">GLOBAL M1 to M4  
&lt;NAME&gt;</span></td><td valign="top"><span lang="EN">Modulator loaded in global modulator slots 1 to 4  
&lt;NAME&gt; is the name of the modulator (ADSR, LFOWT, ...)</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">EXTERNAL CV A to L</span></td><td valign="top">Uses module inputs (A–F) or expander inputs (G–L) as modulation sources</td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">INTERNAL NOISE</span></td><td valign="top"><span lang="EN">Uses internal white noise generator as modulation source</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">MACRO 1...16</span></td><td valign="top"><span lang="EN">Project macros 1 to 16</span></td></tr><tr style="height: 30px;"><td valign="top"><span lang="EN">VOICE 1...6  
OUTPUT</span></td><td valign="top"><span lang="EN">Uses the voice audio output as modulation source</span></td></tr><tr style="height: 35.3906px;"><td valign="top"><span lang="EN">V1 to V6 M1...M4  
&lt;NAME&gt;</span></td><td><span lang="EN">Modulator loaded in slots 1 to 4 of a specific voice (1 to 6)  
&lt;NAME&gt; is the modulator name (ADSR, LFOWT, ...)  
  
Allows cross-voice modulation</span></td></tr></tbody></table>

Then adjust the modulation amount using the Attnv parameter, which ranges from -200% to +200%.

**Advanced Parameters ("Settings" tab):**

- **Smooth**: Smooths modulation to reduce clicks or noise caused by fast value changes.
- **Stepped** (available for certain parameters like ratios): Enables/disables value quantization, especially useful for FM operators.
- **MIDI Assignment**: Assign a MIDI Control Change (CC) to the parameter. Multiple parameters can be assigned to the same CC.

### Shortcuts

Shortcuts to internal modulators and their slot management are available directly from this screen, to avoid deep navigation into menus.

#### Quick Access

While on a MOD 1 to MOD 3 tab, if the selected source is an internal modulator, click the encoder to instantly open the corresponding modulator. To return to the modulation screen, press the "Exit" button.

#### Selecting a New Modulator

If the selected modulation slot is empty (EMPTY), click the encoder to select and assign a modulator to that slot.

#### Replacing a Modulator

If you want to replace an internal modulator in an occupied slot, press and hold the encoder to swap it with another one.

# Modulation matrix

The modulation matrix provides an overview of all modulations currently configured in the project.

### Modulation Matrix Screen

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/TUWscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/TUWscreenshot-001.png)

This screen is divided into two sections:

- On the left side of the table: the modulation source, along with its slot location, its name, and a real-time visual gauge displaying its activity.
- On the right side: the destination parameter, showing its slot and name, as well as the applied modulation amount (ATTNV). This amount can be adjusted directly using Potentiometer 4 located below this column.

At the top of the screen, you’ll find the total number of active modulations in the project. This count does not include modulations assigned to additional voices of an instrument. For instance, if you have a 6-voice polyphonic instrument with an ADSR modulating the filter, it will display as **1 MODULATION**, not 6.

#### Navigation

- Use the encoder to scroll through the list of modulations.
- A short press on the encoder opens the modulation assignment screen for the selected parameter.

#### Modulation Management

**Quick delete:** The *Delete* button immediately removes a modulation, without confirmation.

<p class="callout info">Note that you cannot create new modulations from within the matrix.  
  
Modulations can significantly impact CPU usage. Avoid keeping unnecessary modulations active—such as those with an attenuverter set to 0%, or modulations relying on a missing source (EMPTY).</p>

# Global modulation

### Operation

Antigone provides 4 global modulation slots at the project level. These modulations can be used in the same way as instrument-level modulations, with the key difference that they cannot be triggered by notes played on the instruments.  
  
The global modulation management interface is similar to that of instrument modulations. It presents four empty slots that the user can fill with different types of modulators, including:

- LFO Wavetable
- ADSR (Attack-Decay-Sustain-Release Envelope)
- S&amp;H (Sample &amp; Hold)
- Shape Sequencer

#### Global Modulation Management Screen

[ ![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/g6Hscreenshot-003.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/g6Hscreenshot-003.png)

### Advantages of Global Modulation

Global modulations are optimized for efficient CPU usage. Unlike modulations applied individually to each voice of an instrument, they consume fewer resources, making them an ideal solution for continuous modulators such as LFOs or shape sequencers.

To optimize performance and reduce CPU load, it is recommended to use global modulations whenever possible. This allows for rich and dynamic modulations without overloading the available resources for individual instruments.

### Accessing Global Modulation

[ ![gl_mods.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/gl-mods.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/gl-mods.png)

You can access global modulations from the main "PROJECT" screen by navigating to the "GLOBAL" tab. Select "GL. MODS," then click the encoder to enter the "GLOBAL MODULATORS" screen.

### Slot Management

#### Adding a Modulator

[ ![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/AtAscreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/AtAscreenshot-001.png)  
To add a modulator, select an empty slot by turning the encoder left or right, then click the encoder or press the "ADD" button.

This will open a list of available modulators that you can assign to the selected slot.

[ ![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/0uDscreenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/0uDscreenshot-004.png)

Confirm your selection by clicking the encoder.

#### Replacing a Modulator

If a slot already contains a modulator, you can replace it by selecting the "Replace" option. This allows you to quickly change the type of modulator assigned to the slot.

[ ![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/A4vscreenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/A4vscreenshot-002.png)

#### Navigating Between Slots

The encoder allows you to navigate between different slots. Clicking on an occupied slot provides direct access to the modulator’s parameters.

# General features



# Macros

### Operation

In Antigone, you can define up to 16 macros per project. These macros allow you to simultaneously control one or more parameters, with varying degrees of influence depending on the parameter.

Macros are part of the modulation system: they are considered modulators within Antigone. You can assign a macro to a parameter in the same way as any other internal or external modulator.

<div drawio-diagram="130"><img src="https://nanopolis.storage.googleapis.com/uploads/images/drawio/2025-03/drawing-3-1740917165.png" alt=""/></div>

  
Since macro parameters themselves act as modulators, they cannot be directly modulated by another internal modulator within Antigone. However, they can be controlled absolutely via MIDI CC (if you have the MIDI expander).  
  
For convenience, each macro can be renamed.

##### Main macro screen:

[![macro_02.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/macro-02.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/macro-02.png)

Each tab switches between different banks of 4 macros (1 to 4, 5 to 8, 9 to 12, and 13 to 16).

### How to access macros?

[![macro_01.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/macro-01.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/macro-01.png)

You can access macros from the main "PROJECT" screen, in the "GLOBAL" tab. Select "MACROS," then click the encoder to enter the "MACROS" screen.

### How to modulate a parameter with a macro?

For more details, see the "[Modulation Assignment](https://doc.nanopol.is/books/en-antigone-documentation/page/assign-modulations)" page in the documentation. When assigning a modulation, select the source "INTERNAL MACRO 1..16".

### Editing a macro

  
To access a macro’s configuration screen, press and hold the button below the macro you want to edit in the "MACROS" screen. This will bring up the following screen:  
  
[![macro_03.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/macro-03.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/macro-03.png)

On this screen, you can adjust the macro’s current value and view its modulation matrix. In this example, the macro controls two parameters: "Freq F1" and "LP&gt;N&gt;HP F1," with attenuverters set differently for each parameter.

You can directly adjust the attenuverter (which controls the macro’s depth of influence on a parameter) using rotary potentiometer 4.

To change the assigned modulation destination, use the encoder. Clicking it will provide a shortcut to the parameter's modulation assignment screen. You can return to the previous screen by clicking the "&lt; | ALT" button.

### Assign a MIDI Control Change (expander required)

Switch to the "ASSIGN CC" tab:  
  
[![macro_04.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/macro-04.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/macro-04.png)

In the "ASSIGN CC" tab, the "Midi Assgn" parameter allows you to assign a MIDI Control Change from 1 to 119.

### Renaming a macro

Click on the "RENAME &gt;" tab to open the macro name editing window:

[![macro_05.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/macro-05.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/macro-05.png)

Here, you can enter a new name for the macro. Use the left and right arrows to move the cursor. The encoder allows you to change the letter or number at the cursor’s position.

The "CLEAR" button erases the entire name and resets the cursor to the beginning.

Click "OK" to confirm the new name.

If you wish to cancel the name change, click the "&lt; | ALT" button.

# Mixer

### Functionality

The Antigone mixer allows you to mix the audio signals of different instruments together.  
  
Since Antigone can handle up to 6 instruments, there will be a maximum of 6 corresponding audio tracks.  
  
Each instrument's audio output is mono and can be routed to either a mono or stereo output of the Antigone. If an instrument is routed to a stereo output, you can adjust its panning (Pan) and the distribution of its voices across the stereo spectrum (Spread).

##### Main mixer screen:

[![mixer_02.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/mixer-02.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/mixer-02.png)

### How to access mixer ?

[![mixer_01.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/mixer-01.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/mixer-01.png)

You can access macros from the main "PROJECT" screen, in the "GLOBAL" tab. Select "MIXER," then click the encoder to enter the "MIXER" screen.

### How to switch instruments in the mixer?

To change the instrument being edited, simply turn the encoder in either direction to move to the previous or next instrument.  
  
The currently selected instrument is displayed in the screen header under "INSTR. X," where X represents the instrument number. It is also highlighted in the upper-right corner of the screen.


##### Example of instrument 2 configuration with a mono output:

  
[![mixer_03.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/mixer-03.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/mixer-03.png)

### Parameters

<table border="1" id="bkmrk-volume-the-instrumen" style="border-collapse: collapse; width: 100%; height: 186.375px;"><colgroup> <col style="width: 17.9278%;"></col> <col style="width: 82.0722%;"></col> </colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**Volume**</td><td style="height: 29.7969px;">The instrument's volume, adjustable from 0 to 100%.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Pan**</td><td style="height: 46.5938px;">The instrument's position in the stereo field (left-right). This parameter is only active when a stereo output is selected.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**Spread**</td><td style="height: 46.5938px;">The distribution of the instrument’s voices across the stereo spectrum. This parameter is only active when a stereo output is selected and allows you to adjust the stereo image of the instrument.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**Output**</td><td style="height: 63.3906px;">**Off**: The instrument's audio output is disabled.  
**OUT 1 to 4**: The instrument outputs in mono on one of Antigone’s audio outputs 1 to 4.  
**OUT 1-2 or 3-4**: The instrument outputs in stereo on Antigone’s audio outputs 1-2 or 3-4.</td></tr></tbody></table>

# Scale quantizer

### Operation

The "Scale Quantizer" allows real-time adjustment of notes to a specific musical scale. It operates at the project level (global), meaning it affects all instruments simultaneously. It is possible to transpose all voices globally or to transpose each of Antigone’s 6 voices individually. This makes it easy to create chords within a given scale.

##### Main screen of the Scale Quantizer

[ ![scale_01.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/scale-01.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scale-01.png)

### How to access the Scale Quantizer?

[![scale_qtz.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/J7Cscale-qtz.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/J7Cscale-qtz.png)

You can access the Scale Quantizer from the main "PROJECT" screen, in the "GLOBAL" tab. Select "SCALE," then click the encoder to enter the "SCALE" screen.

### Parameters

<table border="1" id="bkmrk-transpose-allows-the-" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 20.4322%;"></col> <col style="width: 79.6914%;"></col> </colgroup><tbody><tr><td>**Transpose**</td><td>Allows transposition (in semitones) of all Antigone voices. This transposition occurs before the Scale Quantizer.</td></tr><tr><td>**Scale**</td><td>Allows selection of a musical scale. When "Off" is selected, no quantization is applied. (See the next chapter)</td></tr><tr><td>**RootNote**</td><td>Defines the fundamental note.</td></tr></tbody></table>

### Available scales

<table border="1" id="bkmrk-scale-parameter-values-" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 26.0816%;"></col> <col style="width: 36.9592%;"></col> <col style="width: 36.9592%;"></col> </colgroup><thead><tr><td>**Scale parameter value**</td><td>**Scale name**</td><td>**Intervals**</td></tr></thead><tbody><tr><td>Chrom.</td><td>Chromatic</td><td>0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11</td></tr><tr><td>Pent.Min.</td><td>Minor Pentatonic</td><td>0, 3, 5, 7, 10</td></tr><tr><td>Pent. Maj.</td><td>Major Pentatonic</td><td>0, 2, 4, 7, 9</td></tr><tr><td>Harm.Min.</td><td>Harmonic Minor</td><td>0, 2, 3, 5, 7, 8, 11</td></tr><tr><td>Melo.Min.</td><td>Melodic Minor</td><td>0, 2, 3, 5, 7, 9, 11</td></tr><tr><td>Blues</td><td>Blues</td><td>0, 3, 5, 6, 7, 10</td></tr><tr><td>Lydian</td><td>Lydian</td><td>0, 2, 4, 6, 7, 9, 10</td></tr><tr><td>Aeolian</td><td>Aeolian</td><td>0, 2, 3, 5, 7, 8, 10</td></tr><tr><td>Sup.Loc.</td><td>Super Locrian</td><td>0, 1, 3, 4, 6, 8, 10</td></tr><tr><td>Locrian</td><td>Locrian</td><td>0, 1, 3, 5, 6, 8, 10</td></tr><tr><td>Dorian</td><td>Dorian</td><td>0, 2, 3, 5, 7, 9, 10</td></tr><tr><td>Augmen.</td><td>Augmented</td><td>0, 3, 4, 7, 8, 11</td></tr><tr><td>Mixoly.</td><td>Mixolydian</td><td>0, 2, 4, 5, 7, 9, 10</td></tr><tr><td>Phrygian</td><td>Phrygian</td><td>0, 1, 3, 5, 7, 8, 10</td></tr><tr><td>Gypsy</td><td>Gypsy</td><td>0, 2, 3, 6, 7, 8, 10</td></tr><tr><td>Persian</td><td>Persian</td><td>0, 1, 4, 5, 6, 8, 11</td></tr></tbody></table>

### Individual voice transposition

[ ![scale_02.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/scale-02.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scale-02.png)

<table border="1" id="bkmrk-voice-1-6-allows-" style="border-collapse: collapse; width: 100%;"><colgroup> <col style="width: 20.4322%;"></col> <col style="width: 79.6914%;"></col> </colgroup><tbody><tr><td>**Voice 1-6**</td><td>Allows individual transposition (in semitones) of Antigone's voices. This transposition occurs before the Scale Quantizer.</td></tr></tbody></table>

# Clock (internal & external)

### Operation

### [ ![clock_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/clock-001.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/clock-001.png)   


The Antigone clock offers two operating modes: Internal and External. The internal clock has an accuracy of ±0.03 BPM. The "Trig View" indicator lights up with each generated (internal) or received (external) trig.  
  
In the header of this screen "GLOBAL &gt; CLOCK 119.98 BPM", you can see the actual BPM value with a precision of 0.01 BPM.

### How to access the Clock ?

[![clock.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/clock.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/clock.png)You can access the Clock from the main "PROJECT" screen, in the "GLOBAL" tab. Select "CLOCK," then click the encoder to enter the "CLOCK" screen.

###   
Internal Clock

To use the internal clock, select the "Internal" mode and choose the desired BPM. Even though the clock is internal, you can still reset it using an external trig (Gate or MIDI).

### External Clock

[ ![clock_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/clock-003.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/clock-003.png)

### External Clock

If you want to use an external clock as a synchronization source, you must configure at least the "Trigger" parameter to select the input for synchronization. The "Reset" parameter allows you to restart at the beginning of the measure, which is essential for using the shape sequencer or synchronizing the Wavetable LFO.

##### Trigger Parameter:

<table border="1" id="bkmrk-gate-1..4-uses-gate-" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 20.3087%;">Gate 1..4</td><td style="width: 79.8149%;">Uses Gate 1 to 4 inputs as the clock synchronization source (1/16 division)</td></tr><tr><td style="width: 20.3087%;">Gate 5..6</td><td style="width: 79.8149%;">Uses Gate 5 or 6 input from the expander as the clock synchronization source (1/16 division)</td></tr><tr><td style="width: 20.3087%;">MIDI CLK</td><td style="width: 79.8149%;">Uses the MIDI input from the expander as the clock synchronization source (96 ppqn)</td></tr></tbody></table>

##### Reset Parameter:

<table border="1" id="bkmrk-gate-1..4-uses-gate--1" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 20.1853%;">Gate 1..4</td><td style="width: 79.9383%;">Uses Gate 1 to 4 inputs as the reset source</td></tr><tr><td style="width: 20.1853%;">Gate 5..6</td><td style="width: 79.9383%;">Uses Gate 5 or 6 input from the expander as the reset source</td></tr><tr><td style="width: 20.1853%;">MIDI STA</td><td style="width: 79.9383%;">Uses the MIDI Start command received on the expander's MIDI input</td></tr><tr><td style="width: 20.1853%;">MIDI STO</td><td style="width: 79.9383%;">Uses the MIDI Stop command received on the expander's MIDI input</td></tr></tbody></table>

# Annex



# How to update the firmware ?

### Step 1: Checking the current firmware installed

The current firmware version installed on your module is displayed at the module startup.

You can also check the version installed by moving the encoder to the left until you reach the burger menu, click on the encoder, and move until the "SYSTEM INFO" menu.

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/scaled-1680-/Z4Yimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/Z4Yimage.png)

Click on the encoder again, you'll reach this screen :

[![system_info_display.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/scaled-1680-/system-info-display.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/system-info-display.png)

On which you can see the memory used by the system, the memory used by the wavetables and the version of the firmware installed.

### Step 2 : Download the Firmware Update Tool (teensyloader)


The tool for loading new firmware is available for Windows, Macintosh, and Linux operating systems.  
  
Download link for Windows version:  
[https://www.pjrc.com/teensy/teensy.exe](https://www.pjrc.com/teensy/teensy.exe)  
  
Download link for Macintosh (Apple) version:  
[https://www.pjrc.com/teensy/teensy.dmg](https://www.pjrc.com/teensy/teensy.dmg)

Explanation link for Linux (Ubuntu) installation:  
[https://www.pjrc.com/teensy/loader\_linux.html](https://www.pjrc.com/teensy/loader_linux.html)

###   
Step 3 : Connect the Antigone Module


Connect the Antigone using a standard micro USB cable to your computer.

[![antigone back.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/antigone-back.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/antigone-back.png)

### Step 4 : Run Teensy Loader


Executez l'outil de chargement du firmware précédemment téléchargé

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/8CBimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/8CBimage.png)

### Step 5: Open the .hex Firmware File

Download the latest firmware version here :  
[https://storage.googleapis.com/nanopolis/firmwares/antigone-1.1.4.hex](https://storage.googleapis.com/nanopolis/firmwares/antigone-1.1.4.hex)

<p class="callout warning">Warning: The contents of the SD card have changed since version 1.0.0, please perform step 6 of this manual if you had a version lower than 1.0.0, otherwise the module will not start.</p>

Click on the icon [![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/6XRimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/6XRimage.png) and choose the firmware .hex file (example: antigone-1.0.0-beta.hex), then click on the "Auto" button so it lights up green as shown in the screenshot above.

### Step 6: Press the Button

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/I6Dimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/I6Dimage.png)

Press the button circled in red in the photo above. The firmware will update automatically. Once the message "Reboot OK" appears, you can remove the USB cable and put the Antigone module back into your Eurorack case.

[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/JtEimage.png) ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/JtEimage.png)[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/scaled-1680-/wrIimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-05/wrIimage.png)

You can check if the new version is properly installed by redoing step 1

### Step 7: Reinitialize the Micro SD Card

The micro SD card of the module must be formatted to exFat. (Factory formatting is already in exFat format)

Download the factory microSD card content here:  
[https://storage.googleapis.com/nanopolis/firmwares/SDCard-v1.1.4.zip](https://storage.googleapis.com/nanopolis/firmwares/SDCard-v1.1.4.zip)

Unzip the downloaded zip file, and copy all directories to your microSD card (Instruments, Projects, Samples, System and Wavetables)

The contents of the card should look like this, the Instruments, Projects, Samples, System and Wavetables directories should be at the root of the SD card.

<table border="1" id="bkmrk-on-mac-it-must-look-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>On Mac it must look like</td><td>On WIndows it must look like</td></tr><tr><td>[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/scaled-1680-/wvZimage.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-06/wvZimage.png)</td><td>[![image.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/scaled-1680-/image.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2024-08/image.png)</td></tr></tbody></table>

# Test mode

### Functionality

The Test Mode allows you to verify the proper functioning of the hardware components of your main module and its expander. It includes tests for:

- Memory components (PSRAM)
- Audio outputs
- GATE inputs
- Endless rotary potentiometers
- CV inputs

### How to activate Test Mode?

To activate Test Mode, hold the "&lt; | ALT" button while powering on the module.

<p class="callout warning">Warning: As soon as Test Mode is activated, a 440 Hz sine wave signal will be emitted simultaneously on all four audio outputs (1/2/3/4). This helps detect potential audio output malfunctions.</p>

### Details of the different tests

#### PSRAM

[ ![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-002.png)

• Checks the amount of detected memory.  
• The expected values are "PSRAM Size: 16MB" and "PSRAM Frequency: 132.9MHz".  
• If less than 16MB is detected, this indicates an issue with one of the PSRAM components.

#### POTS (Potentiometers)

[ ![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-003.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-003.png)

• Allows you to test the functionality of the endless rotary potentiometers. • As you rotate each of the four endless potentiometers, you should see the bar gradually move left or right.

#### GATE/MIDI

[ ![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-004.png)

• Verifies the GATE inputs of the main module (1-4) and the expander (5-6).  
• A ‘\*’ symbol appears next to the input name when a voltage is detected.  
• "Last MIDI Message" displays the last received MIDI message (if the MIDI expander is connected).  
• If no MIDI message is displayed, this indicates an issue with the MIDI input.

#### CV

[ ![screenshot_005.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/screenshot-005.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/screenshot-005.png)

• Displays the real-time value of the CV inputs, ranging from 0 to 4095:  
• 0 = -5V  
• 2047 ≈ 0V  
• 4095 = +5V

The displayed values are raw readings received from the ADC (Analog to Digital Converter) without calibration or smoothing. It is normal to see some fluctuations in the values and for the center value at 0V to not be exactly 2047. It may vary by +/- 20 values. This deviation is corrected during the calibration process.

# Calibration

Antigone’s calibration ensures accurate CV input response according to the 1V/oct standard.

If an expander is connected, it is recommended to restart the full calibration process to properly include and adjust the new CV inputs.

Calibration data is stored in Antigone’s Flash memory and remains intact after a firmware update. Therefore, recalibration is not required after updating the firmware.

### How to start the calibration?

On Antigone’s main screen "PROJECT", click the burger menu using the encoder, then go to the "SETTINGS" menu and click again to enter.

[![screenshot_001.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/vAescreenshot-001.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/vAescreenshot-001.png)

Then select "CALIBRATION".

[![screenshot_002.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/aL6screenshot-002.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/aL6screenshot-002.png)

In the calibration screen, you will be asked to unplug all cables connected to the CV inputs (on both the module and the expander).  
  
Next, connect a keyboard (or any voltage source) to the CV A input as shown, and press the C3 key on your keyboard, which usually outputs 0 Volts (depending on your master keyboard’s settings).

[![screenshot_003.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/xgMscreenshot-003.png)  ](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/xgMscreenshot-003.png)

Then click the "NEXT" button (button 4) to begin calibration of CV input A. Wait until the progress bar completes.

[![screenshot_004.png](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/scaled-1680-/DQ6screenshot-004.png)](https://nanopolis.storage.googleapis.com/uploads/images/gallery/2025-03/DQ6screenshot-004.png)

Unplug the cable from CV input A, plug it into CV input B, and repeat the process for each CV input:  
\- A to F for the main module  
\- then G to L if the expander is connected.

  
Once the 0 Volt calibration is done, repeat the entire process for all inputs again using a 3V signal, which corresponds to the C6 note.

<p class="callout info">After completing the full calibration process, it is recommended to restart the module.</p>