Importer une pièce de théâtre dans Thalia

1. La structure du fichier

Un fichier Thalia contient le titre de la pièce, son auteur (facultatif), la liste des personnages, puis les actes, qui contiennent des scènes, qui contiennent des lignes. Voici un extrait du Misanthrope de Molière :

{
  "title": "Le Misanthrope",
  "author": "Molière",
  "characters": [
    {"id": "alceste", "name": "Alceste"},
    {"id": "philinte", "name": "Philinte"}
  ],
  "acts": [{
    "number": 1,
    "scenes": [{
      "number": 1,
      "title": "Philinte, Alceste",
      "lines": [
        {"character": "philinte", "text": "Qu'est-ce donc ? Qu'avez-vous ?"},
        {"type": "direction", "text": "Alceste se lève."},
        {"character": "alceste", "text": "Laissez-moi, je vous prie."}
      ]
    }]
  }]
}

2. Les personnages

Chaque personnage a deux champs :

• id : un identifiant court, sans espace de préférence (alceste, la-servante). Il sert à relier les répliques au personnage et doit être unique.
• name : le nom affiché dans l'application (« Alceste », « La Servante »).

La liste ne peut pas être vide. Pensez à y mettre aussi les rôles muets ou très courts : c'est cette liste que vous utiliserez pour distribuer les rôles à la troupe.

3. Actes et scènes

Les actes et les scènes sont identifiés par un number entier (1, 2, 3…), unique dans son niveau : deux actes ne peuvent pas porter le même numéro, ni deux scènes d'un même acte.

• Une pièce en un seul acte ? Créez simplement l'acte 1.
• Le title d'une scène est facultatif. On y met souvent les personnages présents (« Oronte, Alceste, Philinte »).
• Chaque scène doit contenir au moins une ligne.

C'est ce découpage qui permet à chaque comédien·ne de voir ses scènes et de les marquer comme apprises une à une : n'hésitez pas à découper finement.

4. Répliques et didascalies

Les lines d'une scène sont lues dans l'ordre. Il en existe deux sortes :

Les vers et les retours à la ligne

Pour une tirade en vers, écrivez \n à chaque fin de vers, à l'intérieur du texte :

{"character": "alceste", "text": "Non pas. Mais la surprise est fort grande pour moi,\nEt je n'attendais pas l'honneur que je reçoi."}

Les guillemets dans le texte

Le texte est lui-même entre guillemets droits "…". Pour citer quelque chose dans une réplique, utilisez les guillemets français « … » ou écrivez \". Les apostrophes (’ ou ') ne posent aucun problème.

5. Convertir un texte existant avec une IA

Vous avez déjà la pièce en Word, en PDF ou en texte brut ? Un assistant comme Claude ou ChatGPT peut faire la conversion pour vous. Copiez ce message, puis collez le texte de la pièce à la suite :

Convertis la pièce de théâtre ci-dessous en JSON, exactement dans ce format, sans aucun commentaire :
{"title": "...", "author": "...",
 "characters": [{"id": "identifiant-court", "name": "Nom affiché"}],
 "acts": [{"number": 1, "scenes": [{"number": 1, "title": "personnages présents",
   "lines": [{"character": "identifiant-court", "text": "réplique"},
             {"type": "direction", "text": "didascalie"}]}]}]}
Règles : un "id" unique par personnage, en minuscules et sans espace ; chaque réplique utilise l'id de son personnage ; les didascalies ont "type": "direction" ; les numéros d'actes et de scènes sont des entiers ; écris \n à chaque fin de vers ; ne modifie pas le texte.

Voici la pièce :

Enregistrez la réponse dans un fichier qui se termine par .json (par exemple ma-piece.json). Pour une longue pièce, procédez acte par acte puis rassemblez les actes dans un seul fichier. Relisez toujours le résultat : l'IA peut oublier une réplique ou se tromper de personnage. Les erreurs de format, elles, seront signalées par Thalia à l'import.

6. Importer dans Thalia

1. Ouvrez Thalia et touchez Ajouter, puis Créer une pièce.
2. Choisissez votre fichier .json (depuis le téléphone, Google Drive, iCloud…).
3. Si le fichier est correct, la pièce est créée et vous obtenez son code d'invitation, à partager avec la troupe.

Le fichier préparé sur ordinateur ? Envoyez-le vous par email ou déposez-le dans votre cloud pour l'ouvrir depuis le téléphone.

7. Corriger les erreurs

Thalia vérifie tout le fichier avant de créer la pièce et liste toutes les erreurs d'un coup, avec leur emplacement, par exemple :

Acte 1, scène 2, ligne 3 : personnage « orontte » inconnu

Les messages les plus fréquents :

8. Après l'import

Le fichier n'a pas besoin d'être parfait : une fois la pièce créée, vous pouvez modifier le texte directement dans l'application (corriger une réplique, en ajouter, en supprimer, ajouter une didascalie) et ajouter des notes de mise en scène sous les répliques. Toute la troupe reçoit la version à jour.

Il ne reste plus qu'à distribuer les rôles dans l'onglet Personnages, et la troupe peut commencer à répéter.