astrofox

Astrofox 是一个动态图形程序，旨在将音频转换为视觉视频。它作为 MIT 许可下的开源项目分发，既可以作为网页应用运行，也可以作为离线桌面应用运行。 核心工作流程 项目以本地 .afx 文件的形式打开和保存。README 指出，.json 项目和旧版 gzip 压缩的 .afx 项目仍可打开。该应用被描述为客户端 Next.js 应用，开发时无需后端或认证服务。 从源代码运行 README 记录了基于 pnpm 的工作流程：克隆仓库，使用 pnpm install 安装依赖，使用 pnpm build 构建，并使用 pnpm start 启动。对于开发，pnpm dev 运行应用。 网页部署 提交通过 Vercel 使用标准 pnpm build 脚本部署。README 警告不要更改此脚本以用于桌面打包。 桌面（Electron，离线） 开发使用 pnpm dev:desktop，它结合了 Next 开发服务器和 Electron 外壳。生产打包使用 pnpm package，它使用 BUILD_TARGET=desktop 将静态导出到 out/，然后使用 electron-builder 打包 electron/ 和 out/。安装程序写入 release/。平台特定和未打包变体可通过 pnpm package:dir、package:mac、package:win 和 package:linux 获得。 文件输入/输出 网页和桌面共享相同的浏览器选择器，使用文件系统访问 API，并提供输入/下载回退。Electron 桥接仅用于窗口边框、临时文件和 ffmpeg 导出，仅在需要时使用绝对路径。更多细节见 docs/desktop-capabilities.md。 视频导出 在网页上，导出使用浏览器 MediaRecorder（WebM，或支持时使用 MP4）。在桌面上，导出执行离线帧渲染，然后使用内置 ffmpeg 二进制生成 MP4（H.264/AAC）。打包命令下载平台二进制并将其包含在 bin/ 下。 社区和支持 README 链接到演示视频、项目网站、Discord 聊天、Reddit 论坛和 GitHub 问题跟踪器以报告错误。