mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-10-31 10:55:57 +00:00
Miguel Ángel
061a5c0265
* docs: add Studio app pages for getting started with the Mac app Six short pages in a new Studio app tab: get the app, connect Claude Code or Codex, make your first video, change it with the agent, export, and updates and troubleshooting. Screenshots come from a neutral fixture project. * docs: cover Linux in the Studio app pages The app ships a Linux AppImage beside the Mac app. Install steps get Mac and Linux tabs, platform labels name both, and troubleshooting lists where projects, settings and exports live. * docs: correct Studio app sign-in, install and edit details First launch asks for HeyGen sign-in on the first click; the Mac download is a disk image with an installer inside; Select shows Prompt to edit; the Connect screen sends the waiting request itself; billing, export quality and update wording match the app. Open Terminal is described for both systems. * docs: keep Studio app tables readable on phones Three-column tables scrolled sideways at 390 px and the data-folder table broke paths mid-word; they become two-column tables and a short list. * docs: quote Studio app messages without their periods Quoted UI text no longer carries its own period into a sentence or table cell, and the Mac install step says the HeyGen check can take a minute or two. * docs: match Studio app installer and update messages Quote the installer's HeyGen check, damaged-download and slow-check messages, and the stalled-update messages with Download it instead and Settings' Download the latest version. * docs: fix Studio app sign-in timeout and Codex setup wording * docs: name Framey's stuck-update line in Studio app troubleshooting * docs: use one Studio app message per update state A stalled update says 'The update is taking longer than it should' and a failed one 'The update didn't finish', in Framey's line and on the card alike; Try again starts the update over. * docs: say Try again starts a new update, not one from zero
87 lines
4.2 KiB
Plaintext
87 lines
4.2 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.
|
|
|
|
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 two
|
|
minutes. If you see **No connection**, check your internet. If you see **The 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:
|
|
|
|
- **Full access**, the default: it can install, use the internet, and run anything, with no checks.
|
|
- **Auto**: it works in your project and blocks risky steps on its own.
|
|
|
|
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)
|