plotagon-director 0.6.0__py3-none-any.whl

plotagon_director-0.6.0.dist-info/METADATA

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: plotagon-director
+Version: 0.6.0
+Summary: Génération de films Plotagon Studio Desktop (.plot) avec voix Edge TTS et synchro labiale
+Author: Mohamed Amine Ben Mallessa
+License: MIT
+Project-URL: LinkedIn, https://www.linkedin.com/in/benmallessa/
+Keywords: plotagon,tts,video,animation
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Requires-Dist: edge-tts
+Requires-Dist: soundfile
+Requires-Dist: numpy
+Requires-Dist: truststore
+Provides-Extra: library
+Requires-Dist: UnityPy; extra == "library"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: UnityPy; extra == "dev"
+Dynamic: license-file
+
+# Plotagon Director
+
+Génération de films [Plotagon Studio Desktop](https://www.plotagon.com) de
+bout en bout : écriture du scénario en YAML, validation contre la bibliothèque
+de ressources réelle, génération d'un fichier `.plot` importable dans
+l'application officielle — avec voix custom Edge TTS et synchro labiale.
+
+Le format `.plot` a été entièrement rétro-ingénieré et confirmé par analyse
+d'exports officiels (v1.11.0) : ZIP contenant un document JSON `.plotdoc`
+(liste plate d'instructions `scene`, `dialogue`, `music`, `action`) et, par
+réplique vocalisée, un WAV mono 44,1 kHz + un fichier `.phonemes` (protobuf)
+pour la synchro labiale. Spécification complète : `docs/PLOT_FORMAT.md`.
+
+## Installation
+
+```bash
+pip install -e .                 # depuis un clone: commande `plotagon-director`
+# ou directement depuis GitHub :
+pip install git+https://github.com/mohamed-amine-ben-mallessa/plotagon-director.git
+```
+
+La bibliothèque de ressources (`library.json`) est embarquée dans le package :
+le générateur fonctionne sans installation Plotagon. L'extra `[library]`
+(`pip install -e .[library]`, ajoute UnityPy) n'est nécessaire que pour
+**reconstruire** la bibliothèque depuis une installation Plotagon.
+
+## Usage
+
+```bash
+# Écrire un scénario
+plotagon-director new "Mon film"              # squelette commenté
+plotagon-director list scenes --filter cafe   # aussi: characters, expressions,
+plotagon-director list actions                #   music, sounds, voices
+plotagon-director positions restaurants.cafe  # slots d'acteurs d'une scène
+plotagon-director voices fr                   # voix Edge TTS disponibles
+plotagon-director say "Bonjour" fr-FR-DeniseNeural  # écouter une voix
+
+# Valider puis générer
+plotagon-director validate mon-film.yaml [--strict]
+plotagon-director build mon-film.yaml mon-film.plot
+#   --no-voices : hors ligne | --srt subs.srt : sous-titres
+#   --no-cache : resynthétise tout (sinon cache TTS automatique)
+plotagon-director batch scenarios/ sorties/   # tous les .yaml d'un dossier
+
+# Importer mon-film.plot dans Plotagon Studio (menu import)
+
+# Analyse / rétro-ingénierie
+plotagon-director parse export.plot           # JSON brut d'un .plot
+plotagon-director decompile export.plot film.yaml   # .plot -> YAML éditable
+plotagon-director diff avant.plot apres.plot  # isoler un format inconnu
+plotagon-director doctor                      # diagnostic environnement
+
+# (Reconstruire la bibliothèque depuis une installation Plotagon)
+python -m plotagon_director.library.builder [chemin/builtincontentmanifest.json]
+```
+
+## Exemple de scénario
+
+```yaml
+project:
+  title: "Conversation au café"
+
+cast:
+  - ref: paul
+    character: news.paul
+    name: "Paul"
+    voice: fr-FR-HenriNeural      # optionnel : voix Edge TTS (+ rate/pitch)
+  - ref: lucy
+    character: news.lucy
+    name: "Lucy"
+    voice: fr-FR-DeniseNeural
+
+scenes:
+  - scene: restaurants.cafe
+    music: music.corny            # optionnel (music.stopmusic pour arrêter)
+    actors:
+      - ref: paul
+        position: Table1          # `plotagon-director positions restaurants.cafe`
+      - ref: lucy
+        position: Table2
+    dialogue:
+      - actor: paul
+        expression: happy
+        text: "Bonjour Lucy !"
+        camera: wide shot         # optionnel : 10 types (docs/PLOT_FORMAT.md)
+      - actor: paul               # interaction à 2 personnages
+        action: handshake
+        target: lucy
+```
+
+Bibliothèque embarquée : 205 scènes (953 positions), 53 personnages,
+88 expressions, 15 actions, 38 musiques, 132 sons.
+
+## Architecture
+
+- `plotagon_director/core/` — modèle `.plotdoc`, conteneur ZIP, validateur,
+  décompilateur, diff
+- `plotagon_director/audio/` — Edge TTS → WAV conforme (cache + parallèle),
+  phonèmes/lip-sync
+- `plotagon_director/library/` — builder du catalogue + `data/library.json`
+- `docs/` — rétro-ingénierie du format (`PLOT_FORMAT.md`), API interne de
+  l'appli (`APP_JS_ANALYSIS.md`), état des connaissances (`FINDINGS.md`)
+- `SKILL.md` — utilisation comme skill Claude Code
+
+## Principes
+
+- Aucun mod, aucun binaire tiers, aucun credential.
+- Installation officielle en lecture seule.
+- Seuls les éléments confirmés par un export officiel sont générés ; le
+  reste (effets visuels, sons importés) est documenté UNKNOWN dans
+  `docs/FINDINGS.md`.
+
+## Tests
+
+```bash
+python -m pytest tests/ -q
+```

plotagon_director-0.6.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+plotagon_director/__init__.py,sha256=mcO39uUlfKH-4JWkU8ODKOBQALUPC-vj65q7NwD8FG0,104
+plotagon_director/cli.py,sha256=0DcheP1hp2NtsJ6AhAK0L2LBtN29w1yBBsEe59rUPGI,11491
+plotagon_director/audio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plotagon_director/audio/phonemes.py,sha256=_FhBDoRZcqloRE4or4V42F5zQ7UdDr78AwApDuuLuvY,2294
+plotagon_director/audio/tts.py,sha256=4SAUIoLD4Ul-HbCmkJ3jQn6yIBqTr3FCdVn8fb7xHsM,4914
+plotagon_director/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+plotagon_director/core/archive.py,sha256=eE9qx9euknOLX3A4kwvsV8V6qQFWQ1FkmbIqSz0qGPM,1210
+plotagon_director/core/decompiler.py,sha256=_L50sLj-7uunLcM4ipQeab2q0TVlbM-RQDudKI_nUrI,4226
+plotagon_director/core/diffplot.py,sha256=6BbfxvMoBLnIeCybS_mDpvC0Qbe7wnU1PQH-pRHHvMw,3313
+plotagon_director/core/doctor.py,sha256=VORT_F-Bos4b03nx3_Ss15NHI1f5TjInjNRHaGqXIrA,2524
+plotagon_director/core/plotdoc.py,sha256=DYPXo8DnaNzIBDPL9CRnNzB8ZYaHTvd6Zn3aWSKO-aw,6717
+plotagon_director/core/validator.py,sha256=GEN9iFonjtd9xOziCdlSdKs4y1b9dBBekt8IHrEgaOw,6418
+plotagon_director/library/__init__.py,sha256=r-yJRvTfeKD8_dt088I-BJPNLLhvLP3VAGKdoRsZ3cw,407
+plotagon_director/library/builder.py,sha256=pYVT-meNhw7udRznJWerUCiHNBkdMUYy-lgRWkIaWAE,5387
+plotagon_director/library/data/library.json,sha256=yZnDikbNOFsqTeLD2lnFOIv4KG3wyLgnpmFI12_eyTQ,103103
+plotagon_director-0.6.0.dist-info/licenses/LICENSE,sha256=h_HNM_Q86IV2VZ6kIbI7InhxT3xgJOzHqyu7Qcn28M4,1083
+plotagon_director-0.6.0.dist-info/METADATA,sha256=kScCHFpPZi_0nBaezMu96n5vEU43pd0Kb0ne84v4cvc,5409
+plotagon_director-0.6.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+plotagon_director-0.6.0.dist-info/entry_points.txt,sha256=OAM5qd6FEEMAzOs7-jExJZUyZH1NepZ5MtuJzORoc0Q,65
+plotagon_director-0.6.0.dist-info/top_level.txt,sha256=hNkyEFDlOAVgwKtLzmG7BuzvuwHFHE6MRScgAOFvwRY,18
+plotagon_director-0.6.0.dist-info/RECORD,,

plotagon_director-0.6.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

plotagon_director-0.6.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+plotagon-director = plotagon_director.cli:main

plotagon_director-0.6.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Amine Ben Mallessa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

plotagon_director-0.6.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+plotagon_director