Screenplay Settings
Screenplay settings allow you to customize how the screenplay format integrates with your assets and control automatic entity creation behavior.
Accessing Screenplay Settings
- Click on Settings in the sidebar
- Select Screenplay from the settings menu
Auto-Create Options
Auto-Create Characters
When enabled, character names typed in Character elements are automatically created as entities in your linked character asset group.
- Enabled (default): Characters are created automatically when you finish typing a character name
- Disabled: No automatic character creation; you can still create characters manually
Auto-Create Locations
When enabled, locations extracted from Scene Headings are automatically created as entities in your linked location asset group.
- Enabled (default): Locations are created automatically from scene headings like
INT. COFFEE SHOP - DAY - Disabled: No automatic location creation; you can still create locations manually
The app intelligently parses scene headings to extract just the location name. For example, from INT. COFFEE SHOP - DAY, only "COFFEE SHOP" is extracted as the location.
Linked Asset Groups
Screenplay format needs to know which asset groups should store your characters and locations.
Character Asset Group
The asset group where screenplay characters will be created.
To change:
- Open Screenplay Settings
- Find "Characters Asset Group"
- Select an existing asset group from the dropdown, or
- Select "Create New..." to create a new asset group
Location Asset Group
The asset group where screenplay locations will be created.
To change:
- Open Screenplay Settings
- Find "Locations Asset Group"
- Select an existing asset group from the dropdown, or
- Select "Create New..." to create a new asset group
Current Configuration
The settings page shows your current configuration:
- Characters linked to: Shows which asset group receives character entities
- Locations linked to: Shows which asset group receives location entities
If either shows "Not configured", you'll need to select an asset group before auto-creation can work.
Saving Changes
After making changes:
- Click Save Changes to apply your new settings
- The button is only enabled when you've made changes
Changes take effect immediately for new screenplay content.
Duplicate Prevention
The auto-create feature includes intelligent duplicate detection:
- Before creating an entity, the system checks if a character or location with that name already exists
- Existing entities are not duplicated
- This works across all your asset groups, not just the linked ones