Free · Local · Unofficial

Turn any image into a Codex theme.

Upload a wallpaper, adjust colors and readability, preview it live, and export your theme without uploading your image.

  • Runs locally
  • No sign-up
  • Easy to restore
  • Honest compatibility
live preview
Local workspace

What are you working on?

Create, inspect, then export.

The tool is the first section because the job is concrete: choose an image, keep the interface readable, and leave with portable files.

theme://midnight-orbitprogrammatic wallpaper
Live preview
Local workspace

What are you working on?

ExportFree · Local
Share links and recipes contain settings only. The ZIP contains wallpaper, recipe, CSS tokens, README, and checksums—never an installer.
Install safelyUpstream only

Six stages. One visible boundary.

Your image stays in browser memory. Exported files are created by your device; installation remains a separate upstream workflow.

  1. 01

    Create

    Drop in PNG, JPEG or WebP. Validate, crop, and extract three local palettes.

  2. 02

    Preview

    Inspect Home, Task, Diff, Terminal, and Settings with independent surface controls.

  3. 03

    Export

    Leave with wallpaper, recipe, tokens, or a data-only ZIP plus SHA-256 checksums.

  4. 04

    Install

    Choose the real macOS or Windows upstream path without invented platform parity.

  5. 05

    Verify

    Record platform, version, commit, native interactions, and the first failing route.

  6. 06

    Restore

    Return to stock Codex through the documented process before improvising.

Twenty-four original starting points.

Every background is programmatic and avoids third-party characters, logos and branded artwork.

Create → Install → Restore

The site exports inputs and instructions. It does not disguise an installer or claim that preview equals compatibility.

Create locally

No image upload API, no login and no database.

Install transparently

Commands point to the original upstream project and ask for review before execution.

Restore deliberately

Separate prompts keep rollback visible instead of treating it as an afterthought.

Know the boundary before you install.

External themes use a powerful local debugging connection. Keep only trusted software running and restore when you are done.

Questions before the first export.

Compatibility can change when Codex or the external theme project updates. These answers describe the upstream state checked on July 17, 2026.

What is a Codex theme?

A Codex theme is an external visual layer for the Codex Desktop app. The upstream project keeps native controls interactive and applies its styling through a local browser-debugging connection.

Does this modify the official Codex app?

The files exported here do not modify the official app. The referenced upstream workflow states that it does not patch Codex.app, app.asar, WindowsApps or the official code signature.

Is my wallpaper uploaded?

No. The builder uses your browser’s Object URL and Canvas APIs. There is no image-upload endpoint, and the site does not store your wallpaper.

Does it work on macOS?

The current upstream macOS studio documents arbitrary image selection plus accent, secondary and highlight color arguments. Always re-check the latest upstream instructions before installation.

Does it work on Windows?

The upstream Windows flow supports install, launch, verification and restore. Its current public guide does not document a macOS-equivalent arbitrary-image customization command, so this site does not claim feature parity.

Can I restore the default Codex appearance?

Yes. Both platform workflows document restore scripts. The builder also produces a conservative restore prompt that asks your local Codex to show commands before running them.

Is Codex Theme affiliated with OpenAI?

No. Codex Theme is an unofficial community tool and is not affiliated with, endorsed by or sponsored by OpenAI.

Why does a theme sometimes break after an update?

The external theme layer depends on renderer structure that can change when Codex updates. Re-check compatibility, rerun the current upstream installer and keep the restore path ready.

What image size works best?

Use a wide image at least 2000 pixels across, with a calm left side for interface text. The builder exports WebP or PNG at 1920 × 1080 or 2560 × 1440.

Is the builder free?

Yes. Upload, five preview modes, local palette extraction, readability checking, wallpaper, recipe, tokens and data-only ZIP export are free and require no account.