Skip to content

Codex Dream Skin

Unofficial skin tool that swaps the Codex desktop app's background image while keeping its native controls.

Stars
15.3k
Forks
1.4k
Licence
MIT
Language
JavaScript
Last update
22 days ago
Type
App

What it is

Codex Dream Skin is an unofficial tool that changes the wallpaper-style background of the Codex desktop app using an image you choose or a community theme. According to the README, the native sidebar, cards, project picker and input stay in place, and it does not modify the app's .app, app.asar or WindowsApps files. It is aimed at people who want to personalize how their Codex desktop app looks.

  • Install a featured or community theme from the DreamSkin.cc gallery with the one-click Apply button
  • Import a theme .zip file from the local menu bar or system tray
  • Swap in your own UI-free 16:9 image as a custom wallpaper
  • Restore the stock Codex look with one click

Great for

  • Codex desktop app users on macOS or Windows who want a custom look
  • People who want to browse or import community themes from the DreamSkin.cc library
  • Designers or artists who want to make a background image and share it as a theme

Not ideal for

  • Users who need a supported or officially endorsed customization path, since the README says the project is unofficial
  • Anyone who does not use the Codex desktop app, since it only skins that app
  • People who want to configure API providers through this tool, since the README says theme install and API config stay separate and the project does not rewrite provider settings
Step-by-step guide: how to use Codex Dream SkinInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Download the app

    You'll need: Official Codex / ChatGPT desktop app installed and run once

    Clone the repository

    git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
  2. 2

    Run it

    • Install the official Codex / ChatGPT app once and quit it.
    • Download the .dmg (macOS) or .exe (Windows) from GitHub Releases.
    • Install the package and follow the first-run guide for your platform.
    • Use the macOS menu bar or Windows system tray to pick a saved theme or open the Gallery.
  3. 3

    Get the most out of it

    • Use the Gallery's in-page desktop simulator to preview a theme before installing it
    • Use the Online Studio to adjust a background, theme colors and Safe CSS, then export a .zip pack
    • Read the theme management guide to make the background transparent or delete local themes
    • Verify the SHA256SUMS.txt checksum for the downloaded package when available

Downloads

Strengths

  • Keeps native app controls visible rather than replacing the window with a screenshot, per the README
  • Installation is a downloadable package with no command line required, according to the README
  • Themes can be previewed in an in-page simulator and updated by installing a new package over the old one

Trade-offs

  • The packages are unsigned, so the OS may show a one-time security warning on download
  • The README describes it as unofficial and depends on the Codex app's current structure, so changes to that app could affect it
  • Community themes are reviewed by humans before publishing, but quality and content vary

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.