Videohub README

项目的 README,来自 github.com/TensaikunYT/Videohub。合并为一个 markdown 文件:README.md。

VideoHub

A local review studio and render queue for videos that Claude Code or OpenCode writes as code. Ask your agent for a video. It builds a film as a web page that draws every frame in code. VideoHub plays the film straight from its code, so you can watch it, step through frames, draw and leave notes before rendering. Send the notes back to your agent, review the fixes in the reloading preview, then render when you are ready. The queue keeps the computer usable and can re-render only the seconds that changed.

Windows 10/11, Linux and macOS; Claude Code or OpenCode. Linux and macOS are new, not yet tested on real machines. See platform support for feature limits and the remaining hardware checks.

Live preview with a note on a frame

Features

Projects

Render protection and speed

Built into the Node server, with no compiled helper:

Renders

Requirements

All platforms need Node.js 22+, ffmpeg on PATH, a native Chrome/Chromium/Edge browser for headless rendering, and Claude Code or OpenCode for making and fixing films. No native modules or compiled render-protection helper are required.

Platform Install missing tools Notes
Windows 10/11 winget install -e --id OpenJS.NodeJS.LTS; winget install -e --id Gyan.FFmpeg Edge or Chrome; setup retains the existing Windows paths
Linux desktop Your distribution's Node 22+ package; sudo apt install ffmpeg, sudo dnf install ffmpeg, or sudo pacman -S ffmpeg Install a native browser; Snap/Flatpak browser wrappers are unsupported. Optional taskset, zenity/kdialog, notify-send
macOS With Homebrew: brew install node ffmpeg; brew install --cask google-chrome, or Chrome from its download page Chrome / Edge / Chromium in /Applications or ~/Applications; Apple Silicon and Intel code paths need hardware verification

A graphical desktop session is needed for windows, folder dialogs, desktop notifications and file-manager actions. A compatible graphics encoder is optional.

Install

Download the ZIP and unpack it, or clone the repository into a folder you want to keep. Open that folder in Claude Code or OpenCode and ask it to install VideoHub, or run the installer yourself. Setup asks about the workspace, discovered video folders, graphics encoding, agents, review rule, shortcut, login startup and example film. Re-runs keep existing answers, folders and settings.

Windows

Double-click SETUP.cmd. It runs the shared Node installer directly. Preview the steps with node scripts/install.mjs setup --dry-run; --yes accepts recommended answers. Examples: --workspace "D:/Videos/VideoHub" and --agents claude,opencode. The same answer flags shown below work on every platform.

The .ps1 setup/update/uninstall files are compatibility forwarders and respect PowerShell's existing policy. If that policy blocks one, use the Node command or .cmd entry point; no policy change is needed.

Open VideoHub from its Desktop shortcut or open.cmd. The shortcut starts the installed Node.js executable directly; a console window may appear briefly. open.cmd and login startup may also show a short console window. The current launch path uses neither VBScript nor hidden PowerShell. Update migrates owned shortcut/startup entries and recycles the old open.vbs / open.ps1 only when those references are safe; custom, unreadable or failed migrations retain the files and show a warning. Start a new session in your selected agent to load hub_* tools.

Linux and macOS

Run chmod +x setup.sh update.sh uninstall.sh open.sh, then ./setup.sh. Preview first with ./setup.sh --dry-run --agents opencode. Setup prints missing-system-tool instructions instead of silently installing system packages.

Flags: --yes, --workspace PATH, --agents claude,opencode, and --watch-found, --gpu-encoder, --global-rule, --shortcut, --startup, --example with yes or no. Launch with ./open.sh. Linux also installs an application desktop entry and can add a Desktop copy.

On macOS the optional Desktop launcher is VideoHub.command, which briefly opens Terminal. There is no unsigned .app bundle. If macOS blocks the downloaded launcher, attempt to open it, then go to System Settings → Privacy & Security → Open Anyway, confirm, and open it again. You can also launch with ./open.sh from the installed folder.

Claude Code and OpenCode

Setup detects the installed agents. Select one or both with --agents claude,opencode on every platform; legacy Windows -Agents spelling remains accepted. Each receives its own local MCP registration, the shared skill and the optional marked review rule. Restart the selected agent after setup.

OpenCode's rules live in ~/.config/opencode/AGENTS.md (under $XDG_CONFIG_HOME if set). When that file exists OpenCode reads it instead of Claude's global compatibility rules. Setup prints this consequence and never copies unrelated personal rules between agents. Settings → Agent name controls the review button label.

Your first film

  1. If setup added the example film, its card is on the Projects page. Otherwise the page shows Welcome to VideoHub with your workspace and films folder (<workspace>\films): click ▶ Add the example film.
  2. Click its card: it opens in the live preview. Press Space, step with ← →, click on the video to leave a note.
  3. Press 🎬 Render → Full film: the queue renders 5 two-second chunks and saves hello-film_v1.mp4 with sound.
  4. Leave a note on a frame, change film.js (e.g. a colour), then 🎬 Render → Only the fixed parts: only the touched chunks are rendered again → hello-film_v2.mp4, and Watch only the changes plays them. What a film folder must contain for each feature: docs/PROJECT-CONTRACT.md. New films start from templates/new-film.

Working with your agent

  1. Ask Claude Code or OpenCode for a video. It builds the film from the template.
  2. Preview — when it plays, the agent calls hub_live, opens the film in VideoHub and stops for your review.
  3. Notes — watch, leave notes, press Send to Claude / OpenCode and paste the message into your chat.
  4. Fix — the agent reads hub_notes, edits the code and marks the fixes. The preview updates itself; repeat as needed.
  5. Render — when you ask, the agent calls hub_render, or you press Render. Later fixes can render only the changed chunks; use Watch only the changes and Check fixes to review them.

If MCP tools are not loaded, the same tools work through node <VideoHub>/server/cli.js <tool> "<json>".

Optional integrations

Feature Needs Without it
Ready-made sound effects a 3D studio engine with engine/audio/synth.js (studioDir in Settings) your own sound folder and files from disk
Scene editor / 2D layers in the preview the page includes the hooks from engine-hooks/ those editors are hidden
Snipp export status Snipp writing .renders\*.json in a watched folder not shown
Settings → Optional parts on this computer shows what was found.

Security

VideoHub is a local tool. The server listens on 127.0.0.1 only and refuses requests with a foreign Host, cross-site requests from other web pages and writes with a foreign Origin. Its render queue can run shell commands for your projects, so never expose port 7788 (no port forwarding, no tunnels, no 0.0.0.0 proxies). It only serves files inside your watched folders, the archive and its own folders.

Windows launch and security warnings

Windows setup, update and uninstall use the shared Node lifecycle commands listed in the security guide. SETUP.cmd and UPDATE.cmd call Node directly. Normal launch uses open.cmd → Node → scripts/install.mjs open; new Desktop shortcuts and login startup also use the installed Node executable. None of these paths changes PowerShell's execution policy or adds a policy override. Windows integrations still use transparent commands and installed Windows/.NET libraries where needed: the picker loads WinForms, and Trash uses the installed Recycle Bin API. Nothing compiles inline C# or custom P/Invoke helpers.

See Windows security guidance for the current behavior, exact-alert evidence and upgrading an older distributed copy.

These changes simplify the launch and system-integration paths. They do not establish that a security alert is a false positive or guarantee that a vendor will accept every downloaded version. Record the security product, exact warning or detection ID, affected file and VideoHub version before deciding what needs review. node scripts/windows-security.mjs prints local source fingerprints and retired-helper presence without reading antivirus history or uploading anything; it is not an antivirus scan.

Warning type What to distinguish
Antivirus malware detection A named threat/detection for a file needs investigation of that exact file and verdict. Keep the blocked item blocked during review.
SmartScreen / unknown publisher / reputation warning Publisher identity and download reputation are separate from a named malware detection. The exact message identifies which check was involved.
Smart App Control block This is an application-control trust decision. It is not interchangeable with an antivirus detection or a script-policy error.
PowerShell scripts disabled / unsigned-script error This is a script-policy restriction. Use the direct Node lifecycle command instead of the optional .ps1 compatibility entry; no policy setting needs to change. Other application-control restrictions still need the computer's approved deployment process.

If an examined distributable still receives a malware detection, use that product vendor's official file-review process for the exact affected file. Review what the submission contains first; VideoHub does not upload files to scanners or vendors automatically. Disabling security protection, adding broad exclusions or bypassing download/script policies is not part of setup.

Update

Download the new version and unpack it separately. Windows: double-click UPDATE.cmd, or run node scripts/install.mjs update --target "C:/path/to/installed/VideoHub" --dry-run, then repeat without --dry-run. Linux/macOS: from the new copy run ./update.sh --target /path/to/installed/VideoHub --dry-run, then repeat without --dry-run.

The update backs up replaced code and keeps the workspace, settings, queue, films and notes. Use the existing launcher afterwards and restart your agent session. Downloaded or shared copies do not change automatically: distribute this version and explicitly update each installed copy that needs it.

Uninstall

Windows: from the installed folder run node scripts/install.mjs uninstall --dry-run, then repeat without --dry-run or use UNINSTALL.cmd. Linux/macOS: ./uninstall.sh --dry-run, then ./uninstall.sh from the installed folder.

Only integrations owned by this install are removed: MCP entry, skill, managed rule block, shortcut and login startup. Reversible removals use Trash / Recycle Bin. Films, notes, outputs, settings and the program folder remain.

Troubleshooting

Development

npm test runs the suites; see CLAUDE.md and docs/ARCHITECTURE.md.

License

MIT © 2026 VideoHub contributors.

Videohub (TensaikunYT/Videohub)

正在搜索数据库…

这是什么?这是一个本地审阅工作室和渲染队列,用于处理 Claude Code 或 OpenCode 以代码形式编写的视频。你让智能体做一段视频,它会把影片做成网页,你可以在自己的电脑上预览、留下批注并渲染成视频。
这是视频编辑器,还是别的什么?不是传统的时间线编辑器。每部影片都是代码:一个逐帧绘制画面的网页。VideoHub 实时预览,并可渲染为 mp4;你通过在帧上留下批注提出反馈,智能体随后在代码中修改。
我该怎么让它运行起来?下载 ZIP 压缩包或克隆仓库,然后在 Claude Code 或 OpenCode 中打开该文件夹,让它帮你安装 VideoHub。也可以在 Windows 上运行 SETUP.cmd,在 Linux 和 macOS 上运行 ./setup.sh。使用桌面快捷方式启动,或运行 open.cmd / ./open.sh。
我需要先安装 Node.js 或 ffmpeg 吗?需要。你需要 Node.js 22+、已加入 PATH 的 ffmpeg、用于无界面渲染的已安装 Chrome、Chromium 或 Edge 浏览器,以及用于制作和修改影片的 Claude Code 或 OpenCode。不需要任何原生模块。
它在 Linux 和 macOS 上能像在 Windows 上一样运行吗?Windows 10/11 是主要测试平台。Linux 和 macOS 是新支持的平台,尚未在实际机器上测试。macOS 上会隐藏渲染功率和慢速 CPU 滑块,因为该系统没有受支持的 CPU 核心绑定接口。
硬件编码器能加快我的渲染速度吗?可以,前提是你的显卡支持:Windows 上为 NVENC、AMF 或 QSV,Linux 上为 NVENC、VAAPI 或 QSV,macOS 上为 VideoToolbox。程序会用一个简短的探测检查已安装的 ffmpeg 支持哪些编码器。若都不可用,则回退到处理器上运行的 x264。
影片底层是什么样的?它是一个网页,暴露 window.renderOut(t) 接口,该接口绘制时间 t 处的画面。实时预览和最终 mp4 来自同一份代码,因此预览与成片逐帧一致。
我如何针对某一帧提出反馈?点击或在任意一帧上绘制,或选择一段帧范围,然后输入问题所在。智能体随后会通过 hubnotes 获取时间、帧、片段,以及你所绘内容的局部特写图。
渲染队列内存不足时会怎样?当可用内存低于阈值时,最新的渲染会变慢;内存降至危急水平时,所有渲染都会变慢。你也可以放慢、恢复常速或停止渲染,而且 VideoHub 绝不会关闭其他占用内存的程序。
我能在影片中处理声音吗?可以。你可以对每个分轨进行静音、独奏或设置音量,去掉音乐,在指定时段压低音乐,并从素材库或磁盘将声音添加到时间线上。渲染时使用重新合成的混音。
大小
2.3 MB
星标
526
时长
7天
提交 · 90 天