# Esecuzione di Zen Studio su Linux

Segui questa guida per configurare una VM Windows su Ubuntu, Debian o Arch Linux per installare Zen Studio e collegare il tuo Cronus Zen.

## Passo dopo passo

***

{% stepper %}
{% step %}

### Crea la VM Windows <a href="#sc6aw" id="sc6aw"></a>

* **Apri VirtualBox e clicca su Nuova**
  * Nome: ZenWindowsVM
  * Tipo: Microsoft Windows
  * Versione: Windows 10 (64-bit)
* **Monta l'ISO di Windows**
  * Seleziona VM → Impostazioni → Archiviazione
  * Sotto il controller IDE, clicca sul disco vuoto
  * Scegli un file disco → seleziona la tua ISO
* Avvia la VM e completa la procedura guidata di installazione di Windows
  {% endstep %}

{% step %}

### Configura la VM dopo l'installazione

* **Windows Update**
  * Apri Impostazioni → Aggiornamento e sicurezza → Verifica disponibilità aggiornamenti.
  * Installa tutti gli aggiornamenti e riavvia.
* **Guest Additions**
  * Nel menu della VM di VirtualBox: Dispositivi → Inserisci l'immagine del CD delle Guest Additions.
  * In Esplora file di Windows, esegui *VBoxWindowsAdditions.exe*
  * Riavvia.
* **Pass-through USB**
  * Spegni la VM.
  * **Impostazioni** → **USB** → abilita **USB 2.0** o **USB 3.0** controller, clicca + → seleziona **Cronus Zen** → **OK**.
    {% endstep %}

{% step %}

### Installa Zen Studio

* Accendi la VM Windows.

* All'interno di Windows, apri il browser e vai a:
  * [**collectiveminds.gitbook.io/cronuszen/mainhub/downloads**](https://collectiveminds.gitbook.io/cronuszen/mainhub/downloads)

* Scarica **Zen Studio**.

* Esegui il programma di installazione: **Avanti** → **Accetta la licenza** → **Installa** → **Fine**.

* Se l'installatore fallisce durante il download di .NET Framework 4.8.1:
  * Scarica l'installatore offline da Microsoft
    * [**dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer**](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer)

* Esegui l'installatore di .NET e riavvia Windows.

* Esegui nuovamente l'installatore di Zen Studio.
  {% endstep %}

{% step %}

### Collega il tuo Cronus Zen

* Tieni premuti entrambi i pulsanti blu del Cronus Zen.
* Collega il Cronus Zen al tuo PC/portatile.
* I LED lampeggeranno.
* Ora rilascia entrambi i pulsanti blu.
* Nel menu di VirtualBox: **Dispositivi** → **USB** → seleziona **Cronus Zen**.
* In Windows, avvia ZEN Studio e conferma il riconoscimento del dispositivo.
  {% endstep %}

{% step %}

### Suggerimenti e risoluzione dei problemi

* Aggiungi il tuo utente Linux al gruppo vboxusers:
  * *sudo usermod -aG vboxusers $USER*
  * Quindi disconnettiti e riconnettiti.
* Su Arch, assicurati che i moduli del kernel di VirtualBox siano caricati:
  * *sudo modprobe vboxdrv vboxnetflt vboxnetadp*
* Se il pass-through USB fallisce:
  * Alterna tra USB 2.0 e USB 3.0 nelle impostazioni della VM.
* Abilita il paging annidato e l'I/O APIC:
  * Sotto **Sistema** → **Accelerazione** per migliori prestazioni.
* Per automazione o uso headless:
  * Esplora **VBoxManage** per automatizzare la creazione di VM e i filtri USB.
    {% endstep %}
    {% endstepper %}