How tin2tin/blender_screenwriter works
Blender Screenwriter is an add-on for authoring Fountain screenplays and turning them into formatted previews, exports, mindmaps, and sequencer-based animatics in Blender. The main workflow is to edit a Blender text block, parse its Fountain text, then invoke a preview or a Screenplayer generation action. The graph also preserves keyword/object assignment and scene navigation capabilities documented in the README. Relationships are limited to calls or UI actions shown in the excerpts or README; unsampled subsystems are represented at their exact tree paths.
Main entry points: gui.py Sidebar controls · scene_to_strip.py Animatic generation · dual_view.py Dual-view preview · preview_fountain.py Formatted preview
Components 20
Screenplay authoring
- Fountain parser
fountain.py - Formatted preview
operators/preview_fountain.py - Dual-view preview
operators/dual_view.py - Preview lookup
functions/fountain_functions.py - Script editing tools
operators/insert.py - Screenplay export
operators/fountain_export.py - Mindmap generation
operators/mindmap_fountain.py
Screenplayer production
- Keyword assignment
operators/assign_keyword_to_objects.py - Animatic generation
operators/scene_to_strip.py - Scene navigation
operators/switch_to_scene.py - Scene switching
operators/switch_scene.py - Blender sequencer
- Blender scenes and objects
Blender integration
- Sidebar controls
gui.py - Editor discovery
functions/area_functions.py - Scene properties
properties.py - Blender text blocks
Other components
- Blender user
- MindMapper add-on
- Screenplain exporter
Connections 27
- Blender user → Sidebar controls: uses
gui.py - Sidebar controls → Formatted preview: invokes
gui.py - Formatted preview → Blender text blocks: writes preview
operators/preview_fountain.py - Formatted preview → Fountain parser: parses script
operators/preview_fountain.py - Sidebar controls → Dual-view preview: invokes
gui.py - Dual-view preview → Formatted preview: invokes
operators/dual_view.py - Dual-view preview → Preview lookup: gets preview
operators/dual_view.py - Preview lookup → Blender text blocks: reads text block
functions/fountain_functions.py - Dual-view preview → Editor discovery: finds editors
operators/dual_view.py - Editor discovery → Blender text blocks: inspects editors
functions/area_functions.py - Sidebar controls → Script editing tools: offers editing
gui.py - Sidebar controls → Screenplay export: offers export
README.md - Screenplay export → Screenplain exporter: exports via
README.md - Sidebar controls → Mindmap generation: offers mindmap
README.md - Mindmap generation → Fountain parser: parses script
operators/mindmap_fountain.py - Mindmap generation → MindMapper add-on: creates nodes
operators/mindmap_fountain.py - Sidebar controls → Keyword assignment: offers assignment
gui.py - Keyword assignment → Blender scenes and objects: assigns objects
README.md - Sidebar controls → Animatic generation: starts generation
gui.py - Animatic generation → Fountain parser: parses script
operators/scene_to_strip.py - Animatic generation → Blender text blocks: reads screenplay
operators/scene_to_strip.py - Animatic generation → Blender sequencer: creates strips
operators/scene_to_strip.py - Animatic generation → Blender scenes and objects: creates scenes
operators/scene_to_strip.py - Sidebar controls → Scene navigation: offers navigation
README.md - Scene navigation → Scene switching: delegates switching
- Scene navigation → Blender scenes and objects: selects scene
README.md - Sidebar controls → Scene properties: uses settings
gui.py