mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-08 07:46:59 +00:00
Miguel Ángel
a25da94b77
* refactor(studio): remove the storyboard view and its Storyboard/Preview switch * refactor(studio): fold the thumbnail output branches left after the storyboard mode went * docs(studio): drop leftover storyboard references after the view was removed * ci: allow the storyboard view deletions in the no-deletions guard * docs(studio): wrap an over-long comment line in the caption overlay helper * style(studio): reindent App.tsx after the view-mode wrapper was removed
60 lines
2.1 KiB
Plaintext
60 lines
2.1 KiB
Plaintext
---
|
|
title: "Studio troubleshooting"
|
|
description: "Recover from selection, preview, editing, timeline, and export problems."
|
|
---
|
|
|
|
## I cannot select the right element
|
|
|
|
- Pause on a frame where it is visible.
|
|
- Choose it from Layers.
|
|
- Check whether it belongs to a group or nested composition.
|
|
- Look for an off-canvas indicator.
|
|
|
|
## A direct edit is unavailable
|
|
|
|
The selected element may be generated, nested, or unsupported for that operation.
|
|
|
|
Try the inspector, open the nested composition, copy context to the agent, or make a focused source edit.
|
|
|
|
## A canvas move became animation
|
|
|
|
Check whether auto-keyframing is enabled. Undo the edit, turn it off, and make the layout change again.
|
|
|
|
## The timeline edit landed at the wrong time
|
|
|
|
Undo, zoom in, place the playhead more precisely, and retry. Check whether snapping moved the boundary to a nearby clip or beat.
|
|
|
|
## The preview did not update
|
|
|
|
- Preview's Code editor and visual controls save automatically. If the change came
|
|
from another editor or an agent, confirm that the external file was saved.
|
|
- Wait for the project refresh.
|
|
- Check the terminal running `hyperframes preview`.
|
|
- Reload Studio if the preview process is still healthy.
|
|
- Restart `npx hyperframes preview` when the server stopped.
|
|
|
|
## Media is missing or slow
|
|
|
|
Confirm that the file exists inside the project and that its path is correct. Large media may need time to prepare a preview. Remote files can fail because of access or cross-origin restrictions.
|
|
|
|
## An edit failed to save
|
|
|
|
Keep the error visible, avoid stacking more edits on top of it, and undo if available. Copy the issue to your agent with the action that caused it.
|
|
|
|
## A render failed
|
|
|
|
Keep the complete error. Run the project checks, confirm FFmpeg and source media are available, then retry:
|
|
|
|
```bash
|
|
npx hyperframes lint
|
|
npx hyperframes check
|
|
```
|
|
|
|
For lower-level failures, continue to [general troubleshooting](/guides/troubleshooting).
|
|
|
|
## Related topics
|
|
|
|
- [Work with source and an agent](/studio/source)
|
|
- [Finish, render, and share](/guides/export-and-share)
|
|
- [Diagnose a project or CLI problem](/guides/troubleshooting)
|