phucnguyentvp1 / frameweaver

Tiếng Việt ·
 Quick start ·
 Documentation ·
 Downloads ·
 Report an issue 
# FrameWeaver
**A local video workspace for scenes, narration, audio, and timeline editing.**
FrameWeaver brings a React dashboard, Python backend, and Chrome extension into
one workflow. Plan scenes, reuse character references, generate through your own
Google Flow session, prepare narration, and assemble clips with FFmpeg.
Developed and maintained by phucnguyentvp1,
FrameWeaver combines scene production with a broader editing workspace: layered
timelines, media libraries, speech analysis, narration, subtitles, and saved exports.
The project is currently available as a preview release.
## macOS desktop beta
**Download FrameWeaver 1.3.1 beta 4 for Mac**
— macOS 13 or later. Choose the installer for your Mac:
| Mac | Installer | Size |
| --- | --- | --- |
| Apple Silicon (M1 or later) | arm64 DMG | 239 MB |
| Intel | x64 DMG | 255 MB |
Both DMGs are Developer ID signed, Apple notarized, and stapled. Open one and drag
FrameWeaver into Applications; Python and FFmpeg are included. Optional AI models
and provider accounts are configured separately.
For Google Flow, download the **Chrome extension ZIP (0.3.6, ~379 KB)**,
shared by both Mac editions. Extract it, open `chrome://extensions`, enable
**Developer mode**, choose **Load unpacked**, and select the extracted `extension`
folder. You can also get it from the app menu **Ứng dụng → Cài extension Google Flow…**.
Both installers package the application snapshot from **20 October 2026**,
including **one-click ChatGPT component installation**, **Reload interface**,
**live extension status**, the **Google Flow connection check**, and **Muse gateway setup/autostart**. See the
beta 4 release guide for installation and
verification details. The older beta 3, beta 2
and beta 1 remain available. Intel was tested through Rosetta, not on a physical Intel Mac.
### ChatGPT setup without Terminal
Open **Settings → ChatGPT**, install the optional component if it is missing,
then **Sign in with ChatGPT**. The app downloads the pinned official OpenAI
Codex CLI with SHA256 verification; no Node.js or administrator installation is
needed. A separate **Test AI** button sends a small request using your account's
allowance. Existing Codex installations take priority. See the
ChatGPT setup guide.
**Reload interface** is available in the top bar. Extension status also updates
immediately after a connection check and refreshes automatically on reconnect.
### Muse AI in both Mac editions
Use Muse for **script planning, reference/scene images, and video from a starting
image**. Open **Settings → Muse → Cài và khởi động Muse** to install and start
its optional muse2api gateway. The app saves
the local key and can start the installed gateway on later launches. Status,
cancel, restart/stop and logs are available in Settings; no Terminal or dashboard
is needed for the normal setup. Install Chrome and connect your Muse session
once in the app, then choose