Make one with ChatGPT, Claude or another AI

Copy a prompt below, replace the DESCRIPTION line with your idea, and paste it into the chat. The AI returns the files; save them into the folders shown, run python3 pack.py <folder> and import with + in the Installed tab.

Tip: if the AI can read links, also give it https://engine.oprimo.dev/docs/llms-full.txt, which has the whole spec in one file.

Prompt: Metal shader (free, lightest on battery)

You are creating an animated wallpaper for PrimoEngine (macOS), type "metal".
DESCRIPTION: <describe it, e.g. "a soft aurora in greens and purples over a starry sky">

Return EXACTLY two code blocks, nothing else:
1) manifest.json  (saved as <folder>/manifest.json)
2) shader.metal   (saved as <folder>/content/shader.metal)

manifest.json rules:
- {"schemaVersion": 1, "id": "com.user.<slug>", "version": "1.0.0", "title": "<short title>",
   "type": "metal", "entry": "content/shader.metal", "minMacOS": "26.0",
   "config": [
     {"key":"speed","type":"float","min":0.1,"max":3.0,"default":1.0,"label":"Speed"},
     {"key":"tint","type":"color","default":"#FFFFFF","label":"Tint"}],
   "capabilities": {"network": []}}
- Do not include "checksum" (pack.py computes it). Add no other config entries (the shader only receives speed and tint).

shader.metal rules (Metal Shading Language, compiled at runtime on macOS 26):
- Start with: #include <metal_stdlib> and using namespace metal;
- Declare exactly:
  struct Uniforms { float2 resolution; float time; float speed; float4 tint; };
  struct VOut { float4 position [[position]]; };
  vertex VOut v_main(uint vid [[vertex_id]]) {
      float2 p = float2((vid << 1) & 2, vid & 2);
      VOut o; o.position = float4(p * 2.0 - 1.0, 0.0, 1.0); return o; }
- Fragment: fragment float4 f_main(float4 fragCoord [[position]], constant Uniforms& u [[buffer(0)]])
- fragCoord.xy is in pixels, origin top-left (y grows downward).
  uv = fragCoord.xy / u.resolution. Animate with u.time * u.speed. Multiply the final color by u.tint.rgb.
  Return alpha 1.0.
- FORBIDDEN anywhere in the code (including inside names): "kernel ", "[[kernel", "device ",
  "threadgroup ", "atomic_", "#include \"". No textures, no samplers, no buffers other than Uniforms,
  no iMouse.
- This is MSL, not GLSL: use float2/float3/float4, fmod instead of mod, fract, mix, smoothstep;
  float literals with a decimal point (1.0); helper functions defined before f_main; no recursion.
- It must look good full-screen, animate smoothly and continuously, and be cheap on the GPU
  (at most ~64 loop iterations per pixel).

Prompt: web / Canvas / WebGL (free)

You are creating an animated wallpaper for PrimoEngine (macOS), type "web".
DESCRIPTION: <describe it>

Return EXACTLY two code blocks:
1) manifest.json  (saved as <folder>/manifest.json)
2) index.html     (saved as <folder>/content/web/index.html), a single file, CSS and JS inline.

manifest.json:
- {"schemaVersion": 1, "id": "com.user.<slug>", "version": "1.0.0", "title": "<title>",
   "type": "web", "entry": "content/web/index.html", "minMacOS": "26.0",
   "config": [ ...2 to 5 useful settings... ], "capabilities": {"network": []}}
- Allowed setting types: "float" and "int" (with min, max, default), "bool" (default true/false),
  "color" (default "#RRGGBB"). Each has "key" and "label". No "enum". No "checksum".

index.html:
- Runs in a full-screen WKWebView (Safari/WebKit) behind the desktop icons. NO INTERNET:
  no CDNs, fetch, external fonts or remote images. No mouse/keyboard. No localStorage.
- Read settings like this, with defaults matching the manifest:
    const cfg = { /* defaults */ };
    window.LiveWallpaper = window.LiveWallpaper || {};
    function readConfig(c) { Object.assign(cfg, c || {}); /* re-apply */ }
    window.LiveWallpaper.onConfig = readConfig;
    readConfig(window.LiveWallpaper.config);
  "int" settings arrive as decimals: use Math.round. "color" arrives as "#RRGGBB".
- Animate with requestAnimationFrame; handle resize and devicePixelRatio; html/body with no margin,
  overflow hidden, dark background.
- Plain Canvas 2D or WebGL (no external libraries). Light on battery.

Prompt: HLSL shader (Windows)

For PrimoEngine on Windows. To port a Mac wallpaper, paste its manifest.json and shader.metal under the prompt and ask for the twin: same id and config.

You are creating an animated wallpaper for PrimoEngine for Windows, type "hlsl".
DESCRIPTION: <describe it, or paste the Metal wallpaper to port>

Return EXACTLY two code blocks, nothing else:
1) manifest.json  (saved as <folder>/manifest.json)
2) shader.hlsl    (saved as <folder>/content/shader.hlsl)

manifest.json rules:
- {"schemaVersion": 1, "id": "com.user.<slug>", "version": "1.0.0", "title": "<short title>",
   "type": "hlsl", "entry": "content/shader.hlsl",
   "config": [
     {"key":"speed","type":"float","min":0.1,"max":3.0,"default":1.0,"label":"Speed"},
     {"key":"tint","type":"color","default":"#FFFFFF","label":"Tint"}],
   "capabilities": {"network": []}}
- Do not include "checksum" (pack.py computes it). Add no other config entries.
- Porting a Mac wallpaper: keep its exact "id" and "config"; only "type" and "entry" change.

shader.hlsl rules (HLSL pixel shader, compiled by FXC as ps_5_0, Direct3D 11):
- Declare exactly:
  struct Uniforms { float2 resolution; float time; float speed; float4 tint; };
  cbuffer PrimoUniforms : register(b0) { Uniforms u; };
- Entry: float4 f_main(float4 fragCoord : SV_Position) : SV_Target
- No vertex shader and no #include.
- fragCoord.xy is in pixels, origin top-left (y grows downward).
  uv = fragCoord.xy / u.resolution. Animate with u.time * u.speed. Multiply the final color by u.tint.rgb.
  Return alpha 1.0.
- FORBIDDEN: writable resources (RWTexture2D, RWBuffer, RWStructuredBuffer), StructuredBuffer,
  atomics (Interlocked*), textures, samplers, any register other than b0, iMouse.
- This is HLSL, not GLSL or MSL: float2/float3/float4, frac, lerp, fmod, smoothstep, mul(v, m) for
  matrix products; float literals with a decimal point (1.0); helper functions defined before
  f_main; no recursion.
- It must look good full-screen, animate smoothly and continuously, and be cheap on the GPU
  (at most ~64 loop iterations per pixel).

If something fails

Paste the error from the app (or from pack.py) back into the chat together with the error table and ask for a fix.