Skip to content

README.en.md

Latest commit

 

History

History
183 lines (139 loc) · 7.46 KB

README.en.md

File metadata and controls

183 lines (139 loc) · 7.46 KB
Raw

Codex Dream Skin

中文 · English

Give Codex a face that breathes.
External themes for the Codex desktop app · Local CDP inject · No official package mutation

One image, one mood · Code with atmosphere

Unofficial. Does not modify .app / app.asar / WindowsApps.

Sponsors

Passion8

Smarter Connections · Passionate Creation
Connect AI · Power Creation

Thanks to passion8.cc for sponsoring this project.
Full-power AI gateway: official models, no silent downgrades, no wrapper shells.
One-line setup for Codex / Claude Code / Grok.

Theme install and API config stay separate — this project never rewrites your provider settings.

Tested featured preset: Arina Hashimoto

“Arina Hashimoto / 桥本有菜” has been 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.

Arina Hashimoto theme tested in light appearance
Light · real injected screenshot; unsent input hidden during capture (preview only)

Arina Hashimoto theme tested in dark appearance
Dark · real injected screenshot; unsent input hidden during capture (preview only)

Install from the repo and switch in one command on macOS:

cd macos
./scripts/install-dream-skin-macos.sh --no-launch
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-romantic-rose

Windows has a persistent local theme store and system-tray controls, and seeds the same Arina Hashimoto preset. For the first repo-based setup:

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1

After launch, switch directly through 已保存主题 → 桥本有菜; no cross-folder manual import is required. 更换背景图 still imports your own UI-free wallpaper, which can then be saved for one-click switching.

The downloadable user source is docs/images/presets/romantic-rose-source.png (1672 × 941); the macOS one-click 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; confirm likeness and asset rights before redistributing it.

Concept gallery (not importable backgrounds)

These eight images communicate achievable visual directions, but they are interface mockups rather than usable theme backgrounds. Generate a UI-free 2560 × 1440 image with the copy-ready reference prompt guide before importing a similar look. See the concept prompt breakdown for the eight individual styles.

Pink Custom
Pink Custom

God of Wealth
God of Wealth

Red-White Sci-Fi
Red-White Sci-Fi

Clear Custom
Clear Custom

Inspiration
Inspiration

Purple Night
Purple Night

Cyan Virtual Singer
Cyan Virtual Singer

Stage Black-Gold
Stage Black-Gold

What it does

  • 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.
  • Portable themes — Inspect, back up, and import one .dreamskin file on macOS or Windows.
  • Restorable — One-click restore to the stock look.
  • Safer path — Local-loopback CDP inject only. No official binary or signature changes.

Quick start

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

Platform Dir Entry
Apple Silicon / Intel Mac macos/ Double-click Install Codex Dream Skin.command
Windows windows/ scripts/install-dream-skin.ps1 → start-dream-skin.ps1

More detail:

Feedback & contributions

  • Issues: Use the issue templates (bug / feature). Blank issues are disabled. Please try Verify / Restore self-checks before filing bugs.
  • 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 — avoid untrusted local processes while the theme runs.
  • Does not touch the official install directory or code signature.
  • Never rewrites API Key / Base URL; relay and theme stay separate.

License

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