mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-15 22:08:03 +00:00
James Russo
31c00d2f0e
* fix(studio): avoid preview reloads for temporary and excluded files * docs: capture public preview reload reproduction * fix(studio-server): normalize watch paths in linear time * fix(studio): register dynamically opened preview projects
85 lines
3.1 KiB
Plaintext
85 lines
3.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)
|
|
|
|
## Preview keeps restarting while tools write reports
|
|
|
|
Preview watches project files so source and asset edits appear automatically.
|
|
If an agent or check command writes notes and reports inside your project, exclude
|
|
those outputs from live reload in `hyperframes.json`:
|
|
|
|
```json
|
|
{
|
|
"preview": {
|
|
"watchIgnore": ["docs", "references/check-results.json"]
|
|
}
|
|
}
|
|
```
|
|
|
|
Entries are literal project-relative file or directory paths, not globs. A directory
|
|
entry includes its descendants, but not similarly named siblings. Only exclude
|
|
files the composition does not use: ignored files remain available to the server
|
|
and renderer, but edits to them will not automatically reload the player or its
|
|
thumbnails. Changes to this setting take effect without restarting the server;
|
|
`hyperframes.json` itself always triggers a reload.
|
|
|
|
Atomic-save temporary files (`.tmp`, `.tmp.<pid>.<hex>`, `.swp`, `.swo`, and trailing
|
|
`~`) do not trigger preview reloads. Renaming them to the final source filename
|
|
still does.
|