mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-03 04:07:03 +00:00
* docs(studio-app): show the app working, three new pages, today's UI * docs(studio-app): correct what the app does today (fact-checked against both repos' main) Script: audio goes to HeyGen to transcribe; cuts wait in Pending video edits until Send; today's toolbar; suggested cuts. Continue from Claude Code: Mac only, inside an agent session, catch-up after that hand-off, real output. GitHub Copilot added. 4K price, 10-minute sign-in, Auto as the default, real sign-in errors, motion-guide limit, the right-panel row. Looping clips pause and respect reduced motion. * docs(studio-app): hold the Share page until Share launches (desktop-share is at 0%) * docs(studio-app): Home screenshot from a regular account on b467 (Make, Reference, Script) * Revert "docs(studio-app): hold the Share page until Share launches (desktop-share is at 0%)" This reverts commit 201070ac7b7a551c5515c1a770be4a5e8ab36ab9. * docs(studio-app): Export link label names its page * docs(studio-app): where-is-it clips re-recorded on a regular account, b467 Staff-only items are gone (Pit Crew Academy, View as a user, the HyperFrames agent, Learn). # opens tools by typing; the tools list and the @ menu match a regular account; the import clip ends before the folder list. * docs(studio-app): new Script clip on a regular account: Cut, Pending video edits, Send 1 edit, 0:22 to 0:17 * docs(studio-app): Draw clip re-recorded on a regular account (Send 1 edit to Claude Code, 1 min 52 s edit) * docs(studio-app): Export clip re-recorded on a regular account (1080p, 16 s); cloud rendering as the app shows it * docs(studio-app): Video 1 change-a-clip demo re-recorded on a regular account (Up to $1.09 shown before Make) * docs(studio-app): Share clips re-recorded on a regular account; the page mentions HeyGen's Checking step * docs(studio-app): first-video demo re-recorded on a regular account (question cards, Send answer, 29 min storyboard, 10 min build) * docs(studio-app): Reference page follows today's flow (the app reads the video, then Copy editing style or Video brief; What to swap); demo re-recorded on a regular account * docs(studio-app): autoplaying demos start muted so browsers play them; Automatic updates in troubleshooting * docs(studio-app): update home.jpg in place instead of replacing it * docs(snippets): DocsVideo stops an autoplaying loop when Reduce Motion turns on mid-visit; play loads it again * docs(studio-app): motion guides need the person's picture; drop a pending cut by deleting its row; remove two unused stills
91 lines
4.4 KiB
Plaintext
91 lines
4.4 KiB
Plaintext
---
|
|
title: "Updates and troubleshooting"
|
|
description: "How the HyperFrames Studio app updates itself, and what to do when it says your agent is signed out, out of usage, or blocked."
|
|
---
|
|
|
|
## How updates arrive
|
|
|
|
The app checks for a new version when it opens and every few minutes after that. When one is ready, you get a
|
|
notification, a round update button appears in the bottom-right corner, and Framey points at it: **There's a new
|
|
update. Click here**.
|
|
|
|
1. Click the update button. It fills up as the update downloads.
|
|
2. The app restarts by itself as soon as nothing is running: no agent run, export, or setup in progress. It reopens
|
|
the project you had open, and you do not lose anything.
|
|
|
|
To check by hand, open **Settings** > **Updates** and choose **Check for updates**. On a Mac, **HyperFrames** >
|
|
**Check for Updates…** in the menu bar does the same. Some updates show a short video of what is new.
|
|
|
|
**Automatic updates** in **Settings** > **Updates** is on by default: the app updates itself while you're away. Turn it
|
|
off to update only when you click.
|
|
|
|
If an update says **The update is taking longer than it should** or **The update didn't finish**, click the update
|
|
button and choose **Try again** to cancel it and start a new one, or **Download it instead** to get the
|
|
latest version from the download page. **Download the latest version** in **Settings** > **Updates** also opens the
|
|
download page. If it says **Could not check for updates**, check
|
|
your internet connection, then try again.
|
|
|
|
## The app asks me to sign in to HyperFrames
|
|
|
|
Sending a request needs your HeyGen account. Choose **Continue with HeyGen** and finish in your browser within 10
|
|
minutes. If it says **Couldn't renew your sign-in** or **Couldn't finish signing in**, check your internet (and that a
|
|
VPN or proxy covers all apps). If it says **Sign-in timed out**, **Your sign-in expired** or **HeyGen didn't sign you
|
|
in**, choose **Try again**.
|
|
|
|
## You're signed out of Claude Code
|
|
|
|
The chat shows a sign-in card. Your message is kept. Choose **Sign in**, finish in your browser, and the message
|
|
sends as soon as you are back. Choose **Use Codex instead** to send it with Codex if Codex is ready.
|
|
|
|
For Codex, the chat says **Codex is not signed in**. Choose **Copy sign-in command**, run it in a terminal, then
|
|
choose **Try again**.
|
|
|
|
## My agent hit its usage limit
|
|
|
|
The chat says, for example, **Claude Code hit its usage limit. It resets** at a time. This is your agent's own plan
|
|
limit, not a HyperFrames one. Wait until it resets and choose **Try again**, or choose **Switch to Codex** (or
|
|
**Switch to Claude Code**) if the other agent is set up.
|
|
|
|
If the chat says the agent **had a problem on its side**, the agent's service is busy or down. Try again in a few
|
|
minutes.
|
|
|
|
## Claude Code blocked a step
|
|
|
|
**Agent access** in **Settings** > **Agent** decides what Claude Code may do:
|
|
|
|
- **Auto**, the default: it works in your project and blocks risky steps on its own.
|
|
- **Full access**: it can install, use the internet, and run anything, with no checks.
|
|
|
|
With **Auto**, a step Claude Code refuses shows as blocked in the run's work log. If the change needed that step,
|
|
switch to **Full access** and send the request again.
|
|
|
|
## The agent is not installed or won't start
|
|
|
|
The chat says Claude Code **is not installed**. Choose **Try again** and the app sets it up for you. If
|
|
Claude Code is installed but will not start, choose **Reinstall** in **Settings** > **Permissions**. See
|
|
[Connect your agent](/studio-app/connect-your-agent) for the manual commands.
|
|
|
|
## Other messages
|
|
|
|
| The chat says | Do this |
|
|
| --- | --- |
|
|
| **… ran out of room in this chat** | Choose **Start a fresh session**. |
|
|
| **… needs an update to use** a model | Choose the update button in the chat. |
|
|
| **… could not reach the internet** | Check your connection, then **Try again**. |
|
|
| **… could not finish this change** | Choose **Try again**, or say the change differently. |
|
|
|
|
## Where your work is kept
|
|
|
|
- **Your projects**: the hidden `.hyperframes-studio` folder in your home folder.
|
|
- **Exported videos**: your Downloads folder.
|
|
- **App settings and sign-in**: `Library/Application Support/HyperFrames` in your home folder on a Mac, and
|
|
`.config/HyperFrames` in your home folder on Linux.
|
|
|
|
Each project is a plain HyperFrames project folder, so it also opens in the
|
|
[Studio web editor](/studio/index) and with the [command line](/developers/cli).
|
|
|
|
## Related topics
|
|
|
|
- [Connect your agent](/studio-app/connect-your-agent)
|
|
- [Export your video](/studio-app/export)
|