Codex Skin Lab Desktop

简体中文

Codex Skin Lab Desktop is a desktop app for Codex Dream Skin. It gives Dream Skin a visual interface for browsing, installing, creating, editing, and applying Codex themes.

This is an independent community project. It is not affiliated with or endorsed by OpenAI, and it is not an official Dream Skin client.

Download the app

Download the latest macOS and Windows builds from GitHub Releases.

• macOS: download the Apple silicon DMG, open it, and move Codex Skin Lab to Applications. Public macOS builds are signed and notarized before release.
• Windows: download the x64 setup EXE or MSI. Windows builds are currently unsigned, so Windows may display an unknown publisher or SmartScreen warning.

The repository is private during development. Release downloads require access to the repository until it becomes public.

What it does

• Browse the remotely updated theme catalog without installing Dream Skin first.
• Install Dream Skin from the app when a theme action needs it.
• Install themes from the catalog or import a local theme package.
• Preview, edit, apply, remove, and restore themes from one interface.
• Create a theme from an image and adjust appearance, accent color, image focus, safe area, and task-page behavior.
• Check for app updates, download them inside the app, and install them without opening a browser.

Applying or restoring a theme may restart Codex. The app asks for confirmation before doing so.

Build from source

You need Node.js 22 or newer, Rust, and the Tauri 2 prerequisites for your operating system.

git clone https://github.com/zhoufeiii/codex-skin-lab.git
cd codex-skin-lab
npm install
npm run desktop:dev

Create a local production package with:

npm run desktop:build

Run the project checks with:

npm run check
npm run build
npm run test:rust

Building from source does not require the private website repository, Apple signing credentials, notarization credentials, or deployment access. An unsigned local build may trigger operating-system security warnings.

How it is structured

React desktop interface
        | typed Tauri IPC
Rust application core
        | SkinEngine adapter
Codex Dream Skin

The website supplies the public theme catalog and desktop market pages. Theme installation, file validation, backups, and Codex restart operations stay in the native Tauri client.

Safety and project status

Theme packages are validated before installation. Destructive actions require confirmation, and theme removal uses a recoverable backup. The client does not read Codex accounts, API keys, or conversations.

The project is still in preview. macOS currently targets Apple silicon. Windows packages are built for x64 and need more testing on physical Windows 11 machines.

License

Codex Skin Lab Desktop is licensed under Apache-2.0. Codex, Dream Skin, themes, artwork, names, and trademarks remain subject to their own licenses.