Skip to content

About

A Windows workspace for After Effects: effect previews, presets, curve easing, and media library in one panel.

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

DreamEngine

After Effects 效果、预设、曲线和素材的一体化工作面板

English · 中文

GitHub Stars Release MIT License

Windows After Effects 2021+ CEP 11 DreamEngine Hub 0.3.0-beta.1 DreamEngine Panel 0.3.0

Beta 状态:DreamEngine 面向 Windows,当前在 After Effects 2021 / CEP 11 上完成主要实机验证。更新版本的 AE 尚未完成完整验收。

下载与安装

当前版本:DreamEngine 0.3.0 / v0.3.0-beta.1

从 GitHub Releases 下载:

  • DreamEngine-Hub-Setup-0.3.0.exe
  • SHA256SUMS.txt

安装步骤:

  1. 在 After Effects 中保存工程并退出。
  2. 运行安装器,选择安装目录并完成安装。
  3. 启动 After Effects,打开 窗口 > 扩展 > DreamEngine。

安装器未签名,Windows SmartScreen 可能显示“未知发布者”。升级会替换程序文件和内置预览资源,但不会删除用户预设、分类、收藏或已生成的预览。

最短上手

在 AE 面板中使用

页面 操作
效果 搜索或筛选效果;双击添加到当前选中图层;悬停播放动态预览
预设 单击应用 .ffx 预设;使用左侧分类与收藏筛选
曲线 两点/多点编辑;读取、反向、换键、冻结;应用或保存曲线预设
素材 选择一个根目录后可进入子文件夹;顶部面包屑点任一段回退;单击预览;双击导入并放到当前合成时间位置

在 DreamEngine Hub 中使用

Hub 是不依赖 AE 主进程的独立管理程序,主要用于:

  • 添加、重命名、收藏、分类和长按删除 .ffx 预设。
  • 为第三方插件预设生成离线预览图与动态帧序列。
  • 使用当前 AE 的插件清单,在独立 AE 实例中逐条生成第三方效果预览。
  • 在「效果库」按 AE 分类浏览内置效果和第三方插件效果,未生成预览的条目显示为待渲染。
  • 对单条预设清空旧预览,或强制单独重渲。
  • 添加自定义预览背景。
  • 查看面板安装状态、AE 版本、目录和渲染日志。

预设分类和预设收藏由 AE 面板与 Hub 共用。

功能说明

DreamEngine Hub

预设库

  • 支持文件选择或拖入 .ffx。
  • 左侧分类支持新建、重命名和删除;分类栏可拖动调整宽度,双击分隔条或点「«」收起,收起后点工具栏「分类 »」展开。
  • 收藏是独立筛选,可与分类组合使用。
  • 动态预设悬停播放;静态预览以右上角橙色圆点标识。
  • 右键菜单提供:重命名、收藏、取消渲染、单独渲染、删除预设、移动到分类。
  • “取消渲染”会删除该预设的索引与帧文件,使其回到待渲染状态,并重新参与下一次批量渲染。
  • 长按卡片或使用右键菜单可删除预设库中的 .ffx。
  • 可自动索引当前所选 AE 的安装 Presets 与 User Presets 中的 .ffx(只建索引、不复制文件),并在预设页按来源筛选;外部 AE 预设可以勾选渲染和单独渲染,但重命名/删除只作用于 DreamEngine 自己的预设库。左侧分类栏会把外部预设按 AE 来源文件夹(如 Text、Trapcode Tao)分组。

效果库

  • 与预设库同款布局:左侧分类栏可拖动/收起,右侧预览网格支持搜索、来源筛选和悬停播放。
  • 内置效果与「渲染 → 插件效果」里扫描到的第三方效果统一列出:已生成预览的悬停播放,还没生成的显示为「待渲染」占位。
  • 左侧按来源分组(AE 内置 / BCC / Sapphire / Red Giant / RE:Vision / Video Copilot / 其它插件),每组可展开或折叠,折叠状态会被记住;分类与分组都来自当前 AE 的扫描结果。
  • 分类同步当前 AE:内置效果用双语名字表里的 AE 分类,插件效果用插件目录扫描到的 AE 分类。
  • 插件预览按「插件 + 效果显示名」复用;插件升级或 matchName 改变时不要求重新渲染,当前版本已不存在的旧预览只计为历史预览。
  • 「同步 AE 分类」会重新扫描插件效果目录(只扫描、不渲染),刷新分类后自动回到效果库。

离线预览渲染

  • “插件效果”页会自动读取当前 AE 的插件清单,逐条隔离渲染,并支持停止、断点继续和崩溃黑名单。
  • “插件效果”页可先“扫描插件目录”,按插件/分类/名称勾选指定效果,只渲染所选条目;勾选“强制重渲”可重新渲染已生成或已跳过的效果。
  • Sapphire Transitions 系列会自动使用前景 / 背景两层输入并开启 Auto Trans,生成完整转场动画;S_Transition Builder 仍需载入具体转场预设后才能预览。
  • 预设页支持多选预设,只渲染所选;也可一键选择当前筛选下所有未渲染的预设。
  • 文本 / 动画类 AE 预设(AE 自带的 Text、Behaviors、Transitions 等)不新增效果,预览会先自动落在合成里的文本层上;没有文本层时自动改用「文字」素材渲染,不再误报「应用失败」。
  • 插件预设通过独立的 AE 实例渲染,避免破坏正在使用的 AE 会话。
  • 默认每个专用 AE 实例连续处理最多 40 条,减少重复启动。
  • 渲染前必须保存并关闭 AE;任务完成后可按原状重新打开 AE。
  • 渲染模板按所选 AE 主版本首次自动生成并复用,避免用 AE 2023 创建的 AEP 去启动 AE 2021。
  • 支持内置与自定义预览背景。
  • “单独渲染”只处理所选预设,并强制绕过已有预览和失败黑名单。

设置与诊断

  • 查看 Hub、面板和内置预览版本。
  • 在介绍页检查 GitHub Releases 更新,并在发现新版本时打开下载页。
  • 查看已安装的 AE 版本与运行状态。
  • 打开扩展、预设库和日志目录。

AE 面板

效果

  • 按名称或分类排序,按插件来源筛选。
  • 动态预览悬停播放,静态效果保持静止。
  • 双击效果或点击卡片上的添加按钮,将效果加入当前选中图层。
  • 收藏效果,并与分类条件组合筛选。
  • 可在设置中上传普通画面类效果的自定义预览背景。

预设

  • 浏览已导入预设及预览。
  • 预设库与 Hub 同步:递归显示用户库,并合并 Hub 索引的 AE 安装预设和 User Presets;外部预设按 AE 来源文件夹分类、只读且不复制文件。
  • 单击应用预设;长按可删除库内预设。
  • 分类和收藏与 Hub 双向共用。
  • 动态预设悬停播放;静态预设显示橙色圆点。

曲线

  • 支持两点和多点曲线模式,并提供值曲线、速度曲线和空间路径图。
  • 多点模式可双击插入节点、拖动节点与把手,并用 Delete/Backspace 删除中间节点。
  • 工具栏支持读取当前曲线、曲线反向、关键帧交换、左右冻结、0.1 网格磁吸以及本地撤销/重做。
  • 可保存单点和多点自定义曲线预设,并长按删除已有预设。
  • 多关键帧应用要求正好选中两个关键帧,只写入该区间;已有用户原生中间键时拒绝改写。
  • 写入前检查关键帧是否发生变化,避免覆盖并发修改;整批应用可通过一次 AE 撤销恢复。

素材

  • 只登记一个素材根目录,不复制、不移动、不修改源文件。
  • 按目录浏览:进入子文件夹、点顶部面包屑逐级回退;文件夹卡片显示该目录下的素材数量。
  • 分类计数与搜索都只统计当前所在目录;空文件夹不显示。
  • 刷新与更换根目录在右上角,刷新后保留当前目录;目录被删除时自动回退到最近仍存在的上级。
  • 自动分类视频、图片、音频、.aep 工程和 .jsx/.jsxbin 脚本。
  • 视频单击后播放,视频预览最多截取 5 秒。
  • 音频显示面板内生成的波形,并支持单击播放/停止;波形生成不依赖 FFmpeg。
  • 双击视频、图片或音频,导入项目并添加到当前合成的时间指示器位置。
  • .aep 只导入工程,不解析内容或作为素材层加入合成。
  • 素材收藏可与分类组合筛选。

环境要求

  • Windows 10 或 Windows 11
  • After Effects 2021(18.0)或更高版本
  • 推荐安装 ffmpeg,用于部分视频缩略图/预览缓存

未安装 ffmpeg 时,音频波形、播放和导入仍可使用;部分不兼容视频的缩略图/预览可能显示为空。

实机截图

After Effects 面板

DreamEngine 效果面板

DreamEngine Hub

DreamEngine Hub

用户数据

DreamEngine 不上传工程、素材或预设。

路径 内容
文档/DreamEngine/presets/ 用户 .ffx 预设
文档/DreamEngine/backgrounds/ 自定义预览背景
文档/DreamEngine/preset_categories.json 预设分类与预设收藏
文档/DreamEngine/materials/ 素材索引与视频预览缓存
文档/DreamEngineProbe/ Hub 渲染状态与日志
%APPDATA%/Adobe/CEP/extensions/com.dreamengine.panel/ 已安装面板及内置预览索引

效果收藏、素材收藏、曲线预设和部分面板设置仍保存在 CEP 面板的本地 localStorage 中。

升级会保留预设与缓存。通过 Windows 设置或开始菜单卸载 DreamEngine 时会完全清理面板脚本、预设库、背景、缓存、日志、CEP localStorage 和相关注册表设置;如需保留预设,请在卸载前备份 文档/DreamEngine/。

常见问题

AE 菜单里没有 DreamEngine

  1. 确认安装器和 AE 使用同一个 Windows 用户。
  2. 完全退出并重新启动 AE。
  3. 在 Hub 的“设置”页确认面板安装状态和扩展目录。

插件预设无法渲染

  • 保存并关闭所有 AE 实例后,再从 Hub 开始渲染。
  • 检查 Hub 的渲染日志和 文档/DreamEngineProbe/。
  • 确认本机安装了预设依赖的第三方插件。

素材没有预览

  • 安装 ffmpeg,或在 文档/DreamEngine/materials/ffmpeg.txt 中填写 ffmpeg.exe 的绝对路径。
  • 回到素材页点击“刷新”。

反馈与贡献

  • 使用 Bug 模板 报告可复现问题。
  • 使用 功能建议模板 提议新工作流。
  • 提交问题时请附上 DreamEngine、Windows、After Effects 和 CEP 版本,以及 文档/DreamEngineProbe/ 中的相关日志。
  • 提交代码前请阅读 PR 模板,并确保公开内容不包含密钥、个人路径或隐私信息。

仓库结构

cep/com.dreamengine.panel/   After Effects CEP 面板
hub/                         Electron 管理程序
tools/                       Hub 与面板调用的 PowerShell、ExtendScript 和模板
dist/L1/                     内置效果预览资源
assets/screenshots/          README 截图

提交 tools/ 前请检查脚本中不包含密钥、个人路径或隐私数据。

许可证

本项目采用 MIT License。允许使用、复制、修改、合并、发布、分发、再许可和销售,但需保留版权与许可声明。

当前限制

  • 安装包尚未代码签名。
  • 主要在 AE 2021 / CEP 11 上完成验收。
  • 第三方插件预览依赖本机插件和授权环境。
  • 素材库目前只支持一个根目录;磁盘变化后需要手动刷新。
  • .aep 不解析内部合成,也不会自动打开。
  • Hub 与 AE 面板不会在另一端操作后自动轮询刷新分类列表;切回对应页面时会重新读取。

About

A Windows workspace for After Effects: effect previews, presets, curve easing, and media library in one panel.

Topics

Resources

Stars

8 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages