Using Lyreline Studio with Lyreline¶
Lyreline and Lyreline Studio have distinct responsibilities.
Lyreline owns authored source¶
Use Lyreline to capture workflows and maintain the canonical instructional content: procedure structure, written instructions, screenshots, crops, annotations, callouts, redactions, and selected regions.
Lyreline Studio owns publication work¶
Use Lyreline Studio to manage Studio projects, continue composition, prepare narration, retain generated audio, review publication content, and create HTML, PDF, and video outputs.
Supported round-trip workflow¶
The handoff preserves the Studio project's identity so both apps can return to the same logical project. It is an explicit continuation, not live synchronization.
- Capture and author in Lyreline. Create the procedure structure, instructions, screenshots, and presentation edits.
- Continue in Lyreline Studio. Open the authored procedure in Studio for further composition, narration, review, and publication.
- Review updates in Studio. Reconcile changed authored source with existing narration and publication work.
- Optionally return to Lyreline. Export or hand off the Studio-authored project and open it in Lyreline. Studio-authored sections become native, editable Procedure steps.
Supported round trips preserve:
- section order and instructional text;
- images and presentation edits;
- numbered callouts and optional labels;
- the relationship between a numbered callout and its instruction;
- section-level Callout Sequence membership; and
- authored Highlight color and transparency in supported exchange formats.
For callout creation and editing instructions, see Numbered Callouts in the Lyreline documentation.
Reviewing source updates in Studio¶
When Lyreline returns updated authored content, Studio identifies what changed. For an existing section, Studio preserves its narration draft and generated audio while presenting the updated Lyreline source for review. This prevents a source edit from silently overwriting publication work.
Review narration changes without losing Studio work¶
When a Lyreline source change may affect spoken narration, use Review Narration Update…. Studio opens a comparison showing:
- Last Reviewed Lyreline Source — the source associated with the last completed review.
- Updated Lyreline Source — the current authored source returned from Lyreline.
- Current Studio Narration — the narration text already authored in Studio.
- Proposed Narration — an editable working copy that does not change the project until you apply it.
The proposal is intentionally editable. You can start from the current Studio narration or reset to the updated Lyreline source, then combine the two as needed. This is useful when an upstream change is small, when the existing Studio narration is already polished for spoken delivery, or when you notice a typo or want to improve the wording during review.
Choose Apply Narration Update only when the proposed text is ready. Applying the proposal changes the Studio narration text; it does not regenerate audio and it does not mark the Lyreline source reviewed. Existing generated audio is preserved and may show Needs Regeneration when it no longer matches the revised narration text.
Regenerating narration remains a separate explicit action. This lets you review and edit the text first without immediately replacing generated audio.
Marking a source update reviewed¶
Choose Mark Reviewed when you have finished reviewing that section's Lyreline source and are satisfied with the Studio narration. Mark Reviewed does not rewrite narration, regenerate audio, or replace authored content. It only acknowledges that the section-level source review is complete.
After all required section reviews are complete, use Mark Updates Reviewed to acknowledge the remaining project-level continuation update.
For narration based on imported audio, Studio does not offer the editable narration-reconciliation proposal because imported recordings cannot be regenerated from revised text. Review the source change and manage the imported recording separately if the spoken content also needs to change.
Capture history remains in Lyreline¶
Studio works with authored procedure content and presentation data. It does not fabricate Capture Moments or rewrite Capture Sessions. Historical capture provenance remains separate from content composed later in Studio.
Returning Studio-authored content therefore adds or restores authored Procedure steps without pretending that Studio composition was a new capture event.
Reopening Studio-authored work in Lyreline¶
When a matching Lyreline procedure is an eligible empty shell, returning Studio-authored sections can rehydrate that shell while retaining its established procedure relationship.
If the matching Lyreline procedure already contains steps or sections, Lyreline protects that populated procedure from silent replacement. Existing authored content is not overwritten merely because a Studio package has the same project identity.
Opening an existing identity¶
If a portable Studio package has the same project identity as a managed project, Studio offers the established choices:
- Open Existing opens the matching managed project without importing the package as another copy.
- Import as Copy creates an independent project with its own identity while preserving its ancestry.
- Cancel makes no change.