Worksheets allow you to export dialogue data to Excel, edit it externally, and re-import changes into Frostune:VO.
They are especially useful for:
Open the VO Manager.
Build your results list using search filters:
TEXT_NEEDEDSelect the lines to export:
Click Worksheet XLSX in the Results section.
In the export dialog:
Choose a location and filename in the file explorer window.
A Frostune worksheet may include columns such as:
Scene
Scene Tag
Folder Path
Scene Action
Speaker
Line (WRITE HERE)
Line Action
WavName
String ID
Notes
| Column | Purpose |
|---|---|
Scene |
Scene name |
Scene Tag |
Stable scene identifier used for matching/import |
Folder Path |
Folder location in the Frostune project |
Scene Action |
Scene-level action/description text |
Speaker |
Character name |
Line (WRITE HERE) |
Dialogue text to import |
Line Action |
Action text inserted before the dialogue line |
Notes |
Line notes / direction notes |
WavName |
Optional audio/filename reference |
String ID |
Optional line ID reference |
Once exported, open the .xlsx file in Excel or another compatible spreadsheet editor.
To edit dialogue text, modify the:
Line (WRITE HERE)
column.
You can use this to:
TEXT_NEEDED placeholder linesUse the:
Notes
column.
These notes are imported back into Frostune:VO as line notes / direction notes.
Use the:
Scene Action
column.
This imports scene-level action or description text into the scene’s action text area.
Example:
The village is quiet. A storm approaches in the distance.
Use the:
Line Action
column.
This creates an action row immediately before the matched or newly created dialogue line.
Example:
Alice looks away, uneasy.
When working in the source language of the project, usually English, Worksheet Import can create new content.
You can create:
To create new dialogue rows, each row must include:
Scene
Scene Tag
Folder Path
Speaker
Line (WRITE HERE)
Required columns:
| Required Field | Why it matters |
|---|---|
Scene |
Prevents unnamed/imported scene names |
Scene Tag |
Allows stable matching and clean engine/export IDs |
Folder Path |
Prevents importing into Unfiled |
Speaker |
Ensures the line belongs to a character |
Line (WRITE HERE) |
Provides the dialogue text |
⚠️ Frostune:VO no longer imports new worksheet rows into a generic
Importedscene or(Unfiled)folder. Missing required fields are skipped and reported.
.xlsx file.Worksheet Import behaves differently depending on the active project language.
When editing the source language, normally English, Worksheet Import can:
This is the only mode where structure can be created.
When editing a localized language, such as French, Spanish, German, Italian, or Portuguese, Worksheet Import is update-only.
It can update matching localized content, such as:
It cannot create:
This keeps the source language as the master structure for the project.
Before completing the import, Frostune:VO shows a confirmation window.
The preview includes a short summary such as:
Worksheet (Merge/Add) — Import preview
File: worksheet_new.xlsx
Summary
Matched rows: 2
Text updates detected: 2
New dialogue rows to add: 0
New scene action rows to add: 0
Matched scene actions: 1
Matched line actions: 1
Skipped rows: 1 (Missing required fields: 1)
A detailed TXT report will be saved after you apply the import.
The popup is intentionally short so large imports remain readable.
If the import contains skipped rows, duplicate references, or a large number of rows, Frostune:VO saves a detailed TXT report.
The report may include:
Example skipped reason:
Missing required fields: Scene, Scene Tag, Folder Path — "Ohlala"
Use this report to fix the worksheet and retry the import.
Rows may be skipped when required information is missing.
Common skipped reasons include:
| Reason | Meaning |
|---|---|
| Missing required fields | Scene, Scene Tag, or Folder Path is missing |
| Missing Speaker / Character | A dialogue row has text but no speaker |
| Missing Line text | A dialogue row has a speaker but no dialogue text |
| Empty row skipped | The row contains no importable content |
| No importable content | The row does not contain scene action, line action, notes, or dialogue text |
Scene Tag values stable.Folder Path when creating new content.String ID unless you know exactly why.Scene Action for scene-level direction or description.Line Action for action rows that should appear before dialogue.Notes for line-specific notes or direction.| Task | Recommended Workflow |
|---|---|
| Fill placeholder dialogue | Export Worksheet → edit Line (WRITE HERE) → import Worksheet |
| Update existing dialogue | Export Worksheet → edit text → import Worksheet |
| Add line notes | Edit Notes column → import Worksheet |
| Add scene description/action | Edit Scene Action column → import Worksheet |
| Add action row before dialogue | Edit Line Action column → import Worksheet |
| Create new scenes/folders/lines | Use Worksheet Import in source language |
| Update translations | Use Worksheet Import while editing the localized language |
| Diagnose skipped rows | Review the TXT import report |