> For the complete documentation index, see [llms.txt](https://guide.cronuszen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.cronuszen.com/zen-fr/guides-de-configuration/executer-zen-studio-sous-linux.md).

# Exécuter Zen Studio sous Linux

Suivez ce guide pour configurer une VM Windows sur Ubuntu, Debian ou Arch Linux afin d'installer Zen Studio et de connecter votre Cronus Zen.

## Étape par étape

***

{% stepper %}
{% step %}

### Créer la VM Windows <a href="#sc6aw" id="sc6aw"></a>

* **Ouvrez VirtualBox et cliquez sur Nouveau**
  * Nom : ZenWindowsVM
  * Type : Microsoft Windows
  * Version : Windows 10 (64 bits)
* **Monter l'ISO de Windows**
  * Sélectionnez VM → Paramètres → Stockage
  * Sous le contrôleur IDE, cliquez sur le disque vide
  * Choisir un fichier de disque → sélectionnez votre ISO
* Démarrez la VM et terminez l'assistant d'installation de Windows
  {% endstep %}

{% step %}

### Configurer la VM après l'installation

* **Windows Update**
  * Ouvrez Paramètres → Mise à jour et sécurité → Rechercher des mises à jour.
  * Installez toutes les mises à jour et redémarrez.
* **Guest Additions**
  * Dans le menu de la VM VirtualBox : Périphériques → Insérer l'image du CD des Guest Additions.
  * Dans l'Explorateur Windows, exécutez *VBoxWindowsAdditions.exe*
  * Redémarrez.
* **Redirection USB (Passthrough)**
  * Éteignez la VM.
  * **Paramètres** → **USB** → activer **USB 2.0** or **USB 3.0** contrôleur, Cliquez sur + → sélectionnez **Cronus Zen** → **OK**.
    {% endstep %}

{% step %}

### Installer Zen Studio

* Allumez la VM Windows.

* Dans Windows, ouvrez votre navigateur et allez sur :
  * [**collectiveminds.gitbook.io/cronuszen/mainhub/downloads**](https://collectiveminds.gitbook.io/cronuszen/mainhub/downloads)

* Télécharger **Zen Studio**.

* Exécutez l'installateur : **Suivant** → **Accepter la licence** → **Installer** → **Terminer**.

* Si l'installateur échoue lors du téléchargement de .NET Framework 4.8.1 :
  * Téléchargez l'installateur hors ligne depuis Microsoft
    * [**dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer**](https://dotnet.microsoft.com/download/dotnet-framework/thank-you/net48-offline-installer)

* Exécutez l'installateur .NET et redémarrez Windows.

* Relancez l'installateur de Zen Studio.
  {% endstep %}

{% step %}

### Connectez votre Cronus Zen

* Maintenez enfoncés les deux boutons bleus du Cronus Zen.
* Branchez le Cronus Zen à votre PC/portable.
* Les voyants LED vont clignoter.
* Relâchez maintenant les deux boutons bleus.
* Dans le menu VirtualBox : **Périphériques** → **USB** → sélectionnez **Cronus Zen**.
* Dans Windows, lancez ZEN Studio et confirmez la détection du périphérique.
  {% endstep %}

{% step %}

### Conseils et dépannage

* Ajoutez votre utilisateur Linux au groupe vboxusers :
  * *sudo usermod -aG vboxusers $USER*
  * Puis déconnectez-vous et reconnectez-vous.
* Sur Arch, assurez-vous que les modules du noyau VirtualBox sont chargés :
  * *sudo modprobe vboxdrv vboxnetflt vboxnetadp*
* Si la redirection USB échoue :
  * Basculez entre USB 2.0 et USB 3.0 dans les paramètres de la VM.
* Activez la pagination imbriquée et l'I/O APIC :
  * Sous **Système** → **Accélération** pour de meilleures performances.
* Pour l'automatisation ou l'utilisation sans interface :
  * Explorez **VBoxManage** pour scriptiser la création de VM et les filtres USB.
    {% endstep %}
    {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.cronuszen.com/zen-fr/guides-de-configuration/executer-zen-studio-sous-linux.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.