Codex Dream Skin
Give the Codex desktop app a face that breathes
One image, one mood. Swap the wallpaper, keep every native control — sidebar, cards, project picker and composer stay real.
English | 中文 | Changelog
Install · Theme library · Features · Import · Developers · Safety
🌐 Official website & theme library: dreamskin.cc
Gallery · Online Studio
Unofficial. Does not modify .app / app.asar / WindowsApps.
❤️ Sponsor
Theme install and API config stay separate — this project never rewrites your provider settings.
Install
Install the official Codex / ChatGPT app once and quit it, then download the package for your platform from GitHub Releases:
No source checkout, Node.js install, .sh or .ps1 command is required. After installation, use the macOS menu bar or the Windows system tray. Updates are manual: install the new package over the existing one and your themes and images are preserved. Because the public packages are unsigned, a new download may show a one-time OS security warning — the guides cover the safe GUI approval path, updates and uninstall steps.
Theme library & community
- Gallery — browse reviewed community themes with recent/popular sorting and creator rankings. Try any theme on in the in-page desktop simulator before you install it.
- Online Studio — swap the background, tune theme colors, and write Safe CSS in the browser, then export a
.zip pack or submit it to the library (sign-in required; published after human review).
The macOS menu bar and Windows tray both link straight to Gallery and Online Studio. For background transparency and deleting local themes, see theme management.
Found a theme you like on DreamSkin.cc? Apply hands it to the local client directly. Requires client v1.5.0 or newer (v1.5.5+ recommended).
Flow and safety boundary:
- The page invokes the local app through
dreamskin://apply?version=ver_.... The link can carry exactly one theme version ID — never an arbitrary URL, file path, or command — and there is no silent-apply parameter.
- The app fetches the package only from the fixed official API, and refuses redirects.
- A native confirmation appears first, and the app checks the version's review status, apply-compatibility flag, version, package size, actually downloaded byte count, and SHA-256.
- It then reuses exactly the same ZIP, manifest, image, and Safe CSS validation as a manual import.
- Success requires the real renderer to report the new theme as rendered. On a launch or render failure the app tries to restore the previous theme, and the restore is itself visibility-verified; if it cannot confirm either state it reports the status as unconfirmed rather than claiming a rollback.
Only themes that fully satisfy the current pack contract (background image + theme.json + non-empty theme.css + declared safe-css capability) show the one-click button. Anything else goes through the manual import below.
What it does
| Feature | |
|---|
| Real UI | Sidebar, cards, project picker and input stay native. Not a fake full-window screenshot. |
| Continuous wallpaper | One 16:9 image spans the full window; adaptive focus, safe-area and route treatment keep native content readable. |
| Swappable art | Drop in a UI-free image you like and it becomes your theme. |
| Saved themes | Switch local themes from the macOS menu bar or Windows system tray. |
| One-click apply | Hit apply on DreamSkin.cc; the client verifies origin and checksum, then installs it. |
| Theme ZIP import | Pick an ordinary .zip on either platform and add a validated pack to the local library. |
| Restorable | One-click restore to the stock look. |
| Safer path | Local-loopback CDP inject only. No official binary or signature changes. |
Tested featured presets
Gothic Void Crusade / 哥特虚空远征
Special thanks to @seansong-ideogram for designing and contributing this striking, atmospheric original gothic science-fiction work to the community. It leads the tested featured presets and is the default theme for fresh macOS installs.
After installing on macOS, switch directly from Saved Themes in the menu bar.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
