mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-03 12:17:03 +00:00
Miguel Ángel
e00baefb5c
* fix(studio): reload the preview only when a file it loaded changes * test(studio): read the owner id from the new change-owner shape * refactor(studio): drop a comment the parser name already says * fix(studio): keep reloading until the preview is built, and count what its document names * style(studio): format the reference pattern and name the kept reload * fix(studio-server): scan preview references in linear time and refresh all thumbnails on a merged reload * fix(studio): keep a waiting film change when a file the preview never loaded arrives behind it * test(studio): name the preview ownership test for what it checks * chore(ci): allow the watchIgnore removals and trim the new comments * fix(studio-server): reload the preview when a folder holding a file it loaded moves in or out * perf(studio-server): check a changed folder in one lookup and cover every reference form * fix(studio-server): record read folders for a project at the filesystem root * fix(studio-server): reload the preview when the file a symlinked asset points at changes * fix(studio-server): resolve symlinks on every preview read and key projects by their real folder * fix(studio-server): record every link a preview read passes through, resolved as the system does
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)
|