All guides
Codex Dream Skin guide

Add a Dream Skin theme on macOS

This guide only adds a theme. It assumes Dream Skin is already installed and working on the Mac.

01

Confirm Dream Skin is installed

If Dream Skin is missing, complete the macOS installation guide first. Installing the tool and adding a theme are separate procedures.

02

Unzip the downloaded theme

In Downloads, double-click codex-skin-lab-<theme-name>.zip. Keep theme.json and the background image together in the extracted folder.

03

Open the theme library

Open Terminal and run the command below. Finder opens the themes folder created by Dream Skin.

open "$HOME/Library/Application Support/CodexDreamSkinStudio/themes"
04

Move the complete theme folder

Drag the extracted codex-skin-lab-<theme-name> folder into themes. The final path should end in themes/codex-skin-lab-<theme-name>/theme.json.

05

Switch and verify

Replace <theme-id> with the folder name, such as codex-skin-lab-sweet-moon. After switching, check Home, an ordinary task, and the composer.

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh --id <theme-id>

Official resources

Codex Dream Skin macOS filesCodex Skin Lab themes

Next, choose a theme

Preview each design and download the complete ZIP for Codex Dream Skin. No account needed.

View all themes
DOWNLOAD COMPLETE

Add this theme to Dream Skin

Follow the steps for your system. Install Dream Skin first, then move the complete theme folder into its theme library and select it.

Choose your system

  1. 1
    Unzip the download

    Open Downloads and double-click the ZIP. A folder with the same name will appear.

  2. 2
    Open the Dream Skin theme folder

    Press Command + Space, type Terminal, and open it. Copy the command below, paste it into Terminal, then press Return.

    open "$HOME/Library/Application Support/CodexDreamSkinStudio/themes"Dream Skin creates this folder when it is installed. This command only opens it and cannot create, move, replace, or delete files.

    Finder will open the themes folder that Dream Skin created during installation.

  3. 3
    Move the whole theme folder

    Drag the folder you just unzipped into the Finder window. Do not move theme.json or the background image separately.

    Move this folder/

  4. 4
    Switch to this theme

    Copy the command below into Terminal and press Return. It switches by the theme folder ID you just moved.

    ~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh --id If the command reports that the theme or Dream Skin is missing, open the macOS installation guide above.