Skip to content

RegionallyFamous/odd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

258 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ODD — the Luxe + Weird shop for WP Desktop Mode

ODD — Outlandish Desktop Decorator

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

Latest release CI License


WP Desktop Mode makes WordPress feel like a desktop. ODD gives that desktop a polished, updateable shop for visual themes and small tools.

The live demo is pinned to the v1.0.0 release blueprint. No install, no signup, nothing to uninstall. Playground boots ODD + WP Desktop Mode in about 20–30 seconds.


What You Get

Surface What It Adds
Wallpapers Generative PixiJS scenes over painted backdrops, with live preview and shuffle.
Icon Sets Full dock and desktop shortcut re-skins, including first-party recycle bin coverage.
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.

Why It Feels Different

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.


Install

One-click demo

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.

A real WordPress install

  1. Install and activate WP Desktop Mode v0.6.0 or newer.
  2. Download the latest odd.zip from the Releases page.
  3. WP Admin → Plugins → Add New → Upload Plugin → pick the zip → Activate.
  4. Double-click the ODD desktop icon, use the taskbar icon, or run /odd-panel from the command palette to open the Shop.

Requires: WordPress 6.0+ · PHP 7.4+ · WP Desktop Mode v0.6.0+


Build Your Own

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.

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 SVG pack for Desktop Mode chrome.
Building a Cursor Set Add custom pointer roles and cursor assets.
Building a Widget Register a small draggable desktop widget.
.wp Manifest Reference Validate bundle metadata and file contracts.

Project Map

  • odd/ — the plugin itself (what ships in odd.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 into site/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 by install-smoke.yml to test the starter-pack installer hermetically.
  • bin/ → see odd/bin/validate-catalog, validate-blueprint, check-version, build-zip, make-pot.

Useful Links

License

GPLv2 or later, matching WP Desktop Mode. See LICENSE.

About

Turn your WordPress admin into a moving, themed, thoroughly-yours desktop — and an app platform you can build for.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors