Astrofox is a motion graphics program that lets turn audio into amazing videos.
- Demo video: https://www.youtube.com/watch?v=IbvuniqNPPw
- Website: https://astrofox.io
- Discord chat: https://discord.gg/wJ6pyMZ
- Reddit forum: https://www.reddit.com/r/astrofox/
- Bug tracker: https://github.com/astrofox-io/astrofox/issues
git clone https://github.com/astrofox-io/astrofox.git
pnpm install
pnpm build
pnpm start
Run:
pnpm dev
Astrofox is a client-side Next.js app. Projects are opened and saved as local .afx files (.json and legacy gzip-compressed .afx projects can still be opened). There is no backend or auth service required for development.
File I/O: web and desktop use the same browser pickers (File System Access API, with <input> / download fallbacks). The Electron bridge is reserved for window chrome, temp files, and ffmpeg export (absolute paths only when needed). See docs/desktop-capabilities.md.
Fonts: Inter is the only bundled font and the default for new text layers. Desktop scans installed font families through Chromium's Local Font Access API; it never downloads text fonts. The web picker searches the Google Fonts catalog and loads selected families and their available regular/bold/italic faces from Google's CSS API on demand. Internet access is required for uncached web fonts. Projects keep their font family names; unavailable families fall back to Inter.
src/lib/config/googleFonts.json is a metadata snapshot from
https://fonts.google.com/metadata/fonts (no font files or API key). Refresh it
with pnpm fonts:refresh when updating the catalog. This metadata endpoint is
not a documented API contract; refreshes validate the expected response shape.
Commits deploy through Vercel using the standard build:
pnpm build
Do not change this script for desktop packaging.
Development (Next dev server + Electron shell):
pnpm dev:desktop
Production package (static export + electron-builder):
pnpm package
Desktop uses BUILD_TARGET=desktop for a static export into out/, then packages electron/ + out/. The web Vercel path is unchanged. Installers are written to release/.
Platform-specific and unpacked variants:
pnpm package:dir
pnpm package:mac
pnpm package:win
pnpm package:linux
MCP automation: turn on Enable MCP server in desktop Settings → MCP server, then copy the connection details shown there. The setting and token persist across app restarts. See MCP setup and tools.
Video export
- Web: browser
MediaRecorder(WebM/MP4 when supported) - Desktop: offline frame render → bundled ffmpeg → MP4 (H.264/AAC). Packaging commands download the platform binary and include it under
bin/.
MIT