# 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)