fei-away/codex-dream-skin

❤️ 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

DreamSkin.cc · the official theme library and authoring platform Make your workspace yours.

Browse the Gallery →  ·  Online Studio →

• 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).

  Online Studio · swap in a background you like, dial in the focal point and palette — now it’s your theme

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.

What it does

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.

Real injected Codex home screen (preview only)

After installing on macOS, switch directly from Saved Themes in the menu bar.

Arina Hashimoto / 桥本有菜

Verified on the real Codex home screen in both light and dark appearances. The user-provided source PNG is 1672 × 941; the preset’s 2560 × 1440 JPEG is a standardized derived export that preserves the source’s near-16:9 composition and does not add source detail. The sidebar, cards, project picker and composer shown below are native Codex controls.

Light · real injected screenshot; unsent input hidden during capture (preview only)

Dark · real injected screenshot; unsent input hidden during capture (preview only)

This portrait material remains in the source repository for reference and rights review; it is excluded from public DMG and Setup.exe assets. Public installers seed only the redistributable Gothic Void Crusade preset. Users can still choose Change Background to import UI-free artwork they are entitled to use and save it for one-click switching.

The downloadable user source is docs/images/presets/arina-hashimoto-source.png (1672 × 941); the source-only reference preset uses the normalized derived background.jpg (2560 × 1440). Do not import either screenshot above — they contain real UI and are previews only. The background is a user-provided AI-generated example, not an official OpenAI/Codex visual or endorsement; do not put it in a public installer without confirmed likeness and asset rights.

Import a theme ZIP

For themes from DreamSkin.cc, prefer one-click apply. The manual path below is the fallback, and covers packs from any other source.

For developers

Platform scripts are ready — different plumbing, same goal: theme Codex.

• Mac: macos/README.md · Windows: windows/README.md · Windows EN
• Paths and capability matrix: docs/platforms.md
• Copy-ready background prompt guide: docs/reference-background-prompt-guide.en.md · eight concept breakdowns: docs/background-generation-prompts.md
• Project notes: docs/PROJECT.md

Feedback & contributions

• Issues — use the issue templates (bug / feature); blank issues are disabled. Please run the Verify / Restore self-checks before filing a bug.
• PRs — follow the PR template, describe the change, and tick the self-checks you actually ran (e.g. macos/tests/run-tests.sh, verify / restore).

Safety

• CDP binds 127.0.0.1 only, but it has no authentication; another process on the same computer may still connect and inspect or control the renderer.
• Pausing the theme or stopping only the injector does not close the debug port of an already running Codex process. Use a full Restore/restart, or quit every Codex process and reopen the official app normally, to end the exposure window.
• Does not touch the official install directory or code signature.
• Never rewrites API Key / Base URL; relay and theme stay separate.
• See SECURITY.md for the complete threat model and operating guidance.

License

• macos/LICENSE (MIT) and macos/NOTICE.md
• Unofficial; Codex and related rights belong to their owners.
• People / IP material in bundled presets and previews is illustrative only — clear likeness, asset and trademark rights before commercial redistribution.

---

Star it, pick a look, and make Codex yours for today.