View on GitHub

DigiScript

Digital Script for Theatre Cues

Configuring a Show

Microphone and Microphone Allocations

Once Characters, Acts and Scenes have been configured, you can optionally choose to configure microphones used throughout the show and assign them to characters. This is done from the Mics tab in the Show Config page.

Setting Up Microphones

Navigating to the Mics tab will initially show an empty microphone list:

Click the Add button to create a new microphone. Each microphone must have a unique name for the show. After adding microphones, they will appear in the microphones overview:

You can use the Edit and Delete buttons to manage existing microphones.

Configuring Microphone Allocations

Once microphones have been created, you can configure their allocations by going to the Allocations tab. This displays a matrix showing each character against each scene in the show:

To assign a microphone to a character, follow these steps:

  1. Select a microphone from the dropdown box at the top of the page
  2. The table will update to show the allocation view for that microphone:

  1. Click on individual cells in the matrix to allocate or de-allocate the selected microphone to a character for that specific scene
  2. Cells will highlight to show where the microphone is currently allocated:

Allocation Constraints

Multiple Microphones Per Character

DigiScript supports assigning multiple microphones to a single character in a scene. This is useful for:

To assign multiple microphones to a character:

  1. Select the first microphone from the dropdown and allocate it to the character
  2. Select the second microphone from the dropdown and allocate it to the same character
  3. The character will now show both microphones in the view mode (e.g., “Mic 1, Mic 2”)

In the Timeline view, characters with multiple microphones will display stacked bars showing all assigned microphones with consistent color-coding.

Saving Allocations

After making your allocations, click the Save button to confirm your changes. Once saved, the table will display the final allocation showing which microphone is assigned to which character in each scene:

The saved view provides a clear overview of microphone usage throughout the entire show, helping sound engineers plan microphone management and character coverage.

Conflict Detection

DigiScript automatically detects potential microphone conflicts when the same microphone is allocated to different characters in adjacent scenes. Conflicts are tracked individually per microphone - a character with multiple microphones may have conflicts on some mics but not others. Conflicts are highlighted in the allocations matrix to alert you to quick-changes that may require attention:

Hovering over a highlighted allocation shows:

When a character has multiple microphones, the tooltip will clearly indicate which microphone(s) have conflicts, allowing you to plan changeovers for specific microphones while others remain assigned.

Microphone Timeline View

The Timeline tab provides a visual representation of microphone allocations across all scenes in the show. This view helps you understand allocation patterns and identify conflicts at a glance.

Timeline Features

Using the Timeline

  1. Select your preferred view mode using the buttons at the top
  2. Scroll horizontally to see all scenes in large shows
  3. Click on allocation bars to see detailed information
  4. Colors are automatically assigned to distinguish different entities

Scene Density Heatmap

The Density tab visualizes technical complexity by showing how many microphones are active in each scene. This helps identify technically demanding scenes that may require additional crew or planning.

Heatmap Features

Interpreting the Heatmap

Resource Availability Dashboard

The Availability tab provides a comprehensive overview of microphone resource planning across the entire show. This view helps with inventory management and resource allocation.

Dashboard Features

Using the Availability Dashboard

  1. Review summary statistics to ensure sufficient microphone inventory
  2. Check the utilization rate to identify over or under-provisioning
  3. Scan the scene-by-scene breakdown for scenes with conflicts
  4. Click on microphone cards to see detailed allocation information
  5. Use conflict indicators to identify scenes requiring changeover planning