Scripts

4.1 Creating a Script

Basic Creation

1. Navigate to Scripts from the main navigation
2. Click "New Script" button (or "Create Script")
3. Enter a Title (required)
4. Optionally add Content (you can add this later)
5. Select Privacy Level (in organization workspace - see section 4.7):
   • Personal: Private to you, not visible to team (lock icon)
   • Team: Visible to all organization members (users icon)
6. Optionally add to a Collection (see Collections section)
7. Click "Create Script"

Edge Cases:

• Free plan users: Cannot create scripts (upgrade prompt appears)
• Offline mode: Cannot create scripts offline (must be online)
• If you lose connection during creation, the script may not be saved (check your scripts list)
• After you create a script, it should appear in the left navigation automatically (no page refresh needed). If you create a script immediately after signing up, the sidebar may take a moment to finish loading before it updates.

Rich Text Editor Features

The script editor includes:

Text Formatting:

• Bold (Ctrl/Cmd + B)
• Italic (Ctrl/Cmd + I)
• Underline (Ctrl/Cmd + U)
• Text Color: Choose from color picker
• Background Color: Highlight text with background color

Text Alignment:

• Left Align
• Center Align
• Right Align

Lists:

• Bullet Lists: Unordered lists
• Numbered Lists: Ordered lists
• Indent/Outdent: Increase or decrease list/item indentation

Special Elements:

• Markers: Insert visual markers in script (useful for teleprompter navigation)
• Pauses: Insert timed pauses (default 1 second, adjustable)

Other Features:

• Undo/Redo: Full undo/redo history
• Word Count: Displayed in editor footer
• Character Count: Displayed in editor footer
• Reading Time: Estimated reading time displayed

Edge Cases:

• Very long scripts (10,000+ words) may have slower auto-save
• Special characters and emojis are supported
• Copy/paste from external sources: Formatting is preserved where possible
• Maximum script size: ~1MB content (very large scripts may have performance issues)

4.2 Editing a Script

Opening a Script

1. Click on any script from the scripts list
2. Script opens in the editor
3. Make your changes
4. Changes auto-save after a few seconds of inactivity

Auto-Save

• Scripts auto-save approximately 2-3 seconds after you stop typing
• "Saving..." indicator appears in editor
• "Saved" confirmation appears when save completes
• Last saved time is displayed

Edge Cases:

• If you lose connection while editing, changes may not save (you'll see an error)
• If another user is editing the same script, you'll see an "editing lock" warning
• Very rapid typing may cause multiple save requests (handled automatically)
• If auto-save fails, you can manually click "Save"

Manual Save

• Click "Save" button in editor toolbar
• Useful when you want to ensure changes are saved immediately

Editing Lock

• If another user is actively editing a script, you'll see: "Another user is editing this script"
• You can still view the script but should coordinate edits
• Lock is released when the other user stops editing (after ~30 seconds of inactivity)

Edge Cases:

• If a user closes their browser while editing, the lock releases after timeout
• Locks are per-script, not per-user (multiple users can edit different scripts simultaneously)

Editor Status Bar

The editor displays a status bar at the bottom with script metadata and privacy controls:

• Owner: Shows "You" or the owner's name
• Privacy Level: Shows current privacy with an icon (lock for personal, users for team)
• Created/Updated dates: Shows when the script was created and last modified

Clickable Privacy Level (Owners Only):

If you own the script and have team features:

1. Click on the privacy indicator
2. A dropdown appears with options:
   • Personal (Only you - lock icon)
   • Team (Anyone at [Organization Name] - users icon)
3. Select to change privacy level immediately
4. Sharing with specific users is done through the Share dialog

Edge Cases:

• Non-owners see privacy level but cannot change it
• Users in personal workspace (not in an organization) only see "Personal"
• Changes to privacy level take effect immediately and trigger auto-save

4.7 Privacy Toggle (Organization Workspaces)

When working in an organization workspace, a prominent privacy toggle appears in the editor header:

Toggle Appearance

• Location: Editor header, between title and action buttons
• Design: Segmented control with two options
• Visible when: User is in org workspace AND owns the script AND can edit

Toggle Options

1. Personal (Lock icon):

   • Script is private to you
   • Not visible to other organization members
   • Even admins cannot see your personal scripts

2. Team (Users icon):

   • Script is visible to all organization members
   • Shows organization name (e.g., "ACME workspace")
   • Admins, Producers, and Editors can view and edit

Changing Privacy Level

1. Click the currently-unselected option in the toggle
2. Privacy level changes immediately
3. Script auto-saves with new privacy setting
4. Toggle reflects new state

Edge Cases:

• Toggle is disabled when offline (privacy level cannot be changed)
• In personal workspace (not org), no toggle appears - all scripts are personal
• Create mode: Toggle defaults to "Personal" unless you change it
• Sharing with specific users is done through the Share dialog, not the toggle

View-Only Script Banner

When viewing a script you don't own (shared with view-only access), a banner appears:

Banner Features:

• "Copy to My Scripts" button: Creates a private copy in your scripts
  • Copy includes all content but not sharing settings
  • After copying, you're redirected to your new script
• "Request Edit Access" button: Sends an email to the script owner
  • Owner receives notification to grant edit access
  • You'll see confirmation when request is sent
  • Duplicate requests are blocked (shows "already requested")

Edge Cases:

• Rate limiting applies to edit access requests
• Copied scripts are always private initially
• If script is deleted while viewing, you'll see an error

4.3 Script Privacy & Sharing

Privacy Levels

Personal:

• Only you can see and edit by default (lock icon)
• Not visible to organization members in the Team Scripts list
• Private Collaboration: You can share with specific colleagues or groups via the Share dialog's Organization tab
• Script remains personal (stays in your "My Scripts" list, never floods the Team Dashboard)
• Works like Google Drive's "My Drive" sharing model: the script is yours, but specific people have access

Team:

• All team members with appropriate roles can see (users icon)
• Admin, Producer, Editor: Can see and edit by default
• Talent: Cannot see unless explicitly shared
• Script appears in organization's Team Scripts list

Sharing Options (via Share Dialog)

The Share Dialog has two tabs: Organization (internal) and External (for external links).

Organization Tab:

The Organization tab allows sharing with role groups and individuals within your organization.

1. Role Groups (top section):

   • Share with entire role groups: Producers, Editors, Talent
   • Tri-state checkboxes: ✓ (all shared), − (some excluded), ☐ (none)
   • Expand each group to see individual members
   • Uncheck specific members to exclude them from the group share
   • Set permission (Can View / Can Edit) per group

2. Smart Search (middle section):

   • Type to search organization members by name or email
   • If email doesn't match any member, invite them as a guest

3. Individual Access (bottom section):

   • Override permissions for specific users
   • Individual permissions take precedence over group permissions

Important: Changes are not saved immediately. Click "Save Changes" to apply. If you close without saving, you'll see a warning.

External Links (External Tab):

• Create a public link (token-based)
• Anyone with the link can view in teleprompter mode
• No login required for viewers
• Can set expiration date
• Can revoke link at any time

Permission Resolution

When a user has multiple shares, the highest permission wins:

1. Individual share always takes precedence
2. If in multiple groups: edit wins over view
3. Exclusion from a group means no access through that group

Example: If "All Editors" have Can View, but Alice is added individually with Can Edit, Alice gets edit access.

Sharing with Role Groups

1. Open the script and click the Share icon
2. On the Organization tab, check the role groups to share with
3. Optionally expand a group and uncheck specific members to exclude them
4. Set the permission level (Can View / Can Edit) for each group
5. Click "Save Changes"

Sharing with Specific Users

1. In the Organization tab, use the search bar to find a user
2. Click their name to add them to the Individual Access list
3. Set their permission level
4. Click "Save Changes"

Private Collaboration (Personal Scripts with Selective Access)

This workflow allows you to draft sensitive content privately and share it with specific colleagues without making it visible to the entire company.

Use Cases:

• Drafting scripts that need review before team-wide release
• Sharing confidential scripts with select individuals or groups
• Collaborating with an editor on personal content

How It Works:

1. Create or open a Personal script (lock icon in privacy toggle)
2. Click Share to open the Share Dialog
3. Go to the Organization tab (available for all org scripts, regardless of privacy level)
4. Share with specific users or role groups
5. Click "Save Changes"

Key Behavior:

• The script remains Personal (privacy level unchanged)
• The script stays in your "My Scripts" list
• The script does NOT appear in the Team Dashboard
• Shared users see the script in their "Shared with Me" section
• You maintain full ownership and can revoke access anytime

Comparison:

| Privacy Level | Team Dashboard | Organization Sharing | Who Can See | |---------------|----------------|---------------------|-------------| | Personal | Not visible | ✅ Available | Owner + explicitly shared users/groups | | Team | Visible to all | ✅ Available | All org members with appropriate roles |

Creating External Links

1. Open the script
2. Click "Share" button
3. Go to the "External" tab
4. Click "Create External Link"
5. Optionally set expiration date
6. Copy the link
7. Share with anyone (no login required)

Edge Cases:

• External links are read-only (viewers cannot edit)
• If you revoke a link, it stops working immediately for all users
• Expired links show an error message when accessed

4.4 Script List & Organization

The sidebar navigation organizes scripts into logical sections based on context.

Navigation Structure (Organization Workspace)

When in an organization workspace, the sidebar shows:

Global Filters:

• Recent: Scripts you've recently accessed, ordered by when you last opened them (configurable: 5-20 scripts, default 10)
• Starred: Scripts you've marked with a star

My Space Section:

• My Scripts: Your private scripts (only visible to you) - shows count
• My Collections: Your personal collections

Shared in [Org Name] Section:

• Team Scripts: Scripts visible to the organization - shows count
• Team Collections: Collections shared with the organization

Navigation Structure (Personal Workspace)

When in a personal workspace (no organization):

• Recent: Scripts you've recently accessed (based on when you last opened them)
• Starred: Scripts you've starred
• My Scripts: All your scripts
• My Collections: Your collections

Script List Features

Search:

• Type in search box to filter scripts by title
• Search is case-insensitive
• Use Quick Search (Cmd+K) for faster access

Filters (via URL parameters):

• ?filter=recent - Recently accessed
• ?filter=starred - Starred scripts
• ?filter=my - Your private scripts
• ?filter=team - Team/organization scripts

Sorting:

• Starred First: Starred scripts appear at top
• Recently Updated: Most recently edited first
• Title (A-Z): Alphabetical

Starring Scripts:

• Click the star icon next to any script
• Starred scripts appear in "Starred" filter
• Star state is per-user (others don't see your stars)

Script Card Actions:

Hover over any script card to access quick actions:

• Play Button: Open directly in teleprompter
• Edit Icon: Open in editor
• Menu (⋮): Access additional actions:
  • Duplicate: Create a copy of the script
  • Add to Collection: Quickly add to one or more collections
  • Delete: Permanently remove the script

Edge Cases:

• Very large script lists may have slower search/filter
• Search results respect permissions (you only see scripts you can access)
• If a script is deleted, it disappears from all lists immediately

4.5 Deleting a Script

1. Open the script you want to delete
2. Click "Delete" button (usually in menu or toolbar)
3. Confirm deletion in the dialog
4. Script is permanently deleted

Edge Cases:

• Deletion cannot be undone
• If script is shared, all shares are removed
• If script is in collections, it's removed from collections (collections remain)
• External links to deleted scripts stop working
• If script is currently being viewed in teleprompter, viewers will see an error

4.6 Script Metadata

Each script displays:

• Owner: User who created the script
• Created Date: When script was created
• Updated Date: Last modification time
• Visibility: Current visibility setting
• Word Count: Total words
• Character Count: Total characters
• Reading Time: Estimated reading time

---