给 Codex 桌面端换上主题、静态壁纸和动态壁纸。
保留原生侧栏、任务、项目选择器与输入框，不修改官方安装包。
中文 · English
下载 Windows EXE · macOS 安装 · 查看效果展厅 · 加入讨论 · 反馈问题
非 OpenAI 官方产品。Codex 动态壁纸通过仅绑定
127.0.0.1的本机 CDP 注入主题，不修改 WindowsApps、.app、app.asar或官方代码签名。
- 原生 UI 保持可用：不是把一张假界面贴满窗口；侧栏、聊天、任务和输入框仍可正常交互。
- Codex 内部动态壁纸：Windows 支持本地 MP4/WebM 静音循环，不是修改桌面壁纸。
- 一键式 Windows 管理器：浏览、搜索、预览和切换壁纸，调整透出度，暂停或恢复官方外观。
- 图片变主题：导入喜欢的 PNG、JPEG 或 WebP，自动适配全窗背景与内容可读性。
- 可恢复、可审计：不改官方二进制；随时停止注入并恢复 Codex 官方外观。
- Windows + macOS：Windows 提供自包含 EXE，macOS 提供菜单栏 Studio 与安装脚本。
- 下载
CodexDreamSkinManager.exe。 - 双击运行，点击「添加壁纸」导入 PNG、JPEG、WebP、MP4 或 WebM。
- 点击「应用到 Codex」。需要时点击「启动 / 重新应用」。
管理器是自包含的单文件程序，内置经过测试的动态壁纸引擎与 Node.js 运行时；最终用户不需要安装 .NET SDK、Node.js 或手动执行 PowerShell。
当前发布版尚未进行代码签名，Windows 可能显示“未知发布者”。请只从本仓库的 Releases 下载，并使用同页
.sha256文件核对。
右侧滑杆控制主题蒙层与壁纸的关系：
100%：显示原始壁纸/视频画面，整页主题蒙层降为零。- 较低数值：提高文字区与主题蒙层可见度，适合任务页或高对比背景。
在仓库的 macos/ 目录双击：
Install Codex Dream Skin.command
也可在终端执行：
cd macos
./scripts/install-dream-skin-macos.sh安装后通过菜单栏 Studio 导入、保存和切换图片主题。完整说明见 macos/README.md。
| 功能 | Windows | macOS |
|---|---|---|
| PNG / JPEG / WebP 图片主题 | ✅ | ✅ |
| MP4 / WebM 动态壁纸 | ✅ | — |
| 图形化主题管理 | ✅ 独立 EXE | ✅ 菜单栏 Studio |
| 壁纸库搜索与预览 | ✅ | ✅ |
| 保存与切换主题 | ✅ | ✅ |
| 壁纸透出度 | ✅ | — |
| 暂停注入 / 恢复官方外观 | ✅ | ✅ |
| 修改官方应用文件 | 不会 | 不会 |
| Windows / 通用主题 | macOS 暗色主题 |
|---|---|
 |
 |
更多实机截图、人物预设与八种概念方向见 docs/showcase.md。
本地壁纸 / 主题配置
↓
Codex 动态壁纸本地主题仓库
↓
127.0.0.1 回环 CDP
↓
Codex renderer 中的独立背景层
↓
原生侧栏、任务与输入框继续交互
Windows 视频会分块传入 renderer 并组装为 Blob URL；切换、暂停或清理时会释放播放器与 Blob。页面隐藏后自动暂停视频，避免无意义播放。
- CDP 只绑定
127.0.0.1，不会对局域网开放调试端口。 - 不修改 WindowsApps、
.app、app.asar或官方签名。 - 不读取或改写 API Key、Base URL、模型供应商或 Codex 聊天内容。
- 主题运行期间不要运行来路不明的本机程序；本机恶意进程可能尝试访问调试端口。
- Codex 官方更新可能改变 DOM。若主题失效，请先使用管理器「启动 / 重新应用」，再查看 Issues。
powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1需要 .NET 8 SDK 和 Node.js 22+：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows\app\build-manager.ps1输出位于 windows/dist/。构建会运行 Windows 回归测试、发布自包含 win-x64 EXE，并执行发布后自检。
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows\tests\run-tests.ps1bash macos/tests/run-tests.sh这是 Wallpaper Engine 的替代品吗？
不是。它只控制 Codex 应用内部的主题背景。Windows 管理器可以导入普通 MP4/WebM，但不渲染 Wallpaper Engine 的 Scene、Web 或打包项目。
为什么 Codex 更新后主题可能失效？
动态壁纸引擎依赖 Codex 的 renderer DOM 和本机 CDP。官方更新可能调整结构；通常点击「启动 / 重新应用」即可恢复，兼容性修复会持续发布在本仓库。
能否恢复完全原生的 Codex？
可以。Windows 管理器提供「恢复官方外观」，macOS Studio 也提供卸载/恢复入口。项目不会修改官方应用包。
壁纸文件会上传吗？
不会。壁纸与主题保存在本机，注入只通过本机回环连接完成。
感谢 passion8.cc 赞助本项目。换肤与 API 配置互相独立，本项目不会自动改写模型供应商设置。
- 公告、主题分享与使用交流：GitHub Discussions。
- 首个版本公告：Codex 动态壁纸 v1.0.0 正式发布。
- 使用 Bug / 功能 Issue 模板 提交问题。
- PR 请说明平台、复现或目标、验证命令与恢复测试。
- 贡献指南：中文 · English
本仓库是 Fei-Away/Codex-Dream-Skin 的增强派生版本，并保留完整上游历史。
MIT License。非 OpenAI 官方产品；Codex 及相关商标归其权利人。随仓库预设与效果图中的人物/IP 素材仅作主题示意，公开再分发前请自行确认肖像、素材和商标权利。
如果 Codex 动态壁纸让你的工作空间更舒适，欢迎点一个 Star，也欢迎分享你的主题截图。