storytold/effectcraft

选用指南

AI 根据 README 整理 · 2026/10/16 23:36:29

适用场景

适用于动画标题、动态图形和合成工作，用户可构建由图层组成的合成，通过关键帧动画属性并叠加特效后渲染输出。

查看 README 依据

<a href="#license-and-credits">License</a> </p> ## What EffectCraft is EffectCraft is for animated titles, motion graphics and compositing work: the kind of thing people reach for After Effects to do. You build a composition out of layers (solids, shapes, text, footage, other compositions), animate their properties with keyframes, stack effects on them and render the result. The aim is to feel familiar to anyone who has used After Effects, with the same panels (Project, Composition, Timeline, Effect Controls, Effects & Presets) and the same keyframe behaviour, and

目标用户

面向熟悉 After Effects 的用户，界面和快捷键设计使其能快速迁移操作习惯。

查看 README 依据

<a href="#license-and-credits">License</a> </p> ## What EffectCraft is EffectCraft is for animated titles, motion graphics and compositing work: the kind of thing people reach for After Effects to do. You build a composition out of layers (solids, shapes, text, footage, other compositions), animate their properties with keyframes, stack effects on them and render the result. The aim is to feel familiar to anyone who has used After Effects, with the same panels (Project, Composition, Timeline, Effect Controls, Effects & Presets) and the same keyframe behaviour, and

- **No FFmpeg.** Video and audio decoding and encoding are pure Rust: FilmCraft's codecs and EffectCraft's own VP9, AV1, HEVC and Opus encoders. ## Animate The panels, menus and shortcuts follow After Effects, so your muscle memory carries over: Project, Composition, Timeline, Effect Controls, Properties, Effects & Presets, Character, Paragraph, Align, Info, Preview, Audio and the Render Queue, docked the way you expect. Drag footage, comps and effects between them: onto the comp viewer, where they land under the pointer, or into the Timeline, between layers and at the time you point to.

使用方式

提供桌面应用和命令行工具，可通过命令行执行渲染、设置属性等操作，并支持 MCP 服务器供代理调用。

查看 README 依据

Everything you can do from a menu is a command with an id, and agents can reach every one of them: - **MCP server:** `effectcraft-cli mcp` speaks the Model Context Protocol over stdio, headless or bridged to the running app (`--bridge 9877`). Tools cover commands, the project and property tree, keyframes and rendered frames. This repository ships a ready [`.mcp.json`](.mcp.json). - **Command line:** one-shot calls with JSON output, for example `effectcraft-cli set Main '#1' transform/position '[100,360]' --time 0 main.ecproj --save`

or `effectcraft-cli render --comp Main --out main.mp4`, or `effectcraft-cli exec file.exportLottie '{"comp":"Main","path":"main.json"}' main.ecproj`. - **Control channel:** `effectcraft --control 9877` accepts JSON lines to run commands, inspect and click any widget by its automation id, and take screenshots. See [docs/agents.md](docs/agents.md) and [docs/control-protocol.md](docs/control-protocol.md). ## Get started Installers for each version are on the [Releases](https://github.com/storytold/effectcraft/releases)

部署要求

自行构建需要 Rust 1.95 或更高版本；官方提供 Windows、macOS、Linux、FreeBSD 及 Web 构建的安装包。

查看 README 依据

On Gentoo, the community [::snakebyte overlay](https://github.com/switch87/snakebyte-overlay) packages the Linux release as `media-video/effectcraft-bin` (not maintained by the EffectCraft team): ```sh eselect repository add snakebyte git https://github.com/switch87/snakebyte-overlay.git emaint sync -r snakebyte echo 'media-video/effectcraft-bin ~amd64' >> /etc/portage/package.accept_keywords/effectcraft emerge --ask media-video/effectcraft-bin ``` To build it yourself you need [Rust](https://rustup.rs/) 1.95 or newer. ```sh git clone https://github.com/storytold/effectcraft cd effectcraft

page: a universal macOS app; Windows MSIs and portable zips for x64, x86 and ARM64; Linux AppImage, Flatpak, deb, rpm and tar.gz for x86_64 and aarch64, plus a riscv64 tar.gz; a FreeBSD x86_64 tarball; and the web build. [Downloads](#downloads) lists every file. The Windows ARM64 build runs natively on Windows on ARM, without x64 emulation. CI installs that MSI on Windows 11 ARM64 hardware, checks both programs are ARM64 and runs the command-line tool there, but it doesn't open the app's window or run the test suite natively on ARM64 yet, so please report anything that behaves differently.

已知限制

项目处于 alpha 阶段，无法打开 After Effects 项目文件（.aep/.aepx），行为与 After Effects 仍有差异，macOS 是测试最充分的平台。

查看 README 依据

- **After Effects projects can't be opened.** Projects are saved as `.ecproj`, readable versioned JSON, but EffectCraft can't open `.aep` / `.aepx` files, and After Effects plug-ins don't run. - **Behaviour still differs from After Effects in places.** Nothing yet compares our renders with After Effects automatically, so please report differences. - **macOS is the most tested platform.** Linux and Windows users have hit basic interaction bugs, which we're fixing first. - **The trained models are new.** Roto Brush can use MobileSAM (an optional 40 MB download in

tests, layering, asset attribution and the WebAssembly build). See [CONTRIBUTING.md](CONTRIBUTING.md), [docs/architecture.md](docs/architecture.md) and [docs/testing.md](docs/testing.md). ## Where it stands EffectCraft is young: its first commit was on 1 October 2026. Nearly every After Effects feature exists, including all of its effects, but existing is not the same as behaving exactly like After Effects, and we haven't measured that yet. Today it's a good place to try things and to tell us what breaks. It isn't yet a replacement for After Effects on client work. In particular: