Transforming Static Scripts into Living Performances.
Narrative Soundstage is an intelligent script-to-performance engine designed for screenwriters, showrunners, and game designers. Whether you are prepping for a film competition or refining the dialogue flow of a narrative-heavy RPG, this tool bridges the gap between the page and the performance.
Most screenplays die in the "silent read." Writers often miss pacing issues, repetitive dialogue, or tonal shifts because they can't hear the script. Narrative Soundstage solves this by providing:
- Dynamic Casting Office: Automatically detects characters in your
.docxscript and assigns distinct, high-fidelity AI voices. - Active-Line Prompter: A real-time, high-contrast performance monitor that scrolls with the audio—perfect for spotting "ear-sores" during table reads.
- The "Unicorn" Architecture: Built by a Creative Technologist & Narrative Strategist, the app combines deep narrative logic with asynchronous Python performance.
- Studio Controls: Fine-tune playback speed and line buffers to match the specific "vibe" of your scene, from fast-paced action comedies to slow-burn legal thrillers.
- Audio Engine: Powered by
edge-ttsfor resonant, natural-sounding vocal performances. - Async Processing: Uses
asyncioto handle voice synthesis without blocking the UI. - Smart Parsing: Custom Regex patterns to distinguish between Scene Headings (INT/EXT), Dialogue, and Narrator-driven Action Lines.
- State Management: Comprehensive undo/redo stacks and session persistence for real-time script editing.
Visit the live deployment on Streamlit Community Cloud (Link above) to upload your script and start your virtual table read instantly.
- Clone the Repo:
git clone [https://github.com/IdaAkiwumi/Narrative-Soundstage.git](https://github.com/IdaAkiwumi/Narrative-Soundstage.git)
- Install Dependencies:
pip install streamlit python-docx edge-tts
- Launch the Studio:
streamlit run main.py
- Upload: Drop your
.docxscreenplay into the uploader. - Cast: Open the "Casting Office" to assign voices to your protagonists, antagonists, and narrator.
- Listen & Edit: Hit PLAY. When you hear a line that doesn't "land," hit EDIT, tweak the text, and the engine updates your script in real-time.
- Export: Download your polished, production-ready
.docxfile directly from the sidebar.
- Screenwriters: Hear the "Soul" in your legal thriller or the "Ghost" in your rom-com before you submit to competitions.
- Producers: Conduct low-cost initial table reads to check script length and pacing.
- Game Designers: Test branching dialogue flow and character distinctness.
If this tool helped you nail your script competition or streamlined your pre-production workflow, consider supporting the continued development of AI-assisted narrative tools:
Developed by Ida Akiwumi Creative Technologist | Narrative Strategist | Screenwriter Enthusiast
Bridging the gap between code and story.