The Luxe + Weird desktop shop for WP Desktop Mode.
Living wallpapers, icon costumes, pointer themes, draggable widgets, and tiny apps for the WordPress admin desktop.
Launch the live demo · Download ODD · Marketing site · Docs
WP Desktop Mode makes WordPress feel like a desktop. ODD gives that desktop a polished, updateable shop for visual themes and small tools. ODD works with Desktop Mode's native surfaces instead of replacing the desktop shell.
The hosted Playground blueprint installs the newest approved WP Desktop Mode and ODD releases from the WordPress.org Plugin Directory (resource: "wordpress.org/plugins"). Raw GitHub copy: blueprint.json (add ?oddbp=wporg-latest if Playground still loads a cached older file). Production installs: use WordPress.org or odd.zip on Releases. Bleeding edge: use /go/dev or site/playground/blueprint-dev.json (ODD main + pinned Desktop Mode 0.8.5; not tied to ODD releases).
| Surface | What It Adds |
|---|---|
| Wallpapers | Generative PixiJS scenes over painted backdrops, with live preview and shuffle. |
| Icon Sets | Native Desktop Mode raster image URL feeds for the dock, taskbar, desktop shortcuts, and recycle bin. |
| Cursor Sets | Pointer themes that reach Desktop Mode windows, chrome, widgets, and same-origin app frames. |
| Widgets | Small desktop tiles like notes, prompts, and embeds, installed from catalog bundles. |
| Apps | Sandboxed HTML/CSS/JS tools that open in native Desktop Mode windows with optional launchers. |
| ODD Shop | Remote Catalog | Safe Installation |
|---|---|---|
| Mac App Store-style browsing with editorial shelves, department glyphs, global search, preview bars, and responsive chrome. | New wallpapers, card art, widgets, apps, icon sets, and cursor sets publish without forcing every site to update the plugin. | .wp bundles are validated, catalog downloads are SHA256-checked, and app files are served behind authenticated paths. |
Wallpapers, icon sets, and cursor sets preview instantly. Try a scene, theme, or cursor set, then keep it or roll back from the preview bar. Catalog cards update in place after install, so the thing you install is the thing you use.
Launch ODD in WordPress Playground ->
First load takes ~20–30 seconds while Playground boots the site and installs the plugin. Throwaway — close the tab and it's gone.
Short links (GitHub Pages — same host as the hosted blueprint): /go/ redirects to the WordPress.org-latest demo; /go/dev opens a dev blueprint (pinned Desktop Mode 0.8.5 zip + ODD main). Full launcher pages: /playground/ and /playground/dev/.
- Install and activate WP Desktop Mode v0.8.0 or newer. ODD declares Desktop Mode as a required plugin dependency, so WordPress can surface that relationship during install.
- Install ODD from WordPress.org or download the latest
odd.zipfrom the Releases page. - WP Admin → Plugins → Add New → Upload Plugin → pick the zip → Activate.
- Double-click the ODD desktop icon, use the taskbar icon, or run
/odd-panelfrom the command palette to open the Shop.
Requires: WordPress 6.0+ · PHP 7.4+ · WP Desktop Mode v0.8.0+
Anyone can ship a scene, icon set, cursor set, widget, or app as a single .wp file. ODD validates the archive, checks catalog downloads against SHA256, and keeps app files behind authenticated serve paths. First-party content lives under _tools/catalog-sources/ and publishes to the remote catalog through GitHub Pages; plugin releases are only for runtime/API changes.
Users can also export a lightweight .odd workspace from the Shop's Install tab. A .odd file is a JSON preset for wallpaper, icons, cursors, widgets, apps, and preferences; it never contains executable bundle code.
| Guide | Use It For |
|---|---|
| Building an App | Package a sandboxed mini-app with optional desktop/taskbar launchers. |
| Building a Scene | Create a PixiJS wallpaper scene with preview and wallpaper art. |
| Building an Icon Set | Ship a themed PNG/WebP icon feed for Desktop Mode chrome. |
| Building a Cursor Set | Add custom pointer roles and cursor assets. |
| Building a Widget | Register a small draggable desktop widget. |
Shareable .odd Workspaces |
Export/import a whole desktop mood as a safe preset. |
.wp Manifest Reference |
Validate bundle metadata and file contracts. |
odd/— the plugin itself (what ships inodd.zip). The 1.0 runtime is intentionally lightweight; catalog content installs on demand._tools/catalog-sources/— source of truth for every bundle (scene / icon set / cursor set / widget / app). Rebuilt intosite/catalog/v1/by_tools/build-catalog.py.site/— the odd.regionallyfamous.com marketing site and the remote catalog (site/catalog/v1/registry.json+bundles/+icons/), deployed to GitHub Pages.docs/— authoring guides and reference docs.ci/smoke/— MU-plugin fixtures used byinstall-smoke.ymlto test the starter-pack installer hermetically.bin/→ seeodd/bin/—validate-catalog,validate-blueprint,check-version,build-zip,make-pot.
- Playground: Stable — short link
/go/(latest ODD + Desktop Mode from WordPress.org) · Trunk —/go/dev· Launcher hub/playground/· Trunk launcher/playground/dev/ - ODD Shop State Machine
- Release Runbook
- Building on ODD
- Project wiki
GPLv2 or later, matching WP Desktop Mode. See LICENSE.