---
title: "Get unstuck"
sidebarTitle: "Get unstuck"
description: "Start with what you can see, try the smallest useful fix, and return to your HyperFrames task."
---
Choose the symptom that looks most like yours. You should not need to read the entire documentation site or understand the rendering architecture to solve a normal problem.
The browser never opens, the page is unreachable, or the project does not load.
A saved change is missing, playback looks old, or the preview is blank.
Selection, canvas controls, timing, or an Inspector field is unavailable.
An image, video, font, or audio file is absent or does not render correctly.
Motion jumps, drifts, starts at the wrong time, or differs after seeking.
Export stops, produces the wrong result, or disagrees with Studio.
Preserve the exact message and collect enough context for an agent or issue.
Search known issues or report a reproducible problem.
## Studio will not open
1. Open a terminal in the HyperFrames project folder.
2. Run `npx hyperframes preview`.
3. Keep that process running while Studio is open.
4. Use the local URL printed in the terminal.
If the command says it cannot find a project, confirm that the folder contains the HyperFrames project rather than its parent folder.
## Preview is wrong or stale
Try these in order:
1. Save the changed file.
2. Reload Studio once.
3. Check the terminal for a build or runtime error.
4. Run the project checks below.
```bash
npx hyperframes lint
npx hyperframes check
```
`lint` checks the composition structure. `check` opens the project in a browser gate and catches runtime, layout, motion, and contrast problems.
## I cannot select or edit something
- Open **Layers** and select the element there when clicking the canvas is difficult.
- Confirm that you are in **Preview**, not Storyboard.
- Scrub to a time where the element is visible.
- Check whether the visual lives inside a nested composition.
- Ask the agent when the change affects source structure rather than one visible element.
[Open Studio troubleshooting →](/studio/troubleshooting)
## Media is missing or black
Check:
- the file still exists inside the project;
- the path and filename capitalization match;
- the source is local and available during rendering;
- the browser can decode the media format;
- the media is visible at the current time;
- the terminal does not report a download, decode, or CORS error.
Do not rely on a temporary signed URL or a render-time network request. Ask the agent to copy required media into the project.
## Animation is wrong
First decide whether the problem happens:
- during normal playback;
- only after scrubbing;
- only in the final render.
That distinction helps separate a timeline mistake from non-deterministic animation. HyperFrames animation must be seekable: the same frame should look the same every time it is requested.
Run `npx hyperframes check`, then share the smallest affected scene and the exact timestamp with your agent.
## Render failed or differs from preview
1. Preserve the complete render error.
2. Run `npx hyperframes check`.
3. Confirm that fonts and media are local and load before capture.
4. Check the affected timestamp in Studio.
5. Try the normal MP4 preset before changing codecs or advanced flags.
Use the [complete troubleshooting guide](/guides/troubleshooting) for codec, browser, FFmpeg, GPU, HDR, and deployment-specific failures.
## Copy a useful diagnostic
Send this block to your agent and fill in the visible facts:
```text
What I was trying to do:
What I clicked or ran:
What I expected:
What happened instead:
Exact error:
Where it happens: Studio / lint / check / render
Does it happen every time?
HyperFrames version:
Operating system:
Affected file or timestamp:
```
Add a screenshot or short recording when the failure is visual. Do not paste access tokens, credentials, private media, or other secrets into a public issue.
## Ask for help
Read short answers to the questions most likely to come up during first use.
Diagnose less common project, media, animation, rendering, and environment failures.
Explain a confusing or broken experience with useful context.
Find known problems or open a reproducible issue.