ps batchplay
- Repo stars 5
- License MIT
- Author repo 00bx-photoshop-mcp
- Domain
- Documentation
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 94 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @00bx · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# §4 BATCHPLAY REFERENCE
Use this section ONLY when no dedicated tool exists for your operation (Rule R7).
## 4.1 DESCRIPTOR FORMAT
```javascript
[
{
_obj: "commandName", // Event string code (required)
_target: [{ _ref: "layer", _id: 5 }], // Target (optional)
paramName: value, // Simple value
enumParam: { _enum: "enumType", _value: "enumValue" }, // Enum
unitParam: { _unit: "pixelsUnit", _value: 10.0 }, // Unit value
},
];
```
## 4.2 REFERENCE FORMS
```javascript
{_ref: "layer", _id: 42} // By ID (best)
{_ref: "layer", _enum: "ordinal", _value: "targetEnum"} // Active layer
{_ref: "document", _enum: "ordinal", _value: "targetEnum"} // Active document
{_ref: "channel", _enum: "channel", _value: "RGB"} // RGB composite
```
## 4.3 UNIT TYPES
```javascript
{_unit: "pixelsUnit", _value: 10} // Pixels
{_unit: "percentUnit", _value: 50} // Percentage
{_unit: "angleUnit", _value: 90} // Degrees
{_unit: "densityUnit", _value: 72} // PPI
```
## 4.4 OPERATIONS THAT STILL NEED BATCHPLAY
These operations have NO dedicated tool — use execute_batchplay:
**Lighting Effects:**
```json
[
{
"_obj": "lightingEffects",
"lightList": [
{
"_obj": "lightSource",
"lightType": { "_enum": "lightType", "_value": "spotLight" },
"intensity": 50,
"focus": 60,
"posX": 500,
"posY": 300
}
]
}
]
```
**VIVID_LIGHT blend mode** (not supported by set_layer_properties):
```json
[
{
"_obj": "set",
"_target": [
{ "_ref": "layer", "_enum": "ordinal", "_value": "targetEnum" }
],
"to": {
"_obj": "layer",
"mode": { "_enum": "blendMode", "_value": "vividLight" }
}
}
]
```
**Select layer by ID:**
```json
[
{
"_obj": "select",
"_target": [{ "_ref": "layer", "_id": 42 }],
"makeVisible": false
}
]
```
**Invert layer pixels (not selection):**
```json
[{ "_obj": "invert" }]
```
## 4.5 FILTER SCRIPTABILITY TABLE
| Filter | Headless (no dialog) | Notes |
| -------------------- | -------------------- | ------------------------------------------------- |
| All standard filters | Yes | gaussianBlur, wave, wind, etc. |
| Blur Gallery | May force dialog | Known Adobe bug |
| Camera Raw Filter | No | Always requires dialog. Use Curves/Levels instead |
| Liquify (full mesh) | No | Only `liquify_forward` works headless |
| Neural Filters | No | Cloud-based, requires dialog |
## 4.6 EVENT CODE TABLE
**Blur:** gaussianBlur, motionBlur, radialBlur, smartBlur, surfaceBlur, lensBlur, blurbTransform
**Distort:** wave, twirl, spherize, polar, ripple, oceanRipple, pinch, shear, zigZag, displace, glass
**Stylize:** wind, emboss, findEdges, diffuse, diffuseGlow, glowingEdges, tiles, extrude, solarize
**Sketch:** chrome, basRelief, chalkCharcoal, charcoal, photocopy, stamp, tornEdges, waterPaper, notePaper, plaster, reticulation, halftonePattern, graphicPen
**Artistic:** plasticWrap, dryBrush, filmGrain, fresco, neonGlow, paletteKnife, paintDaubs, roughPastels, smudgeStick, sponge, underpainting, watercolor, posterEdges, coloredPencil, cutout
**Noise:** addNoise, despeckle, dustAndScratches, median, reduceNoise
**Sharpen:** sharpen, unsharpMask, highPass, smartSharpen
**Render:** clouds, $DrfC (diff clouds), lensFlare, fibers/$Fbrs
**Texture:** craquelure, grain, mosaicPlugin, patchwork, stainedGlass, texturizer
**Pixelate:** colorHalftone, crystallize, facet, fragment, mezzotint, mosaic, pointillize
**Brush Strokes:** accentedEdges, angledStrokes, crosshatch, darkStrokes, inkOutlines, spatter, sprayedStrokes, sumi_e
**Operations:** make, set, get, delete, select, move, duplicate, hide, show, transform, crop, canvasSize, imageSize
**Adjustments:** curves, levels, hueSaturation, colorBalance, brightnessEvent, channelMixer, selectiveColor, posterization, thresholdClassEvent, invert, desaturate, gradientMapEvent
---
# §16 BATCHPLAY PRO TIPS
**Record your own descriptors:**
1. Open Photoshop Actions panel
2. Record the effect manually
3. Panel flyout → "Copy As JavaScript"
4. Gives exact descriptor for `execute_batchplay`
**Action listener (captures descriptors in real-time):**
```javascript
action.addNotificationListener(["all"], (event, descriptor) => {
console.log(event, descriptor);
});
```
---
Sections and files
Listed in source order.
sections -> 4.1 DESCRIPTOR FORMAT → 4.2 REFERENCE FORMS → 4.3 UNIT TYPES → 4.4 OPERATIONS THAT STILL NEED BATCHPLAY → 4.5 FILTER SCRIPTABILITY TABLE → 4.6 EVENT CODE TABLE
terms -> Lighting Effects · VIVIDLIGHT blend mode · Select layer by ID · Invert layer pixels (not selection) · Blur · Distort · Stylize · Sketch
files/cmd -> liquify_forward · execute_batchplay · Curves/Levels
body sha256 -> 6733e7386c49
4.4 OPERATIONS THAT STILL NEED BATCHPLAY
These operations have NO dedicated tool — use execute_batchplay: Lighting Effects: VIVID_LIGHT blend mode (not supported by set_layer_properties): Select layer by ID: Invert layer pixels (not selection):
4.5 FILTER SCRIPTABILITY TABLE
Filter · Headless (no dialog) · Notes All standard filters · Yes · gaussianBlur, wave, wind, etc. Blur Gallery · May force dialog · Known Adobe bug Camera Raw Filter · No · Always requires dialog. Use Curves/Levels instead Liquify (full mesh) · No · Only
liquify_forwardworks headless4.6 EVENT CODE TABLE
Blur: gaussianBlur, motionBlur, radialBlur, smartBlur, surfaceBlur, lensBlur, blurbTransform Distort: wave, twirl, spherize, polar, ripple, oceanRipple, pinch, shear, zigZag, displace, glass Stylize: wind, emboss, findEdges, diffuse, diffuseGlow, glowingEdges, tiles, extrude, solarize Sketch: chrome, basRelief, chalkCharcoal, charcoal, photocopy, stamp, tornEdges, waterPaper, notePaper, plaster, reticulation, halftonePattern, graphicPen