mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-03 20:37:30 +00:00
* docs(studio): the browser editor in six pages, named the browser editor * docs(studio): mute where the editor has it, and no solo control The audio pages still described a solo control and a group-row mute that the editor does not render. Muting is the speaker button on an audio track (Mute track / Unmute track), the same toggle on a selected clip, and the Muted switch; a group is silenced through its members' tracks. The audio reference drops its solo section for the same reason.
60 lines
2.1 KiB
Plaintext
60 lines
2.1 KiB
Plaintext
---
|
|
title: "Browser editor 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 the browser editor 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/canvas#edit-the-source)
|
|
- [Finish, render, and share](/guides/export-and-share)
|
|
- [Diagnose a project or CLI problem](/guides/troubleshooting)
|