Files
hyperframes/docs/studio/troubleshooting.mdx
Ular Kimsanov 0390f3f908 docs(studio): the browser editor in six pages, named the browser editor (#6379)
* 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.
2026-10-26 06:24:53 +00:00

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)