> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Préréglages

> Gérer des configurations de rendu réutilisables

Un préréglage est une configuration de rendu réutilisable — arrière-plan, style des sous-titres, mise en page et autres paramètres visuels — que vous pouvez appliquer à n’importe quel projet ou export. Les préréglages sont idéaux lorsque vous souhaitez un rendu cohérent sur de nombreux morceaux.

Voir [Render settings reference](/en/render-settings-reference) pour la forme complète de `preset` et toutes les options basées sur des enums.

## `preset schema`

Renvoie le JSON Schema des paramètres de préréglage. Utilisez-le pour découvrir les champs valides avant de créer ou de mettre à jour un préréglage.

```bash theme={null}
youka preset schema --json
```

<Tip>
  Les agents doivent appeler `preset schema` avant de modifier des préréglages afin de connaître les
  noms exacts des champs et les types de valeurs.
</Tip>

## `preset list`

Liste tous les préréglages appartenant au compte authentifié.

```bash theme={null}
youka preset list --json
```

## `preset show`

Récupère un seul préréglage par ID.

```bash theme={null}
youka preset show <presetId> --json
```

## `preset create`

Crée un nouveau préréglage.

```bash theme={null}
youka preset create [options]
```

### Options

| Option             | Description                                                    |
| ------------------ | -------------------------------------------------------------- |
| `--name <name>`    | Nom du préréglage                                              |
| `--default`        | Définir le nouveau préréglage comme préréglage par défaut      |
| `--body <file\|->` | Lire le corps complet de la requête depuis un fichier ou stdin |

<Note>
  Le corps de la requête doit contenir l’objet `preset` complet. Pour les charges utiles volumineuses,
  privilégiez `--body` plutôt que du JSON en ligne.
</Note>

### Exemples

<CodeGroup>
  ```bash from-file theme={null}
  youka preset create \
    --name "Neon Night" \
    --body ./neon-preset.json \
    --json
  ```

  ```bash make-default theme={null}
  youka preset create \
    --name "Red Cinema" \
    --body ./red-cinema.json \
    --default \
    --json
  ```

  ```bash from-stdin theme={null}
  cat ./preset.json | youka preset create --name "From stdin" --body - --json
  ```
</CodeGroup>

Les options CLI remplacent les champs correspondants de `--body`.

## `preset update`

Met à jour un préréglage existant.

```bash theme={null}
youka preset update <presetId> [options]
```

| Option             | Description                                            |
| ------------------ | ------------------------------------------------------ |
| `--name <name>`    | Nouveau nom                                            |
| `--body <file\|->` | Corps complet de la requête depuis un fichier ou stdin |

Exemple :

```bash theme={null}
youka preset update $PRESET_ID \
  --name "Neon Night v2" \
  --body ./neon-v2.json \
  --json
```

## `preset delete`

Supprime un préréglage par ID.

```bash theme={null}
youka preset delete <presetId> --json
```

<Warning>
  La suppression d’un préréglage ne supprime pas les projets ni les exports qui ont été précédemment
  rendus avec celui-ci. Les exports futurs qui référencent le préréglage supprimé échoueront.
</Warning>

## `preset default`

Récupère ou définit le préréglage par défaut.

```bash theme={null}
youka preset default --json
youka preset default <presetId> --json
```

Sans argument, la commande renvoie le préréglage par défaut actuel ou `null`. Avec un ID de préréglage, elle marque ce préréglage comme préréglage par défaut.

## Appliquer un préréglage

Appliquez un préréglage à un projet ou à un export avec `--preset` :

<CodeGroup>
  ```bash on-create theme={null}
  youka project create ./song.mp3 --preset $PRESET_ID --wait
  ```

  ```bash on-settings-update theme={null}
  youka project settings $PROJECT_ID --preset $PRESET_ID
  ```

  ```bash on-export theme={null}
  youka export create $PROJECT_ID --preset $PRESET_ID --wait
  ```
</CodeGroup>

## Et ensuite

* [Render settings reference](/en/render-settings-reference) - tous les champs de préréglage partagés
* [Projects](/fr/cli/projects) - appliquer des préréglages aux paramètres de projet
* [Exports](/fr/cli/exports) - appliquer des préréglages au moment du rendu
* [Media](/fr/cli/media) - médias réutilisables référencés par des préréglages