User Manual

Introduction

Welcome to the Instruction Manual for "Work With Script".

This software is a specialized environment designed specifically for the production, post-production, and delivery stages of your project.

Rather than a tool for initial script drafting, "Work With Script" is a powerful workspace built to help production teams, script supervisors, accountants, and coordinators refine, protect, and track a screenplay as it transitions from the page to actual production.

What You Can Do in "Work With Script"?

This manual will guide you through the core modules designed to bridge the gap between the script and the crew:

• Script Refinement: Easily edit scene action, dialogue, character names and update other script elements while the software automatically manages industry standard formatting, line numbers, and margins.
• Production Injections: Embed non-textual instruments called "injection boxes" directly into the chronological flow of your script. This includes among others Board Injections for storyboards and visual continuity, Music Injections for live MIDI tracking and notation playback, and Sheet Injections for managing complex logistics like budgets, call sheets, and costume logs.
• Comprehensive Export Options: Deliver your work exactly how your crew needs it. Generate industry-standard clean screenplays, interactive digital files for collaboration, or specialized analytical documents isolated by department.

2. Project Manager

2.1 Project Browser Overview

When you launch the software, you will be greeted by a splash screen while your assets load. Once ready, a Project Browser will appear.

The Project Browser is the central hub for managing your work. From this window, you can create new projects, access recent work, and manage your user profile.

Projects Sidebar

• User Profile: Located in the top-left corner, this section displays your current profile information.
• Create New Project: Use this button to create a new project folder with hierarchy.
• Load Project & Import Injection: Below the creation button, you will find the options for accessing existing data.
• Instruction Manual: You can open the instruction manual online and locally as a PDF shipped with the software.
• Support & Feedback: At the bottom of the sidebar, you can access the buttons to contact the development team.

Projects Dashboard

The central area of the screen displays your Recent Projects. Each project you open is added to this list for quick access as a Project Card. Each Project Card provides a summary, including the project title, file path, and the "Last opened" timestamp.

Global Controls

• Clear: Click this button to remove the list of recent projects from your dashboard.
• Close icon (×): Use this to exit the Project Browser.

2.2 Profile Management

The software allows you to create and manage multiple user profiles to personalize your experience, track authorship, and maintain individual settings.

Why use Profiles?

• Authorship: Comments and notes added to the script are tagged with your profile name and color, making it easy to track who made which suggestion in a collaborative environment.
• Personalized Settings: Key preferences, such as the zoom level or color theme, are saved independently for each Profile. This allows different users on the same device to have their own optimized view.

Creating a Profile

To add a new profile, click the "Profile" button (displaying your current avatar and name) to open the profile dropdown. Click the "Add New Profile" button at the bottom of the dropdown list. Fill in the Profile Details:

• Profile Image: Click the avatar area to browse files or drag and drop an image onto the dropzone.
• Name: Enter your display name as you want it to appear on comments and project metadata.
• Email: Providing an email address helps with identification and is used as a default for support and feedback reports.
• Comment Bar Color: Choose the color for your comment bar to enable easy, color-coded navigation.

To apply changes, click the "Save" button. New profiles are automatically set as active.

Managing Profiles

• Access: Click the "Profile" button to open the profile dropdown, which displays a list of all available profiles.
• Switch: Click any profile name in the dropdown list to immediately switch to that Profile.
• Edit: Click the Edit icon (✎) next to any profile in the list. To apply changes, click the "Save" button.
• Delete: Click the Delete icon (×) to remove a profile. You cannot delete the profile that is currently active; you must switch to another profile first.

2.3 Creating a New Project

To create a new hierarchy for your project, click the "Create New Project" button in the left sidebar of the Project Browser.

When you create a project, the software automatically generates a folder hierarchy:

• gallery/: For images, videos, and drawings.
• music/: For audio tracks and notation.
• exports/: Destination for the exported files.
• backup/: Automatic safety copies.

You can edit the hierarchy according to your needs later, e.g., adding subfolders for costumes or continuity images.

Enter a unique title for your project in the name field and select a destination folder on your device where all project-related data will be stored. Click the "Create Project" button. Once the project is initialized, a Workspace will open automatically.

Note: Your project data is stored in a .wws file (e.g., MyProject.wws). Never manually edit this file. Every project is assigned a unique ID (e.g., proj_a7f3b9c2e1d4).

2.4 Load Project

Click the "Load Project" button in the sidebar to reveal a dropdown menu with several loading methods:

• Load Project: The standard way to open a .wws project file from your computer.
• Connect Project Folder: Use this function if your project is stored as a folder hierarchy rather than a single file. It will scan the folder for .wws files and link all associated assets (Gallery, Music, etc.) automatically.
• Load Autosave: A recovery tool that allows you to browse and restore from automatic backups of your projects. You will first be asked to select the original project file to find matching backups.

2.5 Importing Injections (.wwsel)

If you have exported specific injection elements (like board files or music notation) from another project, you can bring them into your current workspace:

• Ensure you have a project already open.
• Click the "Import Injection" button in the Project Browser sidebar.
• Select the .wwsel file you wish to import.
• The software will automatically register any new gallery items, board files, music notation and all injection related items included in the package.

2.6 Recent Projects

The main area of the Project Browser displays a dashboard of your Recent Projects. Each project you open is added to this list as a Project Card for quick access.

• Projects are automatically sorted by the date they were last opened.
• By default, cards show the project name and its root folder. Alt-Click (or Option-Click on Mac) any card to display the full file path.
• Double-click any project card to open it immediately.
• Right-click any project card to open a Context Menu. This is useful if a project folder contains multiple .wws files — the menu allows you to choose exactly which project file to launch.
• To remove a card from the recent list, click the Delete icon (×) in the top right corner of a card. Use the "Clear" button to empty the recent projects dashboard. This does not delete the project file from your computer.

2.7 Instruction Manual

A detailed instruction manual is available as a PDF via the "User Manual" button, shipped with the software. To open the online version of the manual, click the Web icon.

2.8 Support & Feedback

Located at the bottom of the sidebar, these tools allow you to communicate with the development team.

• Report a Bug: If you encounter an error or unexpected behavior, click "Report a Bug". A form will appear. The email associated with your profile will be filled in automatically as the contact address. Please provide a clear topic and a detailed description of what happened.
• Send Feedback: Use this button to tell us what you think of the software, suggest new features or improvements.

3. Script Editor Basics

3.1 Script Editor Overview

Once you have selected or created a project in the Project Manager, the Script Editor opens. This is the core environment where you will spend most of your time managing project elements. The workspace is organized around a central script canvas, with tools arranged in the top toolbar and navigation widgets positioned around the edges.

3.2 Global Controls (Top Toolbar)

The central top toolbar provides quick access to essential global actions.

Load Script

Click the "Load Script" button and select your script file. The software supports the following file types: PDF (.pdf), Word Documents (.docx), Plain Text (.txt), and Rich Text Format (.rtf). The software will parse the text and convert it into numbered editable lines that appear in the central script area.

Projects

The "Projects" button brings you back to the Project Browser screen to view all your projects. To return to the Script Editor, simply close the Project Browser by clicking the Close icon.

Save

The "Save" button has a dropdown menu with several options:

• Save: Standard overwrite of your project file.
• Save Iteration: Saves a numbered version (e.g., "Project_v2.wws") to keep a history of your progress.
• Save For: Creates a specialized version for a specific crew member (e.g., Director) with optional read-only locks.

Export

The "Export" button opens the Export Window — a comprehensive tool for sharing your work, creating production documents, and archiving different versions of your project. The left sidebar displays four specialized export modes: Project, PDF, Music, and Sheets.

3.3 Mode Switch

The Script Editor operates in two primary modes. You can toggle between them using the Mode icon in the top toolbar or by pressing the "Tab" key.

• Edit Mode (Default): Your primary creative environment with full interactivity. All "plus" buttons for adding injections and margin controls are visible and active. As you type, the script will automatically repaginate and adjust to accommodate your changes.
• Read Mode: A specialized locked state designed for review, table reads, and distraction-free navigation. Editing UI elements are hidden and script text is set to read-only. You can still highlight, change line types, and comment.

3.4 Toolbar Actions

Highlight

Select any text and click the Color Swatch button in the top toolbar to apply a highlight color. You can also press the "H" key to toggle highlight on or off instantly.

Settings

Click the Settings icon in the top toolbar to open the Settings Panel. It is divided into three groups: General Settings (language, region, autosave intervals, undo depth), Appearance Settings (themes, custom themes, UI scaling), and Screensaver Settings (custom video, reset to default).

Safeguard (Shield)

By default, the Safeguard function requires you to hold the "Delete" button for 2.5 seconds (until it is "full") to prevent accidental deletion of lines and injections. To delete elements in one click, toggle the Safeguard icon.

3.5 Navigation Tools

Page Jump

Enter a page number and press the "Enter" key to navigate the script page instantly.

Gallery

The Gallery is your project-wide library for all visual assets. Click the Gallery icon for quick access to images, videos, and drawings. Media items are automatically organized by upload date. You can search, select, and add them directly to the script.

Archive

The Archive acts as a powerful safety net, capturing every significant deletion made within your project — line deletions, injections in their entire internal state, and metadata with timestamps. You can restore entries or permanently delete old data to keep your project file size small.

Overview

The Overview panel provides a structural map of your entire project. Every scene heading is listed as a primary branch, with injections and content appearing nested under their respective scenes. Double-click any item to scroll the script directly to that location.

3.6 Zoom & Shift

In the bottom-right corner, you will find the Zoom & Shift widget. Use the Zoom Slider to adjust the size of the script. When using injections located on side panels (e.g., Draw, Sheets), the Script Shift Slider appears — use it to shift the script to the left, preventing it from being covered.

Click the percentage value to toggle "Off-screen" mode for maximum tool space.

3.7 Screensaver

The software includes a cinematic Screensaver that provides a theatrical "rolling down the screen" effect, perfect for leaving the workspace active during breaks or presentations.

• Enable: Click and drag the small circle handle (the "rope") at the very top of the window down past the toolbar.
• Retract: Press the "Esc" key to roll the screen back up.
• Shortcut: Ctrl+Shift+L (or Cmd+Shift+L on Mac).
• Play / Pause: Click anywhere on the screensaver canvas.
• Mute: Press the "M" key on your keyboard.
• You can change the screensaver video and mute toggle from the Settings Panel.

4. Read Mode

Read Mode is a specialized locked read-only state designed for distraction-free review, table reads, and navigation. Script text and injections are set to read-only, preventing accidental edits while you scroll or present. Editing UI elements such as "Add Injection" buttons are hidden for a cleaner view.

In Read Mode, you can still interact with the script for review purposes. Select any text and right-click to open the context menu with a list of available actions:

• Highlighting
• Change Line Type (Change to…)
• Commenting

Note: Access to the context menu via right-click is available only in Read Mode.

4.1 Highlight

The software includes a robust highlighting system to help you mark important passages, track character arcs, or note production requirements.

Ways to Apply and Remove Highlights

• Shortcut: Select text and press the "H" key to toggle highlight on or off instantly.
• Context Menu: Right-click any selected text and choose "Highlight / remove highlight" from the menu.
• Toolbar: Select the text, click the Color Swatch button in the top toolbar, and choose a color to apply.
• Clear: Open the Color Swatch and click the "Clear" button to remove highlights from the selected range.

Color Customization

Click the Color Swatch button to open the Color Picker:

• Presets: A grid of standard production colors for quick selection.
• Default Swatch: Reset to the standard highlight color at any time using the textured Default Swatch.
• Custom Color: Select the Custom Color box and use the HSB Color Field to pick any specific hue. You can also enter precise HEX codes for consistent branding or production coding.
• Personal Palette: Save your favorite colors to your Personal Palette (up to 24 slots). Select a custom color, click the "Palette" tab, then click the "+" icon to save. Colors are saved to your profile and persist across sessions.

4.2 Change Line Types (Change to…)

The software uses an intelligent screenplay parser to identify Scene Headings, Action, Characters, Dialogue, and Transitions. If a line is misidentified or you need to restructure a scene, you can manually reclassify any line.

How to Change Line Type

• Click and drag to select the text you want to change, then right-click.
• In the context menu, click "Change to". Choose the desired classification from the submenu:
  • Scene Heading: For location and time-of-day markers.
  • Action: For descriptive physical movements and scene descriptions.
  • Character: To identify who is speaking.
  • Dialogue: For the spoken words of a character.
  • Transition: For markers like "CUT TO:" or "FADE OUT."

Intelligent Reflow

When you change the type of multiple lines, the software performs an Intelligent Reflow:

• Sequential lines converted to the same type may be merged into a single cohesive paragraph.
• The margins and indentation will be automatically adjusted to match the new type's screenplay standards.
• Line numbers will be automatically recalculated and updated throughout the script.

4.3 Comments

The software features a powerful commenting system that allows you to provide feedback, suggestions, and production notes directly on the script without altering the original text.

How to Add a Comment

• Click and drag to select the specific passage of the script you wish to comment on.
• Right-click to open the context menu on your selection and choose "Add Comment".
• The Comment Window will open, showing the line numbers of the quoted text, the quoted text, formatting tools (Bold, Italic, Underline), and the field for your comment.
• Click "Save Comment" to add it to the project.

Every comment is automatically tagged with the name and color of the active Profile. This allows teams to track who made which suggestion.

Viewing and Managing Comments

Once a comment is added, it is visible in two main areas:

• Overview > Comment Tab: All comments appear as cards with the line number(s), the quoted text, and your comment.
• Comment bars in script: Vertical color-coded bars appear in the left margin next to commented lines. The color can be changed in Profile Settings.

To scroll the script to the commented passage immediately, click any comment card in the Overview > Comment tab. To open and edit a comment, Ctrl+Click (or Cmd+Click on Mac) any vertical comment bar, or click the Expand Comment icon on the comment card. To delete a comment, click the Delete icon on the comment card.

Note: Only the author of a comment can edit its text or delete it.

5. Edit Mode

Edit Mode is the software's primary creative workspace, designed for drafting, structuring, and enriching your project. It allows you to build a multi-dimensional project where technical and visual planning coexist alongside the dialogue and action.

In this mode, the software is organized into two main functional groups: Injections and Script Changes.

• Injections: Modular containers injected directly into the flow of your script, holding both textual and non-textual assets (e.g., storyboards, musical scores, production tables).
• Script Changes: Direct interactions with the screenplay text. You can adjust dialogue and action, manage structure, insert or delete rows, and the editor handles professional script formatting automatically.

5.1 Injections: General Information

Injections are modular containers positioned between the lines of your script. They hold supplemental information that supports the scene without cluttering the primary screenplay text.

Add Injection

There are two primary ways to insert a new injection:

• Plus Icon (+): Hover the cursor between any two lines of the script. A small "+" icon appears in the margin. Clicking it instantly creates a new injection box at that location. The injection box is added on a new line below the selected line; the following lines are reorganized accordingly.

Injection Types

Injections can be switched between five specialized types via tabs at the top: Notes, Script, Board, Music, and Sheet. Each type is tailored to distinct tasks with unique functionalities.

General Settings

• Line Range: This field is visible across all injection types but is only functional when the injection is set to Script mode — there you can enter a "from" and "to" row number (for example, from row 010 to row 016) to replace those specific rows inside the script. For all other injection types this field has no effect; the applied content is placed in a newly created row directly above the injection box instead.
• Title Box: Optionally give your injection a title for better organization and collapsed view navigation.
• Collapse / Expand: Click the Collapse button to save vertical space. A collapsed injection appears as a yellow bar showing the title and type. Click "Edit" on the bar to expand it back.
• Apply to Script: Click the "Apply to Script" button to save the injection contents to the script. Special case: Sheet injection cannot be applied to the script because of its large size.
• Delete: Click the Delete icon to remove an injection box. If the Delete Safeguard is active, hold the button for 2.5 seconds to confirm. Deleted injections remain available in the Archive.

5.2 Script Changes

This functional group covers all direct interactions with the screenplay text. Edit Mode gives you full authority over the content and architecture of your script, from writing dialogue to managing the sequence of rows.

Manual Row Management

You can manually alter the structure of your script using the Context Menu, accessible by right-clicking any line number in the gutter:

• Insert Row Above / Below: Quickly add empty rows to expand a scene or insert new beats.
• Delete Row: Remove unwanted lines. The Delete Safeguard requires you to hold the "Delete row" button for 2.5 seconds. You can deactivate it by toggling the Safeguard icon in the top toolbar.

Whenever rows are added or removed, the entire script is instantly renumbered to maintain a perfect chronological sequence.

Direct Corrections

To write in lines directly, click any line and start typing. Use the Up Arrow and Down Arrow keys to jump between script rows while maintaining your horizontal cursor position. The software calculates and applies the correct margins and spacing rules for different text types, maintaining industry standard formatting throughout the document. Changes to Scene Headings are updated live in the project Overview.

This function is designed for small corrections affecting one line at a time. For larger changes, use the Script injection. To change text types, use the Script injection's Text Type dropdown or the Read Mode context menu.

6. Injection Boxes

Injection boxes are modular containers positioned between the lines of your script. They are designed to hold supplemental information that supports the scene without cluttering the primary screenplay text. Each injection box can be collapsed to a compact bar showing its title and type, helping you keep the workspace tidy while preserving access to rich production data.

There are five specialized injection types, each tailored to a distinct production task:

Note on Line Range: The "from" and "to" row field (for example, from row 010 to row 016) is visible across all injection types but is only functional when the injection is set to Script mode. Only Script can replace specific rows inside the script using this range. For Notes, Music, and Board injections this field has no effect — their applied content is placed in a newly created row directly above the injection box instead.

6.1 Notes Injection

The Notes injection is a flexible, rich-text workspace designed for brainstorming, research, and general reminders. It serves as a creative scratchpad embedded directly within the script's flow. Applied notes appear in italics with a distinct background color and can be color-coded using the Color Dot marker for easy categorization (e.g., set design vs. actor cues).

6.2 Script Injection

The Script injection is a powerful drafting tool for experimenting with alternative versions of a scene. This is the only injection type where the "from" and "to" row field works — you specify exactly which rows of the script should be replaced (for example, from row 010 to row 016) and write your new version in the text field. The software automatically counts how many rows are needed and applies industry-standard formatting. Replaced rows are tagged with a reference to the source injection and moved to the Archive for safety.

6.3 Board Injection

The Board injection provides a professional interface for integrating visual references, storyboards, and videos directly into the script's chronological flow. You can upload images (JPEG, PNG, SVG) and videos (MP4, MOV), add existing assets from the Project Gallery, or create your own sketches using the built-in drawing tools. When applied, the visuals appear in single, reel, or grid layout.

6.4 Music Injection

The Music injection is a musical composition and playback tool integrated directly into the script editor. You can upload MP3 and WAV files, record live MIDI performances using a virtual or physical keyboard, or type music notation manually using abbreviations and shortcuts. Music boxes can be connected in sequence or parallel, and applied to the script as notation or as an audio waveform player.

6.5 Sheet Injection

The Sheet injection provides a professional, structured workspace for spreadsheet management directly within your project. It supports six specialized spreadsheet types: Budget, Production Plan, Scheduling (Call Sheet), Continuity Log, Costume, and Freeform. Unlike other injection types, Sheet injections cannot be applied to the script because of their size; instead, data is exported in CSV or PDF format.

7. Notes Injection

The Notes injection is a flexible, rich-text workspace designed for brainstorming, research, and general reminders that support your writing process. It serves as a creative scratchpad embedded directly within the script's flow without being part of the screenplay.

7.1 Adding Notes

Type your notes, thoughts, and reminders into the Text Field. The notes area includes a dedicated toolbar for styling text with Bold, Italic, and Underline formatting. You can also organize your thoughts using Bulleted or Numbered Lists for better clarity.

7.2 Applying Notes to Script

When you click the "Apply to Script" button, the software converts your notes into a Note within the main script area. Applying Notes does not delete the injection box — the box moves to a newly created row directly above the injection box, allowing you to continue refining your ideas while the key information is visible in the primary script view.

Applied Notes are automatically displayed in italics and with a specific background color to differentiate them from standard action or dialogue lines.

7.3 Color-Coded Markers

Each applied Note features a Color Dot next to its line number. Clicking this dot lets you change the Note's color, helping you categorize different types of information (e.g., set design vs. actor cues). The Color Picker offers preset colors, custom HSB/HEX selection, and a Personal Palette.

8. Script Injection

The Script injection is a powerful drafting tool designed for experimenting with alternative versions of a scene. It allows you to write, refine, and reclassify script snippets in a sandbox environment before integrating them into the project.

8.1 Line Range Replacement

The Script injection is the only injection type where the Line Range field is functional. By setting a "from" and "to" row number in the header (for example, from row 010 to row 016), you tell the software exactly which rows inside the script should be replaced with the new version you write in the text field. This allows you to swap out dialogue, action lines, or any other script content — row by row — without affecting anything outside that range.

Type the new version of the script into the Text Field. The software will automatically count how many lines will be needed when the text is applied to the script. The result is displayed in the Line Counter.

8.2 Action vs. Dialogue

You can explicitly define the type of text you are writing using the Text Type dropdown menu. This ensures that when you apply your changes, the software automatically applies the correct industry-standard formatting and spacing to the new lines.

You can also emphasize parts of your new script with Bold, Italic, and Underline formatting, or organize it using Bulleted or Numbered Lists. Note that this formatting applies only within the Script injection box, not to the applied script lines themselves.

8.3 Apply to Script

Clicking the "Apply to Script" button triggers a replacement process:

• Automated Substitution: The software removes the lines defined in your Lines Range and inserts your new text in their place, maintaining chronological order, renumbering subsequent lines, and recalculating the necessary margins automatically.
• Tracking: Replaced lines are tagged with a reference to the source injection, which can be viewed in the Project Overview, helping you track where specific changes originated.
• Archive Integration: For safety, the original lines that were replaced are automatically moved to the Archive, allowing you to recover your previous draft if you change your mind.

9. Board Injection

The Board injection serves as a professional interface for integrating visual references, assets, and storyboards in the form of images or videos directly into the script's chronological flow. You can add visuals through two primary methods: importing visual assets or drawing directly in the injection.

9.1 Importing Visual Assets

This function allows you to upload external media files. The software supports common image formats (JPEG, PNG, SVG) and video files (MP4, MOV).

• Direct Upload: Click the "Upload" button and select the visual type (images or video) from the dropdown menu. To upload multiple visuals, select the "Reel" or "Grid" upload type from the Applying Type dropdown.
• Add from Gallery: Access and re-insert previously uploaded assets through the integrated Gallery interface. You can access the Gallery by clicking the "Add from Gallery" button in the Board injection or the Gallery icon in the Script Editor sidebar.

9.2 Draw Function

The Board injection includes a drawing environment for manual storyboard creation and technical sketching — from rough freehand scribbles to precise vector illustrations with anchor-point control.

9.2.1 Adding & Managing Draw Fields

To add a new Draw Field, click the "Draw" button in the Board injection interface. You can create multiple separate Draw Fields and manage them via the Draw Field List at the bottom of the injection box.

• Reorder: Drag elements within the Draw Field List to rearrange their order.
• Title: Give each Draw Field a unique title directly within the Draw Field List for better organization.
• Close: To close a Draw Field, click the Close icon ("×") in the top right corner of the Draw Field.
• Reopen: To open a closed Draw Field again, click the "Edit" button on the item in the Draw Field List.
• Delete: To remove a Draw Field permanently, click the Delete icon ("×") on the item in the Draw Field List.

9.2.2 Resize & Navigation

Adjust the size of the Draw Field using the Resize handle in the bottom-right corner. You can move the Draw Field around the workspace by dragging it.

When the Draw Field is open, specialized Zoom & Shift functions appear. These controls allow you to magnify the workspace or shift the script to provide an unobstructed view of your drawing.

The "Draw" button in the Draw Field header serves as a shortcut — clicking it automatically navigates to the parent injection for that drawing.

9.2.3 Drawing Toolset

Drawing tools are located at the top toolbar of the Draw Field and include the following:

Pen Tool

Create and edit vector paths with precise anchor point manipulation:

• To create a path, click the "Pen" button. Anchor points appear as you click on the canvas. When the path is complete, press the Esc key to quit the Pen tool.
• You can edit a path's shape by dragging its anchor points at any time. Active (selected) anchor points turn red.
• To curve the path, select the desired anchor points and press the Space Bar key. To adjust the curvature, scroll the mouse wheel while holding the Ctrl / Cmd key. The anchor point then turns into a square.
• To add a new anchor point on an existing path, double-click the desired location on the path.
• To create a branch from an anchor point, double-click the desired anchor point.
• The path ends with an arrow by default. To toggle the arrow off and on, double-click a terminal point while holding Cmd / Ctrl. If the path is closed, the arrow disappears as the path converts into a shape.

Vector Shapes

Insert and manipulate geometric primitives (Square, Circle, Triangle) as selectable objects that can be resized, rotated, and recolored.

Image Integration

To add an image to your drawing canvas, click the "Add Image" button and select the image using the system file browser.

Character & Camera Figurines

Quickly place Character and Camera figurines by clicking the corresponding icons and choosing a color. These icons can cycle through various colors for easy categorization when sketching a storyboard, planning blocking, or placing cameras.

Pencil & Eraser

Raster-based tools for freehand sketching with adjustable brush size and a visual reticle for precision. The Eraser tool can also delete vector shapes.

Text Tool

To add editable text labels directly into your drawings, click the Text icon and drag a text field onto the canvas. You can change the text color using the Outline Color parameter.

9.2.4 Drawing Settings

All elements (shapes, icons, text) remain selectable and adjustable after placement:

• Move: Drag any object to reposition it on the canvas.
• Resize: Drag the Resize handles located on the sides and corners of a selected object. Hold Shift for proportional resizing. Hold Ctrl / Cmd to resize around the center point.
• Rotate: Use the circular Rotation handle to rotate the object freely.
• Group / Ungroup: Select multiple elements and press Cmd / Ctrl + G to group them into a single unit for easier management. Press Cmd / Ctrl + Alt + G to ungroup.
• Stroke Width: Click the Stroke Width dropdown to reveal a slider. Adjust the slider to change the thickness of lines and outlines.
• Fill & Outline Colors: Click the Fill or Outline color swatches to open the Color Picker and change the respective colors of the selected element.

9.2.5 Save & Commit

The "Save" button adds your drawing as a PNG image to the Project Gallery, so you can reuse it in other parts of the script.

To add your drawing to the Board injection, click the "Commit" button. Your drawing is flattened into a PNG image and functions exactly like uploaded images.

The "Commit" button does not delete your Draw Field. All Draw Fields remain accessible in the Draw Field List in the parent Board injection for further editing.

9.3 Managing & Applying Board Injection

Each Board injection can hold multiple separate images and videos, managed in a list at the bottom of the injection box. Visual assets can be reordered by dragging and each features an automatically numbered title field.

Applying Type

Before applying visuals to the script, choose from three layout options:

Single: Isolates a single high-priority asset and displays it in a large format.

Reel: Arranges assets in a horizontal, cinematic sequence.

Grid: Organizes multiple assets into a structured mosaic for a comprehensive overview.

Clicking "Apply to Script" generates a specialized Board Line in the screenplay that preserves the selected layout and provides interactive playback for video assets. Applying a Board does not remove the injection box, allowing for continued revisions.

10. Music Injection

The Music injection is a powerful musical composition and playback tool integrated directly into your script editing workspace. It lets you write musical notation, record live MIDI performances, and embed the results as either engraved sheet music or fully playable audio tracks.

10.1 Overview & General Settings

The Music injection interface is separated into several functional groups: Injection Settings, Music Settings, Recording & Playback, Notation Display, Notation Input Box, and Connection Manager.

• Title Box: Name your piece of music. The title appears on the generated waveform player when applied to the script. When you upload an audio file, the filename becomes the default track name.
• Pop Out: Move the Music injection out of the script area by clicking the Pop Out icon. It maintains a visual connection (yellow dotted line) to its initial position. You can expand or collapse it, drag it to reposition it, and toggle the Move Lock icon to lock its position so it stays in place while scrolling.

• Delete Injection: To remove the injection, click the Delete icon (×) in the top right corner. If the Delete Safeguard is active, you must hold the button for 2.5 seconds to confirm deletion. The content already applied to the script is not removed. Deleted injections remain in the Archive until manually cleared.
• Zoom In / Out: When notation is displayed, zoom in and out of the Notation Display area using the Zoom widget in its top right corner. In zoom mode, scroll the sheet area or middle-mouse drag to pan around the notation.

10.2 Adding Music

You can add music in three main workflows:

10.2.1 Upload Music

The software supports MP3 (.mp3) and WAV (.wav) formats. Click the "Upload MP3" button and select the file from the system file browser. The music file is automatically applied to the script and appears as a waveform player displaying the track name. You can play and pause the track by toggling the Play icon, and scrub through the audio by clicking anywhere on the waveform.

10.2.2 Record MIDI

Click "Sketch" to open the MIDI Recorder. Use the integrated virtual keyboard by clicking on its keys, or connect your own physical MIDI keyboard. When the software detects a connected MIDI device, the MIDI Keyboard Indicator in the top left corner of the recorder window turns green. You can reposition the recorder by dragging its Move handle, and close it by clicking the Close icon (×).

Before recording, select a Recording Mode:

• Stenographer Mode: Converts your MIDI performance into readable musical notation.
• Recorder Mode: Preserves the raw performance feel and renders it as an audio waveform.

Click "Record MIDI" to start — the button label changes to "Recording". Click it again to stop.

10.2.3 Notation Typing

Use the Notation Input Box to type music instructions using abbreviations and shortcuts. The software reads this text and renders it as sheet music automatically in the Notation Display area. If you select a note in the Notation Display, the corresponding abbreviation in the Notation Input Box highlights.

The Notation Display area can show:

• Treble clef notation
• Notes and rests
• Chords
• Accidentals (sharps, flats, naturals)
• Staccato marks
• Slurs and ties across measures
• Crescendo and diminuendo hairpins
• Triplets
• Grace notes
• Beamed notes
• Multiple rows of measures
• Tempo and time signature changes

You can open the full shortcut list by pressing the / key in the Notation Input Box.

10.2.4 Playback Controls

Listen to the added music using the Play/Pause toggle. During playback, the current note is highlighted and the preview follows the playhead in zoom mode. Clicking Play/Pause during playback pauses exactly at the current position; clicking it again resumes from that spot. To stop playback and reset the playhead to the beginning, use the Stop icon. Adjust the playback volume using the Volume slider.

10.3 Music Settings

• Time & Tempo: Change the time and tempo signature at a certain bar. Choose the time signature from the Time dropdown, enter Tempo and Bar values, and click "Apply Tempo".
• Instruments & VST: The default instrument is piano. Choose another from the Instruments dropdown or connect VST3/Audio Units plugins. Click "+ Add Folder" in the VST dropdown and select the folder containing your instruments. The instruments connect automatically and appear in the dropdown. If they do not appear, select "Scan plugins". If a directory path has changed (e.g., instruments were relocated or the project was opened on a different device), delete the invalid path by clicking the Delete icon (×) next to it. To avoid excessive memory load, select an instrument and click "Unload VST" to disconnect it. Use the On/Off toggle to temporarily disable the entire injection and prevent unwanted accidental actions. Click the Reload icon if a connected plugin fails to produce sound — this may happen when a project has not been opened for a while.

10.4 Connection Nodes

Connect multiple Music injections so several music sections can play or render in sequence or in parallel. To play Audio 2 after Audio 1, drag a wire from the blue Output port of Audio 1 into the yellow Sequence Input port of Audio 2. To play Audio 1 and Audio 2 simultaneously, drag a wire from the blue Output port of Audio 1 into the purple Parallel Input port of Audio 2. Each Music injection displays three ports: Output (blue, for sending audio out), Sequence Input (yellow, for chaining in series), and Parallel Input (purple, for simultaneous playback).

10.5 Apply to Script

Music can be applied to the script in two ways, accessible in the Apply To Script dropdown:

• As Notation: Inserts the rendered music as inline notation. Live playhead markers and temporary highlight effects are removed from the applied notation.
• As Audio (MP3, WAV): Inserts a waveform player into the document. If only notation exists, the notation is rendered into an audio track first. While rendering, a placeholder is displayed. If rendering fails, an error message appears.

10.6 Shortcuts

The following table lists the abbreviations and shortcuts for typing music instructions in the Notation Input Box. You can also open the shortcut list by pressing the / key in the Notation Input Box.

11. Sheet Injection

The Sheet injection provides a professional, structured workspace for spreadsheet management. It allows you to embed detailed production documents — call sheets, continuity logs, production plans, and more — directly into your project. Unlike other injection types, Sheet injections cannot be applied to the script because of their size. Instead, data is saved within injection boxes and can be exported in CSV or PDF format.

11.1 Sheet Management

Multiple spreadsheets can be added to the same injection, each with its own independent content. To add a spreadsheet, click the "New Sheet" button and choose from six distinct types: Budget, Production Plan, Scheduling (Call Sheet), Continuity Log, Costume, or Freeform. Once added, the spreadsheet appears in the Sheet List with its type badge, title, and configuration settings.

You can rename spreadsheets by clicking their title. The Sheet Editor rescales automatically according to its contents. Specialized Zoom & Shift functions appear when the editor is open to provide an unobstructed view.

11.2 Budget Spreadsheet

Designed for production accountants and line producers to itemize, cost, and total expenses of individual scenes or an entire project. The editor is organized into sections: Item, Personnel, Location, Transport, and Total. Each section (except Total) features a table with columns for Item, Department, Role, Location, Transport, Quantity, Cost, Notes, and an auto-calculated Total column. The Total Section provides an overview of all costs per cost type with the grand total at the bottom, updating automatically as data changes.

11.3 Production Plan Spreadsheet

A specialized data management tool for organizing timelines and technical steps. When you add a Production Plan, you choose one of four workflow types:

Film Production: Day-by-day scheduling with Filming Days, Scene Rows, and auto-calculated hour totals.

Film Post Production: Tracks multiple iterations of scenes through the editing process.

Game Production: Modular framework based on development phases and technical cycles.

Rehearsals: Performance-based planning focusing on scenes and rehearsal sessions.

Iterative types (Post, Game, Rehearsals) share a common structure: Phases/Scenes containing Work Sessions, each with a dedicated spreadsheet supporting rows, columns, text formatting (Bold, Italic, Underline, lists, font size, color picker, alignment), and collapse/expand for organization.

11.4 Scheduling Spreadsheet (Call Sheet)

A specialized tool for creating daily schedules, organized into three primary sections:

• Time & Location: Track core logistics — Date (calendar picker), Day, Base Location, and multi-line General Notes.
• Crew Plan: Manage individual arrival times with Department, Role, Notes, and call time (clock picker supporting 12h/24h format).
• Scene Plan: Map the day's shooting sequence with Scene Heading, Description, Roles (Actors), Shooting Location, and Est. Shoot Time.

11.5 Continuity Log

A specialized environment for script supervisors to track takes and visual consistency during a shoot. It is divided into three sections:

• Scene Section: Set context with Scene Heading and Description fields.
• Reference Photos: Upload set photos with automatic timestamps. Photos appear as thumbnails with titles and can be viewed in a high-resolution lightbox with fullscreen mode and keyboard navigation.
• Take Log: Core section for rapid entry during filming. Features include total takes counter, auto-numbered take fields, performance notes, and an integrated stopwatch per take.

11.6 Costume Spreadsheet

A comprehensive wardrobe management system for tracking looks, fittings, and rental logistics across multiple characters. Each character gets an independent section with:

• Character Information: Character Name, Actor Name, General Notes (resizable), and Portrait upload with fullscreen preview.
• Wardrobe Table: Itemize garments with columns for Item, Condition, Size, Rental (with return date via calendar picker), and Notes.

11.7 Freeform Spreadsheet

A versatile grid-based tool for custom data organization that does not fit into specialized templates. The grid starts as an 8x8 matrix and expands indefinitely as your project grows.

• Add or delete rows and columns using toolbar buttons.
• Drag row or column headers to move contents to a new position.
• Resize by dragging borders between headers or using the Size Adjustment Sleeve.
• Formula support: =SUM(A1:A10) for addition, PROD(A1:A10) for multiplication.
• Full text formatting: Bold, Italic, Underline, bulleted/numbered lists, font size dropdown, color picker, horizontal and vertical alignment, and clear formatting.
• Use Alt + Arrow keys for keyboard navigation between cells.

12. Overview

The Overview panel provides a structural map of your entire project. It is accessible via the Overview icon in the navigation tools and serves as a central hub for navigating your script, managing injections, and reviewing comments.

12.1 Project Structure

The Overview displays your entire project as a hierarchical tree. Every scene heading is listed as a primary branch. Injections and content items attached to lines appear nested under their respective scenes. You can collapse or expand branches by clicking the Dropdown Arrow icons.

Rapid Navigation

Double-clicking a scene heading or any item scrolls the script directly to that location. When you jump to an item from the Overview, the target line in the script flashes briefly to help you orient yourself.

Rename

You can right-click any non-scene item in the Overview tree and select "Rename" to give it a custom label. This does not change the script text itself.

Export Toggles

Each item in the tree has a small Export Icon on the right. You can toggle it to include or exclude specific scenes, injections, or media items from your final PDF and package exports. These selections are synced with the Selective Export and Elements Only export windows.

12.2 Comments Tab

The Overview also contains a dedicated tab for Comments. This provides a centralized list of all feedback and notes added by collaborators, making it easy to review and address input without scrolling through the entire script.

Comment Cards

All comments appear as cards displaying the line number(s), the quoted text, and the comment itself. Each card is automatically tagged with the name and color of the active Profile, allowing teams to track who made which suggestion.

Navigating to Comments

Clicking any comment card scrolls the script to the commented passage immediately. The corresponding color-coded comment bar in the left margin flashes to help you identify the location.

Managing Comments

• View: Comments are visible both in the Overview > Comment tab and as vertical color-coded bars in the left margin next to commented lines. The bar color can be changed in Profile Settings.
• Edit: To open and edit a comment, Ctrl+Click (or Cmd+Click on Mac) any vertical comment bar, or click the Expand Comment icon on the comment card.
• Delete: Click the Delete icon on the comment card to remove it.

Note: Only the author of a comment can edit its text or delete it.

13. Export

The Export system is a comprehensive tool for sharing your work, creating production documents, and archiving different versions of your project. Click the "Export" button in the global toolbar to open the Export Window.

The Export Window is divided into two main areas: the left sidebar displays four specialized export modes (Project, PDF, Music, Sheets), and the main area displays the settings for the selected mode. To select a destination folder, click the Folder icon and browse your system. When ready, click "Export Selected" in the bottom toolbar.

When you create a project, the system automatically creates a structured folder tree including specialized export folders (e.g., exports/pdf, exports/music), making it easy to keep your files organized.

13.1 Project Export

Project Export allows you to save and share the interactive document with other users of the software. You can lock a project export into a Read-Only version, allowing recipients to view and add comments without modifying the script or injections.

• Packed Project (.wws): Exports a single-file archive containing the entire project, including all media, injections, and metadata.
• Selective Export: Allows you to choose specific scenes with added elements from the project tree to export into a smaller, focused file. You can include or exclude Gallery, Archive, and Highlights & Comments elements by toggling the corresponding checkbox. Selections are synced with the Overview toggles.

• Elements Only (.wwsel): Exports only the injections and their data without the script lines. Useful for importing a set of technical plans into a different script.

13.2 PDF Export

The primary method for generating professional screenplay documents and production supplements. You can define a project-specific cover page with fields for Title, Genre, Author, Email, and Draft version.

• Clean Script Only: Generates a standard industry-formatted screenplay, removing all injections.
• Script with All Elements (Inline): Exports the script exactly as it appears in the editor, with injection boxes and special lines in their chronological positions.
• Script + Separated Elements: Places the full script first, followed by a section where all elements are grouped by the scene they belong to.
• Groups Only (No Script): Ideal for technical departments — exports only the elements organized by scene, without the screenplay text.

If elements are included, you can filter which injection types to include (e.g., only storyboards and sheets, omitting personal notes) and define the image size (Small, Medium, or Large) for separated element modes.

13.3 Music Export

Music can be exported for use in external digital audio workstations (DAWs) or for review. If you have linked multiple music boxes, the system can export the entire sequence as a single combined file.

• MIDI Export: Converts your notation or recorded MIDI data into a standard .mid file.
• Audio (WAV) Export: Generates a WAV audio file of the music box's contents.
• Notation (PDF) Export: Exports the notation as a PDF file.

13.4 Sheets Export

Data managed in Sheet injections can be exported for administrative use. You can filter which sheets to include by toggling checkboxes.

• PDF (Fit to Page): Scales the table to fit within the width of a standard page.
• PDF (Auto-paginate): Automatically splits large tables across multiple pages while maintaining readability.
• CSV (Spreadsheet): Exports the raw data into a .csv file compatible with Excel, Google Sheets, or other production accounting software. Supports all sheet types, including Budgets, Call Sheets, and Continuity logs.

14. Settings

The Settings Panel is accessible via the Settings icon in the top toolbar. After making changes, ensure you click the "Apply" button for them to take effect.

The Settings are divided into three groups:

14.1 General Settings

This tab contains the core configuration options for how the software behaves and handles your data.

• Language & Region: Choose the interface language, the preferred currency for budget spreadsheets, and the time format (12-hour or 24-hour).
• Safety & Recovery: Configure the Autosave interval to automatically save your work at regular intervals. Choose how many backups to keep to balance safety and storage. Adjust the Undo Depth to control how many steps back you can undo — a higher depth gives more freedom but uses more memory.

14.2 Appearance Settings

This tab controls the visual look and feel of the workspace, letting you tailor the interface to your preferences or working conditions.

• Themes: Choose from preset color schemes — Main, Dark, Warm, or Cool — to quickly change the overall look of the editor.
• Custom Themes: Create your own theme by adjusting individual colors for the toolbar, workspace background, and text. You can also add background textures such as dots or grids to suit your visual style.
• UI Scaling: The software automatically scales the interface based on your screen resolution. You can manually override this by adjusting the Default Popout Shift and the Default Workspace Zoom to set your preferred starting view every time you open a project.

14.3 Screensaver Settings

This tab controls the cinematic screensaver video, allowing you to customize the full-screen display that plays during breaks or presentations.

• Current Video Preview: View the active screensaver video in the Preview section. This lets you confirm which video will play before deploying the screensaver.
• Upload Custom Video: Replace the default screensaver by uploading your own video file from your device.
• Stream from Link: Paste a direct URL to stream a screensaver video directly from the internet instead of using a local file.
• Reset to Default: Click the "Reset to Default" button to restore the original default screensaver video at any time.

Changes to any settings tab are applied only after clicking the "Apply" button. Settings are saved per user profile, so each collaborator can maintain their own preferences.

15. Shortcuts