Merge main into M13.12

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 11:37:02 -06:00 · 2026-10-03 09:51:48 -04:00
parent 5db4bff461 c005493c84
commit f35c820c53
335 changed files with 29661 additions and 398 deletions
@@ -17,7 +17,9 @@ cpal or muda. Everything in L0 to L4, the egui UI and the web app also build for
 | L0 | `geom` | Vectors, matrices, quaternions, the layer transform (anchor, position, scale, orientation, rotation) |
 | L0 | `color` | sRGB and linear, HSL/HSV, luminance, the 38 blend modes, label colors |
 | L0 | `vp9enc` | VP9 intra-frame encoder (profile 0, 8-bit 4:2:0; lossless at quality 100) for WebM export, from the VP9 bitstream specification |
-| L0 | `opusenc` | Opus (CELT) encoder: RFC 6716 CELT-only fullband 48 kHz 20 ms packets, mono/stereo, and the RFC 7845 `OpusHead`, for WebM export audio |
+| L0 | `opusenc` | Opus encoder: RFC 6716 SILK (NB/MB/WB), hybrid (SWB/FB) and CELT (FB) modes chosen by bitrate and application (audio / voice), 48 kHz 20 ms packets, mono/stereo, and the RFC 7845 `OpusHead`, for WebM export audio |
+| L0 | `hevcenc` | HEVC (H.265) encoder from ITU-T H.265: Main / Main 10 4:2:0, IDR + P slices (quarter-pel motion, merge/AMVP), CABAC, deblocking, bitrate or constant-QP rate control, for MP4 (`hvc1`) export |
+| L0 | `av1enc` | AV1 encoder from the AV1 bitstream specification: Main profile 8/10-bit 4:2:0, key + inter frames (quarter-pel motion), deblocking, for MP4 (`av01`) and WebM export |
 | L1 | `raster` | Premultiplied float images, sampling, affine and projective warps, blurs, compositing (parallel with rayon) |
 | L1 | `keyframe` | Animated values, keyframes with temporal ease and spatial Bezier, roving, hold, velocity |
 | L1 | `psd` | Photoshop PSD/PSB reader (layers, groups, masks, blend modes, text, layer effects, adjustment layers; 8/16/32-bit; RGB/CMYK/Gray/Lab) and a minimal writer, from Adobe's published format specification |
@@ -32,7 +34,7 @@ cpal or muda. Everything in L0 to L4, the egui UI and the web app also build for
 | L3 | `render` | Evaluation and compositing: sources, masks, effects, transforms, 3D, motion blur, mattes, blending, layer cache, audio mixdown |
 | L3 | `media` | Footage decoding (FilmCraft's pure-Rust codecs), image sequences, Photoshop and SVG stills, frame cache |
 | L3 | `expr` | The expression engine (JavaScript via boa) with the After Effects object model |
-| L3 | `export` | Render queue encoding: H.264, ProRes, WebM (VP9 + alpha, Opus), PNG/JPEG/TIFF/EXR sequences, GIF, WAV/AIFF |
+| L3 | `export` | Render queue encoding: H.264, HEVC and AV1 MP4, ProRes, WebM (VP9 + alpha or AV1, Opus), PNG/JPEG/TIFF/EXR sequences, GIF, WAV/AIFF |
 | L3 | `gpu` | The GPU compositor and GPU effects on wgpu compute shaders (Metal, Vulkan, Direct3D 12, WebGPU), checked against the CPU renderer |
 | L3 | `lottie` | Lottie JSON / dotLottie import and export (layers, precomps, eased and spatial keyframes, shapes, masks, mattes) with a warnings list for what Lottie cannot express |
 | L3 | `plugin` | Effect plug-ins: loads sandboxed WebAssembly effect modules (plug-in API v1; the wasmi interpreter behind the `wasm` feature, on for native hosts) into the effect registry ([plugins.md](plugins.md)) |
@@ -174,10 +176,15 @@ against the caster planes (Shadow Diffusion, Light Transmission) and blending. A
 run their effect stacks on the GPU-resident comp (`Renderer::run_effects_on` with an `FxTarget`):
 runs of GPU effects stay on the device and only non-GPU effects read back and upload. Advanced 3D
 compositing and wireframes still run on the CPU between GPU steps (read back, draw, upload). GPU
-effects (`effects::GPU_EFFECTS`, 58 of them: blurs, colour, keying incl. Key Light, distortion,
-transitions, generators, noise and grain; see [effects.md](effects.md)) repeat the CPU effect's
-steps (padding, box radii, parameters, hashes) as kernels; consecutive GPU effects run as one
-chain with one upload and one readback. Tests render scenes on both paths and compare them
+effects (`effects::GPU_EFFECTS`, 152 of them: blurs, colour correction, keying incl. Key Light,
+mattes, channel, stylize, distortion, transitions, generators, noise, grain and time; see
+[effects.md](effects.md)) repeat the CPU effect's steps (padding, box radii, parameters, hashes)
+as kernels, in one module per family (`gpu::fx_*` with `shaders/fx_*.wgsl`); consecutive GPU
+effects run as one chain with one upload and one readback. Statistics that need the whole frame
+(Auto Levels / Contrast / Color, Equalize, Shadow/Highlight, Color Stabilizer, Remove Grain's
+noise level) are measured on the CPU from one readback and applied on the GPU; effects reading
+other frames (Echo, Posterize Time) upload the frames the host renders. Settings a kernel cannot
+match render on the CPU (`effects::catalog::gpu_supported`). Tests render scenes on both paths and compare them
 (≤ 1/255 at 8 bpc, ≤ 1e-3 at 32 bpc); they skip without an adapter. The desktop viewer builds the
 `Gpu` on egui-wgpu's device and shows frames from GPU textures without reading them back
 (`ui-egui::frames`); headless renders, the CLI (unless `--gpu`) and CI use the CPU. On the web
@@ -5,7 +5,7 @@

 EffectCraft ships 306 effects with 3009 parameters in total, grouped into the same categories as the Effects & Presets panel. Every effect is our own implementation, written from public behaviour descriptions and standard image-processing literature. Parameter names, order, popup options, units, defaults and ranges follow the reference application so that projects, expressions and muscle memory carry over.

- **GPU**: 59 effects also run on the GPU compositor with identical results.
+- **GPU**: 152 effects also run on the GPU compositor with identical results.
 - **32**: 306 effects process 32-bit float (HDR, overbright) pixels without clamping.
 - **Status**: 306 implemented in full, 0 partial (what is missing is listed).

@@ -46,85 +46,85 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Bilateral Blur | `ec.blur.bilateral` | 3 |  | 32 | Implemented |
+| Bilateral Blur | `ec.blur.bilateral` | 3 | GPU | 32 | Implemented |
 | CC Cross Blur | `ec.blur.cccross` | 3 |  | 32 | Implemented |
 | CC Radial Blur | `ec.blur.ccradial` | 4 |  | 32 | Implemented |
 | CC Radial Fast Blur | `ec.blur.ccradialfast` | 3 | GPU | 32 | Implemented |
 | CC Vector Blur | `ec.blur.ccvector` | 4 |  | 32 | Implemented |
 | Camera Lens Blur | `ec.blur.cameralens` | 16 | GPU | 32 | Implemented |
 | Camera-Shake Deblur | `ec.blur.camerashakedeblur` | 8 |  | 32 | Implemented |
-| Channel Blur | `ec.blur.channel` | 6 |  | 32 | Implemented |
-| Compound Blur | `ec.blur.compound` | 4 |  | 32 | Implemented |
+| Channel Blur | `ec.blur.channel` | 6 | GPU | 32 | Implemented |
+| Compound Blur | `ec.blur.compound` | 4 | GPU | 32 | Implemented |
 | Directional Blur | `ec.blur.directional` | 2 | GPU | 32 | Implemented |
 | Fast Box Blur | `ec.blur.fastbox` | 4 | GPU | 32 | Implemented |
 | Gaussian Blur | `ec.blur.gaussian` | 3 | GPU | 32 | Implemented |
 | Radial Blur | `ec.blur.radial` | 4 | GPU | 32 | Implemented |
-| Sharpen | `ec.blur.sharpen` | 1 |  | 32 | Implemented |
-| Smart Blur | `ec.blur.smart` | 3 |  | 32 | Implemented |
-| Unsharp Mask | `ec.blur.unsharp` | 3 |  | 32 | Implemented |
+| Sharpen | `ec.blur.sharpen` | 1 | GPU | 32 | Implemented |
+| Smart Blur | `ec.blur.smart` | 3 | GPU | 32 | Implemented |
+| Unsharp Mask | `ec.blur.unsharp` | 3 | GPU | 32 | Implemented |

 ## Channel

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Arithmetic | `ec.channel.arithmetic` | 5 |  | 32 | Implemented |
-| Blend | `ec.channel.blend` | 4 |  | 32 | Implemented |
+| Arithmetic | `ec.channel.arithmetic` | 5 | GPU | 32 | Implemented |
+| Blend | `ec.channel.blend` | 4 | GPU | 32 | Implemented |
 | CC Composite | `ec.channel.cccomposite` | 3 |  | 32 | Implemented |
-| Calculations | `ec.channel.calculations` | 9 |  | 32 | Implemented |
-| Channel Combiner | `ec.channel.combiner` | 6 |  | 32 | Implemented |
-| Compound Arithmetic | `ec.channel.compoundarithmetic` | 6 |  | 32 | Implemented |
+| Calculations | `ec.channel.calculations` | 9 | GPU | 32 | Implemented |
+| Channel Combiner | `ec.channel.combiner` | 6 | GPU | 32 | Implemented |
+| Compound Arithmetic | `ec.channel.compoundarithmetic` | 6 | GPU | 32 | Implemented |
 | Invert | `ec.channel.invert` | 2 | GPU | 32 | Implemented |
-| Minimax | `ec.channel.minimax` | 5 |  | 32 | Implemented |
-| Remove Color Matting | `ec.channel.removecolormatting` | 2 |  | 32 | Implemented |
-| Set Channels | `ec.channel.setchannels` | 9 |  | 32 | Implemented |
-| Set Matte | `ec.channel.setmatte` | 6 |  | 32 | Implemented |
-| Shift Channels | `ec.channel.shiftchannels` | 4 |  | 32 | Implemented |
-| Solid Composite | `ec.channel.solidcomposite` | 4 |  | 32 | Implemented |
+| Minimax | `ec.channel.minimax` | 5 | GPU | 32 | Implemented |
+| Remove Color Matting | `ec.channel.removecolormatting` | 2 | GPU | 32 | Implemented |
+| Set Channels | `ec.channel.setchannels` | 9 | GPU | 32 | Implemented |
+| Set Matte | `ec.channel.setmatte` | 6 | GPU | 32 | Implemented |
+| Shift Channels | `ec.channel.shiftchannels` | 4 | GPU | 32 | Implemented |
+| Solid Composite | `ec.channel.solidcomposite` | 4 | GPU | 32 | Implemented |

 ## Color Correction

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Auto Color | `ec.color.autocolor` | 6 |  | 32 | Implemented |
-| Auto Contrast | `ec.color.autocontrast` | 5 |  | 32 | Implemented |
-| Auto Levels | `ec.color.autolevels` | 5 |  | 32 | Implemented |
+| Auto Color | `ec.color.autocolor` | 6 | GPU | 32 | Implemented |
+| Auto Contrast | `ec.color.autocontrast` | 5 | GPU | 32 | Implemented |
+| Auto Levels | `ec.color.autolevels` | 5 | GPU | 32 | Implemented |
 | Black & White | `ec.color.blackwhite` | 8 | GPU | 32 | Implemented |
 | Brightness & Contrast | `ec.color.brightnesscontrast` | 3 | GPU | 32 | Implemented |
-| Broadcast Colors | `ec.color.broadcast` | 3 |  | 32 | Implemented |
-| CC Color Neutralizer | `ec.color.cccolorneutralizer` | 11 |  | 32 | Implemented |
-| CC Color Offset | `ec.color.cccoloroffset` | 4 |  | 32 | Implemented |
-| CC Kernel | `ec.color.cckernel` | 12 |  | 32 | Implemented |
-| CC Toner | `ec.color.cctoner` | 7 |  | 32 | Implemented |
-| Change Color | `ec.color.changecolor` | 9 |  | 32 | Implemented |
-| Change to Color | `ec.color.changetocolor` | 9 |  | 32 | Implemented |
+| Broadcast Colors | `ec.color.broadcast` | 3 | GPU | 32 | Implemented |
+| CC Color Neutralizer | `ec.color.cccolorneutralizer` | 11 | GPU | 32 | Implemented |
+| CC Color Offset | `ec.color.cccoloroffset` | 4 | GPU | 32 | Implemented |
+| CC Kernel | `ec.color.cckernel` | 12 | GPU | 32 | Implemented |
+| CC Toner | `ec.color.cctoner` | 7 | GPU | 32 | Implemented |
+| Change Color | `ec.color.changecolor` | 9 | GPU | 32 | Implemented |
+| Change to Color | `ec.color.changetocolor` | 9 | GPU | 32 | Implemented |
 | Channel Mixer | `ec.color.channelmixer` | 13 | GPU | 32 | Implemented |
 | Color Balance | `ec.color.colorbalance` | 10 | GPU | 32 | Implemented |
-| Color Balance (HLS) | `ec.color.colorbalancehls` | 3 |  | 32 | Implemented |
+| Color Balance (HLS) | `ec.color.colorbalancehls` | 3 | GPU | 32 | Implemented |
 | Color Link | `ec.color.colorlink` | 6 |  | 32 | Implemented |
-| Color Stabilizer | `ec.color.colorstabilizer` | 6 |  | 32 | Implemented |
+| Color Stabilizer | `ec.color.colorstabilizer` | 6 | GPU | 32 | Implemented |
 | Colorama | `ec.color.colorama` | 20 | GPU | 32 | Implemented |
 | Curves | `ec.color.curves` | 0 | GPU | 32 | Implemented |
-| Equalize | `ec.color.equalize` | 2 |  | 32 | Implemented |
+| Equalize | `ec.color.equalize` | 2 | GPU | 32 | Implemented |
 | Exposure | `ec.color.exposure` | 14 | GPU | 32 | Implemented |
-| Gamma/Pedestal/Gain | `ec.color.gammapedestalgain` | 10 |  | 32 | Implemented |
+| Gamma/Pedestal/Gain | `ec.color.gammapedestalgain` | 10 | GPU | 32 | Implemented |
 | Hue/Saturation | `ec.color.huesaturation` | 50 | GPU | 32 | Implemented |
-| Leave Color | `ec.color.leavecolor` | 5 |  | 32 | Implemented |
+| Leave Color | `ec.color.leavecolor` | 5 | GPU | 32 | Implemented |
 | Levels | `ec.color.levels` | 36 | GPU | 32 | Implemented |
-| Levels (Individual Controls) | `ec.color.levelsic` | 27 |  | 32 | Implemented |
+| Levels (Individual Controls) | `ec.color.levelsic` | 27 | GPU | 32 | Implemented |
 | Lumetri Color | `ec.color.lumetri` | 66 | GPU | 32 | Implemented |
 | OCIO CDL Transform | `ec.color.ociocdl` | 12 |  | 32 | Implemented |
 | OCIO Color Space Transform | `ec.color.ociocolorspace` | 7 |  | 32 | Implemented |
 | OCIO Display Transform | `ec.color.ociodisplay` | 9 |  | 32 | Implemented |
 | OCIO File Transform | `ec.color.ociofile` | 4 |  | 32 | Implemented |
 | OCIO Look Transform | `ec.color.ociolook` | 6 |  | 32 | Implemented |
-| PS Arbitrary Map | `ec.color.psarbitrarymap` | 2 |  | 32 | Implemented |
-| Photo Filter | `ec.color.photofilter` | 4 |  | 32 | Implemented |
+| PS Arbitrary Map | `ec.color.psarbitrarymap` | 2 | GPU | 32 | Implemented |
+| Photo Filter | `ec.color.photofilter` | 4 | GPU | 32 | Implemented |
 | Selective Color | `ec.color.selectivecolor` | 38 | GPU | 32 | Implemented |
-| Shadow/Highlight | `ec.color.shadowhighlight` | 14 |  | 32 | Implemented |
+| Shadow/Highlight | `ec.color.shadowhighlight` | 14 | GPU | 32 | Implemented |
 | Tint | `ec.color.tint` | 3 | GPU | 32 | Implemented |
 | Tritone | `ec.color.tritone` | 4 | GPU | 32 | Implemented |
 | Vibrance | `ec.color.vibrance` | 2 | GPU | 32 | Implemented |
-| Video Limiter | `ec.color.videolimiter` | 5 |  | 32 | Implemented |
+| Video Limiter | `ec.color.videolimiter` | 5 | GPU | 32 | Implemented |

 ## Distort

@@ -135,37 +135,37 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands
 | CC Bend It | `ec.distort.ccbendit` | 4 |  | 32 | Implemented |
 | CC Bender | `ec.distort.ccbender` | 5 |  | 32 | Implemented |
 | CC Blobbylize | `ec.distort.ccblobbylize` | 15 |  | 32 | Implemented |
-| CC Flo Motion | `ec.distort.ccflomotion` | 7 |  | 32 | Implemented |
-| CC Griddler | `ec.distort.ccgriddler` | 5 |  | 32 | Implemented |
+| CC Flo Motion | `ec.distort.ccflomotion` | 7 | GPU | 32 | Implemented |
+| CC Griddler | `ec.distort.ccgriddler` | 5 | GPU | 32 | Implemented |
 | CC Lens | `ec.distort.cclens` | 3 | GPU | 32 | Implemented |
 | CC Page Turn | `ec.distort.ccpageturn` | 7 |  | 32 | Implemented |
-| CC Power Pin | `ec.distort.ccpowerpin` | 10 |  | 32 | Implemented |
-| CC Ripple Pulse | `ec.distort.ccripplepulse` | 5 |  | 32 | Implemented |
-| CC Slant | `ec.distort.ccslant` | 4 |  | 32 | Implemented |
-| CC Smear | `ec.distort.ccsmear` | 4 |  | 32 | Implemented |
-| CC Split | `ec.distort.ccsplit` | 3 |  | 32 | Implemented |
-| CC Split 2 | `ec.distort.ccsplit2` | 4 |  | 32 | Implemented |
-| CC Tiler | `ec.distort.cctiler` | 3 |  | 32 | Implemented |
-| Corner Pin | `ec.distort.cornerpin` | 4 |  | 32 | Implemented |
+| CC Power Pin | `ec.distort.ccpowerpin` | 10 | GPU | 32 | Implemented |
+| CC Ripple Pulse | `ec.distort.ccripplepulse` | 5 | GPU | 32 | Implemented |
+| CC Slant | `ec.distort.ccslant` | 4 | GPU | 32 | Implemented |
+| CC Smear | `ec.distort.ccsmear` | 4 | GPU | 32 | Implemented |
+| CC Split | `ec.distort.ccsplit` | 3 | GPU | 32 | Implemented |
+| CC Split 2 | `ec.distort.ccsplit2` | 4 | GPU | 32 | Implemented |
+| CC Tiler | `ec.distort.cctiler` | 3 | GPU | 32 | Implemented |
+| Corner Pin | `ec.distort.cornerpin` | 4 | GPU | 32 | Implemented |
 | Detail-preserving Upscale | `ec.distort.upscale` | 4 |  | 32 | Implemented |
 | Displacement Map | `ec.distort.displacementmap` | 8 | GPU | 32 | Implemented |
-| Liquify | `ec.distort.liquify` | 12 |  | 32 | Implemented |
-| Magnify | `ec.distort.magnify` | 10 |  | 32 | Implemented |
+| Liquify | `ec.distort.liquify` | 12 | GPU | 32 | Implemented |
+| Magnify | `ec.distort.magnify` | 10 | GPU | 32 | Implemented |
 | Mesh Warp | `ec.distort.meshwarp` | 3 | GPU | 32 | Implemented |
-| Mirror | `ec.distort.mirror` | 2 |  | 32 | Implemented |
-| Offset | `ec.distort.offset` | 2 |  | 32 | Implemented |
-| Optics Compensation | `ec.distort.opticscompensation` | 6 |  | 32 | Implemented |
-| Polar Coordinates | `ec.distort.polar` | 2 |  | 32 | Implemented |
+| Mirror | `ec.distort.mirror` | 2 | GPU | 32 | Implemented |
+| Offset | `ec.distort.offset` | 2 | GPU | 32 | Implemented |
+| Optics Compensation | `ec.distort.opticscompensation` | 6 | GPU | 32 | Implemented |
+| Polar Coordinates | `ec.distort.polar` | 2 | GPU | 32 | Implemented |
 | Puppet | `ec.distort.puppet` | 1 |  | 32 | Implemented |
 | Reshape | `ec.distort.reshape` | 6 |  | 32 | Implemented |
 | Ripple | `ec.distort.ripple` | 7 | GPU | 32 | Implemented |
 | Rolling Shutter Repair | `ec.distort.rollingshutterrepair` | 5 |  | 32 | Implemented |
 | Smear | `ec.distort.smear` | 8 |  | 32 | Implemented |
-| Spherize | `ec.distort.spherize` | 2 |  | 32 | Implemented |
+| Spherize | `ec.distort.spherize` | 2 | GPU | 32 | Implemented |
 | Transform | `ec.distort.transform` | 12 | GPU | 32 | Implemented |
 | Turbulent Displace | `ec.distort.turbulentdisplace` | 11 | GPU | 32 | Implemented |
 | Twirl | `ec.distort.twirl` | 3 | GPU | 32 | Implemented |
-| Twirl (Legacy) | `ec.distort.twirllegacy` | 3 |  | 32 | Implemented |
+| Twirl (Legacy) | `ec.distort.twirllegacy` | 3 | GPU | 32 | Implemented |
 | Warp | `ec.distort.warp` | 5 |  | 32 | Implemented |
 | Warp Stabilizer | `ec.distort.warpstabilizer` | 20 |  | 32 | Implemented |
 | Wave Warp | `ec.distort.wavewarp` | 7 | GPU | 32 | Implemented |
@@ -236,29 +236,29 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Advanced Spill Suppressor | `ec.key.advancedspill` | 8 |  | 32 | Implemented |
+| Advanced Spill Suppressor | `ec.key.advancedspill` | 8 | GPU | 32 | Implemented |
 | CC Simple Wire Removal | `ec.key.ccsimplewireremoval` | 7 |  | 32 | Implemented |
-| Color Difference Key | `ec.key.colordifference` | 16 |  | 32 | Implemented |
-| Color Range | `ec.key.colorrange` | 8 |  | 32 | Implemented |
-| Difference Matte | `ec.key.differencematte` | 6 |  | 32 | Implemented |
-| Extract | `ec.key.extract` | 6 |  | 32 | Implemented |
+| Color Difference Key | `ec.key.colordifference` | 16 | GPU | 32 | Implemented |
+| Color Range | `ec.key.colorrange` | 8 | GPU | 32 | Implemented |
+| Difference Matte | `ec.key.differencematte` | 6 | GPU | 32 | Implemented |
+| Extract | `ec.key.extract` | 6 | GPU | 32 | Implemented |
 | Inner/Outer Key | `ec.key.innerouter` | 88 |  | 32 | Implemented |
-| Key Cleaner | `ec.key.keycleaner` | 4 |  | 32 | Implemented |
+| Key Cleaner | `ec.key.keycleaner` | 4 | GPU | 32 | Implemented |
 | Key Light | `ec.keying.keylight` | 56 | GPU | 32 | Implemented |
 | Linear Color Key | `ec.key.linearcolor` | 6 | GPU | 32 | Implemented |
-| Screen Key | `ec.key.screen` | 11 |  | 32 | Implemented |
-| Unmult | `ec.key.unmult` | 6 |  | 32 | Implemented |
+| Screen Key | `ec.key.screen` | 11 | GPU | 32 | Implemented |
+| Unmult | `ec.key.unmult` | 6 | GPU | 32 | Implemented |

 ## Matte

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Matte Choker | `ec.matte.mattechoker` | 7 |  | 32 | Implemented |
+| Matte Choker | `ec.matte.mattechoker` | 7 | GPU | 32 | Implemented |
 | Mocha shape | `ec.obsolete.mochashape` | 6 |  | 32 | Implemented |
-| Refine Hard Matte | `ec.matte.refinehard` | 16 |  | 32 | Implemented |
-| Refine Soft Matte | `ec.matte.refinesoft` | 18 |  | 32 | Implemented |
+| Refine Hard Matte | `ec.matte.refinehard` | 16 | GPU | 32 | Implemented |
+| Refine Soft Matte | `ec.matte.refinesoft` | 18 | GPU | 32 | Implemented |
 | Roto Brush & Refine Edge | `ec.matte.rotobrush` | 24 |  | 32 | Implemented |
-| Simple Choker | `ec.matte.simplechoker` | 2 |  | 32 | Implemented |
+| Simple Choker | `ec.matte.simplechoker` | 2 | GPU | 32 | Implemented |

 ## Noise & Grain

@@ -266,17 +266,17 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands
 |---|---|---:|:-:|:-:|---|
 | Add Grain | `ec.noise.addgrain` | 32 | GPU | 32 | Implemented |
 | Curl Noise | `ec.noise.curlnoise` | 10 |  | 32 | Implemented |
-| Dust & Scratches | `ec.noise.dustscratches` | 3 |  | 32 | Implemented |
+| Dust & Scratches | `ec.noise.dustscratches` | 3 | GPU | 32 | Implemented |
 | Fractal Noise | `ec.noise.fractal` | 26 | GPU | 32 | Implemented |
 | Match Grain | `ec.noise.matchgrain` | 37 |  | 32 | Implemented |
-| Median | `ec.noise.median` | 2 |  | 32 | Implemented |
-| Median (Legacy) | `ec.noise.medianlegacy` | 2 |  | 32 | Implemented |
+| Median | `ec.noise.median` | 2 | GPU | 32 | Implemented |
+| Median (Legacy) | `ec.noise.medianlegacy` | 2 | GPU | 32 | Implemented |
 | Noise | `ec.noise.noise` | 3 | GPU | 32 | Implemented |
-| Noise Alpha | `ec.noise.noisealpha` | 8 |  | 32 | Implemented |
-| Noise HLS | `ec.noise.noisehls` | 6 |  | 32 | Implemented |
-| Noise HLS Auto | `ec.noise.noisehlsauto` | 6 |  | 32 | Implemented |
-| Remove Grain | `ec.noise.removegrain` | 20 |  | 32 | Implemented |
-| Turbulent Noise | `ec.noise.turbulent` | 22 |  | 32 | Implemented |
+| Noise Alpha | `ec.noise.noisealpha` | 8 | GPU | 32 | Implemented |
+| Noise HLS | `ec.noise.noisehls` | 6 | GPU | 32 | Implemented |
+| Noise HLS Auto | `ec.noise.noisehlsauto` | 6 | GPU | 32 | Implemented |
+| Remove Grain | `ec.noise.removegrain` | 20 | GPU | 32 | Implemented |
+| Turbulent Noise | `ec.noise.turbulent` | 22 | GPU | 32 | Implemented |

 ## Obsolete

@@ -284,13 +284,13 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands
 |---|---|---:|:-:|:-:|---|
 | Basic 3D | `ec.obsolete.basic3d` | 5 |  | 32 | Implemented |
 | Basic Text | `ec.obsolete.basictext` | 11 |  | 32 | Implemented |
-| Color Key | `ec.key.colorkey` | 4 |  | 32 | Implemented |
+| Color Key | `ec.key.colorkey` | 4 | GPU | 32 | Implemented |
 | Gaussian Blur (Legacy) | `ec.obsolete.gaussianlegacy` | 2 |  | 32 | Implemented |
 | Lightning | `ec.obsolete.lightning` | 25 |  | 32 | Implemented |
-| Luma Key | `ec.key.luma` | 5 |  | 32 | Implemented |
+| Luma Key | `ec.key.luma` | 5 | GPU | 32 | Implemented |
 | Path Text | `ec.obsolete.pathtext` | 32 |  | 32 | Implemented |
 | Reduce Interlace Flicker | `ec.blur.reduceflicker` | 1 |  | 32 | Implemented |
-| Spill Suppressor | `ec.key.spill` | 3 |  | 32 | Implemented |
+| Spill Suppressor | `ec.key.spill` | 3 | GPU | 32 | Implemented |

 ## Paint

@@ -340,31 +340,31 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands

 | Effect | Id | Params | GPU | 32 | Status |
 |---|---|---:|:-:|:-:|---|
-| Brush Strokes | `ec.stylize.brushstrokes` | 7 |  | 32 | Implemented |
+| Brush Strokes | `ec.stylize.brushstrokes` | 7 | GPU | 32 | Implemented |
 | CC Block Load | `ec.stylize.ccblockload` | 5 |  | 32 | Implemented |
 | CC Burn Film | `ec.stylize.ccburnfilm` | 3 |  | 32 | Implemented |
 | CC Glass | `ec.stylize.ccglass` | 17 |  | 32 | Implemented |
 | CC HexTile | `ec.stylize.cchextile` | 5 |  | 32 | Implemented |
-| CC Kaleida | `ec.stylize.cckaleida` | 4 |  | 32 | Implemented |
+| CC Kaleida | `ec.stylize.cckaleida` | 4 | GPU | 32 | Implemented |
 | CC Mr. Smoothie | `ec.stylize.ccmrsmoothie` | 7 |  | 32 | Implemented |
 | CC Plastic | `ec.stylize.ccplastic` | 18 |  | 32 | Implemented |
-| CC RepeTile | `ec.stylize.ccrepetile` | 5 |  | 32 | Implemented |
-| CC Threshold | `ec.stylize.ccthreshold` | 4 |  | 32 | Implemented |
-| CC Threshold RGB | `ec.stylize.ccthresholdrgb` | 7 |  | 32 | Implemented |
-| CC Vignette | `ec.stylize.ccvignette` | 4 |  | 32 | Implemented |
+| CC RepeTile | `ec.stylize.ccrepetile` | 5 | GPU | 32 | Implemented |
+| CC Threshold | `ec.stylize.ccthreshold` | 4 | GPU | 32 | Implemented |
+| CC Threshold RGB | `ec.stylize.ccthresholdrgb` | 7 | GPU | 32 | Implemented |
+| CC Vignette | `ec.stylize.ccvignette` | 4 | GPU | 32 | Implemented |
 | Cartoon | `ec.stylize.cartoon` | 12 |  | 32 | Implemented |
 | Color Emboss | `ec.stylize.coloremboss` | 4 |  | 32 | Implemented |
 | Emboss | `ec.stylize.emboss` | 4 | GPU | 32 | Implemented |
 | Find Edges | `ec.stylize.findedges` | 2 | GPU | 32 | Implemented |
 | Glow | `ec.stylize.glow` | 14 | GPU | 32 | Implemented |
 | Mosaic | `ec.stylize.mosaic` | 3 | GPU | 32 | Implemented |
-| Motion Tile | `ec.stylize.motiontile` | 8 |  | 32 | Implemented |
-| Posterize | `ec.stylize.posterize` | 1 |  | 32 | Implemented |
-| Roughen Edges | `ec.stylize.roughenedges` | 13 |  | 32 | Implemented |
-| Scatter | `ec.stylize.scatter` | 3 |  | 32 | Implemented |
-| Strobe Light | `ec.stylize.strobe` | 7 |  | 32 | Implemented |
-| Texturize | `ec.stylize.texturize` | 4 |  | 32 | Implemented |
-| Threshold | `ec.stylize.threshold` | 1 |  | 32 | Implemented |
+| Motion Tile | `ec.stylize.motiontile` | 8 | GPU | 32 | Implemented |
+| Posterize | `ec.stylize.posterize` | 1 | GPU | 32 | Implemented |
+| Roughen Edges | `ec.stylize.roughenedges` | 13 | GPU | 32 | Implemented |
+| Scatter | `ec.stylize.scatter` | 3 | GPU | 32 | Implemented |
+| Strobe Light | `ec.stylize.strobe` | 7 | GPU | 32 | Implemented |
+| Texturize | `ec.stylize.texturize` | 4 | GPU | 32 | Implemented |
+| Threshold | `ec.stylize.threshold` | 1 | GPU | 32 | Implemented |

 ## Text

@@ -379,9 +379,9 @@ Effects are addressed by id (`ec.<category>.<name>`) or display name in commands
 |---|---|---:|:-:|:-:|---|
 | CC Force Motion Blur | `ec.time.ccforcemotionblur` | 4 |  | 32 | Implemented |
 | CC Wide Time | `ec.time.ccwidetime` | 3 |  | 32 | Implemented |
-| Echo | `ec.time.echo` | 5 |  | 32 | Implemented |
+| Echo | `ec.time.echo` | 5 | GPU | 32 | Implemented |
 | Pixel Motion Blur | `ec.time.pixelmotionblur` | 4 |  | 32 | Implemented |
-| Posterize Time | `ec.time.posterizetime` | 1 |  | 32 | Implemented |
+| Posterize Time | `ec.time.posterizetime` | 1 | GPU | 32 | Implemented |
 | Time Difference | `ec.time.timedifference` | 5 |  | 32 | Implemented |
 | Time Displacement | `ec.time.timedisplacement` | 4 |  | 32 | Implemented |
 | Timewarp | `ec.time.timewarp` | 28 |  | 32 | Implemented |
@@ -10,13 +10,13 @@ How close EffectCraft is to After Effects 2026, feature by feature, and how much
 | Unweighted | ≈ 94% (half-credit) / 98% (fractions) |
 | P0 / P1 / P2 | ≈ 96% / 92% / 85% (half-credit); 99% / 97% / 96% (fractions) |
 | Features done / partial / missing | 80 / 12 / 0 of 92 |
-| **Effects** | **298 of 298** After Effects 2026 effects exist; 42 still simplified ([effects.md](effects.md)); 58 run on the GPU |
+| **Effects** | **298 of 298** After Effects 2026 effects exist; 42 still simplified ([effects.md](effects.md)); 152 run on the GPU |
 | Disabled menu entries left | 0 (the stub list is empty) |
 | Remaining work | ≈ 19–22 agent-hours at the pace measured so far (≈ 58 on the conservative audit scale) |
 | **Wall-clock estimate** | **≈ 4–5 hours** with five agents in parallel; ≈ 3 hours for 100% of P0 + P1 |

-Partial features: GPU coverage (Advanced 3D, more GPU effects), the web app (no threads for
-viewer frames and Roto Brush), Essential Graphics mirrored properties, and the learned-model quality
+Partial features: GPU coverage (Advanced 3D, more GPU effects), the web app (GPU effects and
+the disk cache in the browser; M13.10 moved viewer frames and Roto Brush off the page's thread), Essential Graphics mirrored properties, and the learned-model quality
 of Roto Brush and face tracking (both are classical). Since this audit, M9.13 completed all 42
 simplified effects, M13.5 added the Learn panel, and M13.8 the Preview panel settings, Align to
 Selection / Distribute and Advanced 3D iris DOF, collapsed precomps and extruded strokes. M13.7 added ScriptUI resource strings,
@@ -36,7 +36,7 @@ Tracking 96%, Effects 85%, Web 65%.
 What is left, in priority order: the web app's depth (threads, storage, audio, non-blocking
 renders); stroke taper/wave and multi-segment dashes; variable mask feather points; camera iris/bokeh and focus-link commands; 
 approximated effects (Key Cleaner) and Liquify's viewer brush; JPX / JBIG2 images in
-imported PDF/AI files (mesh shadings and CCITT landed in M13.12) and Illustrator procset EPS; and more codecs. Face tracking and a true Subspace Warp
+imported PDF/AI files (mesh shadings and CCITT landed in M13.12) and Illustrator procset EPS; and codec depth (B-frames, SAO/CDEF; HEVC and AV1 export and Opus SILK/hybrid landed in M13.4). Face tracking and a true Subspace Warp
 landed in M13.3. ScriptUI (dialogs that block `show()`, palettes, dockable ScriptUI panels, File ▸ Scripts install
 and sample scripts), puppet pin recording and the remaining "better than After Effects" items — a
 versioned effect plug-in API with sandboxed WebAssembly plug-ins ([plugins.md](plugins.md)),
@@ -126,7 +126,7 @@ the disk cache in the formats wave; the 3D Camera Tracker in M12.6.)
 | Area | Weighted parity | Remaining (agent-hours) | Biggest gaps |
 |---|---|---|---|
 | Layers | 88% | 4.8 | frame blending, collapse transformations, slip edit |
-| Output | 97% | 0.8 | Render Settings complete (field render + 3:2 pulldown, effects/solo/guide/depth/blending/blur overrides, time sampling, storage overflow), Output Module crop/ROI/resize, alpha modes, post-render actions, PCM formats, templates with defaults, render logs, Notify (M10.2); WebM VP9 key + inter frames with motion search, loop filter and rate control. Left: Opus is CELT-only, Photoshop sequence output, overflow for movies only checks at file creation |
+| Output | 97% | 0.8 | Render Settings complete (field render + 3:2 pulldown, effects/solo/guide/depth/blending/blur overrides, time sampling, storage overflow), Output Module crop/ROI/resize, alpha modes, post-render actions, PCM formats, templates with defaults, render logs, Notify (M10.2); WebM VP9 key + inter frames with motion search, loop filter and rate control; M13.4: HEVC export (MP4 `hvc1`, `effectcraft-hevcenc`: Main / Main 10, IDR + P slices, quarter-pel motion, deblocking, bit-exact with ffmpeg) and AV1 export (MP4 `av01` and WebM, `effectcraft-av1enc`: 8/10-bit key + inter frames, quarter-pel motion, loop filter, bit-exact with libdav1d) with profile, level, bitrate / constant-quality and key-frame interval options; Opus SILK (NB/MB/WB, mid/side stereo) and hybrid (SWB/FB) modes chosen by bitrate and Audio/Voice tuning, with the Opus bitrate in the Output Module. HEVC/AV1 import decodes through FilmCraft (MP4/MOV/MKV/WebM). Left: HEVC/AV1 have no B-frames, multi-reference, SAO/CDEF/restoration or alpha (compression below mature encoders); Opus has no FEC/DTX and only 20 ms frames; Photoshop sequence output, overflow for movies only checks at file creation |
 | Audio | 85% | 0.5 | audio to keyframes |
 | Import | 97% | 0.5 | JPX / JBIG2 images and predefined non-Identity CJK CMaps inside PDF/AI files, Illustrator EPS relying on Adobe procsets, PSD 3D layers (M13.12: mesh shadings — free-form / lattice Gouraud triangles, Coons and tensor patches — and function-based shadings, CCITT G3 / G4 images, knockout / isolated transparency groups with group alpha and soft masks on the group's result, `/W2` vertical metrics, EPS text with embedded Type 1 / CFF or bundled fonts, and Create Shapes from Vector Layer keeping images as parented footage layers in paint order; M13.6: PDF/AI text with embedded TrueType / CFF / Type 1 / Type 3 fonts and standard-14 fallback to the bundled fonts, Flate / DCT / inline / stencil images with soft masks, Indexed and ICC alternates, luminosity / alpha soft masks, the 16 blend modes, tiling patterns, calculator functions, any page via `file.import page` and the Import dialog, clip groups kept by Create Shapes from Vector Layer as layer masks / Merge Paths; PSD smart-object perspective quads and placed-layer warps — named styles and custom quilt meshes — baked as placed; PDF / PDF-compatible AI / EPS vector footage with Continuously Rasterize, layered composition import and Create Shapes from Vector Layer, and PSD smart objects with embedded files landed in M13.2; PSD as footage/composition/retain layer sizes, SVG footage earlier) |
 | Automation | ≈ 99% | 0.1 | `.jsxbin` (AUT-2: ScriptUI resource strings, `onDraw`/ScriptUIGraphics, live `onChanging`, `Socket`, Essential Graphics hooks — `addToMotionGraphicsTemplate(As)`, `canAddToMotionGraphicsTemplate`, `exportAsMotionGraphicsTemplate`, `motionGraphicsTemplateName`, controller count/names — and Watch Folder landed in M13.7; the core object model landed in M14.4; ScriptUI windows/dialogs/dockable panels with `scriptui.*` agent commands, File ▸ Scripts install + sample scripts, and the effect plug-in API (EFF-6, WebAssembly) landed in M13.1) |
@@ -134,10 +134,10 @@ the disk cache in the formats wave; the 3D Camera Tracker in M12.6.)
 | Compositions | ≈ 80% | 3.5 | Mocha-style planar tracks for templates, Essential Graphics' mirrored properties (CMP-7: Font and uniform Scale controls, Composition ▸ Open in Essential Graphics, Save Frame As ▸ Photoshop Layers / ProEXR and the VR Comp Editor landed in M13.7; the marker dialog, Composition Flowchart, Essential Graphics with master properties, `.ectemplate` templates and Responsive Design — Time landed: CMP-6, CMP-7) |
 | Animation | 70% | 9.0 | puppet depth beyond pins and recording (puppet pin recording with Record Options landed in M13.1), Wiggler/Smoother/Motion Sketch (motion-path handles and the graph editor transform box landed in M5.8; keyframe colour labels and Select Keyframe Label Group, Graph Editor snapping to markers / layer ends in M13.5) |
 | Text | ≈ 96% | 0.3 | no extruded strokes (M13.12: the Variable Font Axes animator re-spaces the text — advances follow the animated axes; M13.6: variable font axes in the character style — `layer.setText variations`, the Character panel's Variable Font Axes fields — shape with HVAR / gvar advances and draw at that design-space position; OpenType features — stylistic sets, discretionary ligatures, contextual / stylistic alternates, swash, titling, ordinals, fractions, figure styles, true small caps / all small caps and superior / inferior glyphs with faux fallback — per character with the Character panel's OpenType popup and `text.fontFeatures` landed in M13.2; vertical Roman / Tate-Chu-Yoko, forced LTR paragraphs, caret on animated and path text, Variable Font Axes and Lottie style runs landed in M13.5; extruded, bevelled text in M7.6; per-character styles, paragraph settings, on-canvas editing and the `sourceText` style API in M9.9–M9.10) |
-| Web | 85% | 1.0 | viewer frames and Roto Brush propagation still on the page's thread; GPU effects in the browser (browser storage, Web Audio, Web Worker renders/analyses, WebGPU viewer and offline install landed in M15.2) |
+| Web | 93% | 0.5 | GPU effects in the browser (WebGPU compositing only on the page), no disk cache, no shared-memory threads inside one engine instance (browser storage, Web Audio, Web Worker renders/analyses, WebGPU viewer and offline install landed in M15.2; viewer frames in frame workers fed by project diffs, Roto Brush propagation in a worker, non-blocking `wait: true` jobs and a browser Media Browser (File System Access folders, browser storage) in M13.10) |
 | 3D | 88% | 5.5 | multi-view layouts, the Extended Viewer for Advanced 3D comps (Classic 3D Extended Viewer landed in M13.5 UI completion); collapsed precomps of another size seen through the parent's camera render (fixed in M13.2); stereo rigs, orbit nulls, lights controlled by the camera, cameras/lights from glTF models, environment backgrounds, Advanced 3D motion blur, blend modes and track mattes landed in M7.7; Classic 3D iris-shaped bokeh with highlights, progressive depth of field on tilted layers and the focus-link commands landed in M13.5; Advanced 3D depth of field with the iris and highlight options, collapsed precomps as real Advanced 3D geometry and extruded text/shape strokes landed in M13.8; Advanced 3D (glTF/OBJ models, primitives, extruded text and shapes, PBR, image-based light, shadow maps, GPU rasteriser) in M7.4–M7.6 |
-| Effects | ≈ 80% | 4.0 | GPU versions of the remaining effects (58 run on the GPU since M12.7) and the missing controls listed as partial in [effects.md](effects.md) (every After Effects effect exists since M9.11, M12.5 and M12.6; parameter names, order, twirl-downs, popups, units and defaults were aligned in M9.12) |
-| Interface | 74% | 5.0 | more Learn tutorials and pixel-level fidelity of dialogs (the Home ▸ Learn tab with interactive tutorials and a UI fidelity pass landed in M13.5 UI completion; Timeline outline and Project panel columns scroll horizontally, the Layer Style dialog, ROI resize handles, Pan Behind snapping and 3D Reference Axes landed in M13.5; native macOS menu bar, Timeline columns/search/reveal-add, Home screen with recent projects and all AE workspaces landed; viewer rulers/snapping/channels/snapshots landed in M0.13) |
+| Effects | ≈ 85% | 3.0 | GPU versions of the remaining effects (152 run on the GPU since M13.9, EFF-5: keying, mattes, channel, colour correction, stylize, distort, noise, blurs and time effects joined the 58 of M12.7; Warp, Bezier Warp, Reshape, Smear, Cartoon, CC Page Turn and others still render on the CPU) and the missing controls listed as partial in [effects.md](effects.md) (every After Effects effect exists since M9.11, M12.5 and M12.6; parameter names, order, twirl-downs, popups, units and defaults were aligned in M9.12) |
+| Interface | 74% | 5.0 | more Learn tutorials and pixel-level fidelity of dialogs (the Home ▸ Learn tab with interactive tutorials and a UI fidelity pass landed in M13.5 UI completion; visual editors for Lumetri RGB / hue-saturation curves, Colorama's output cycle wheel, Glow's colour map and Reshape's correspondence points (viewer handles), a scrolling Preview panel and AE-style Composition / Timeline tabs (close, label swatch, viewer lock) landed in M13.10; Timeline outline and Project panel columns scroll horizontally, the Layer Style dialog, ROI resize handles, Pan Behind snapping and 3D Reference Axes landed in M13.5; native macOS menu bar, Timeline columns/search/reveal-add, Home screen with recent projects and all AE workspaces landed; viewer rulers/snapping/channels/snapshots landed in M0.13) |
 | Project | ≈ 68% | 5.5 | auto-save, folder moves, OCIO displays beyond the built-in tone map (Color Engine with OCIO/ACES working spaces, HDR compand/tone mapping, Rec. 2100 PQ/HLG output, Feet + Frames, display colour management, Simulate Output and the locked viewer landed in M7.7; proxies and Interpret Footage fields / pixel aspect / alpha guess landed: PRJ-8, PRJ-3) |
 | Masks & roto | 74% | 5.0 | Roto Brush's learned (3.0) segmentation model (variable-width mask feather points with the Mask Feather tool landed in M13.5; mask tracking and Mask Interpolation landed in M6.6; Roto Brush & Refine Edge with graph-cut segmentation, flow propagation, edge matting, decontamination and Freeze in M6.7) |
 | Preview | 74% | 3.2 | wireframes and Advanced 3D compositing on the GPU (Classic 3D bokeh depth of field — iris shapes, highlights, fringe, progressive blur on tilted planes — runs in WGSL since M13.6: 3D Showcase GPU warm 205 → 54 ms/frame at full size on an M4 Pro; the Preview panel's five shortcuts with their own Include / Loop / Cache Before Playback / Range / Play From / Frame Rate / Skip / Resolution / Full Screen / stop options and `playback.settings.get/set` landed in M13.8; Classic 3D runs and adjustment layers composite on the GPU since M12.7; persistent disk cache with the blue cache bar landed; region of interest, snapshots, exposure and Fast Previews landed in M0.13) |
@@ -239,7 +239,7 @@ precompose), **Auto-trace** (alpha / RGB / luminance, current frame or work area
 or a new layer) and **Align Video to Data** (JSON / CSV / TSV time keys) replace their disabled
 menu entries. Not yet: creating a reference frame by editing a still (After Effects hands it to
 Photoshop), Content-Aware Fill's learned model (ours is PatchMatch + flow propagation), and Media
-Browser in the web app.
+Browser in the web app (landed in M13.10: browser storage and File System Access folders).

 ## Update: M13.12 import and text leftovers, test hardening

@@ -273,7 +273,7 @@ Browser in the web app.
 2. Effect Controls widgets: angle dial, point crosshair, eyedropper, curves and levels editors.
 3. ~~Viewer basics: snapping, rulers, channel view, snapshots, exposure, a drawable region of interest.~~ (M0.13)
 4. ~~A GPU (wgpu) compositor, then GPU effects~~ (M12.2: 2D compositing and 16 GPU effects; M12.7:
-   Classic 3D runs, adjustment layers, 58 GPU effects and GPU particles).
+   Classic 3D runs, adjustment layers, 58 GPU effects and GPU particles; M13.9: 152 GPU effects).
 5. ~~Pen tool for shape paths, shape vertex editing, free transform~~ (M6.5); the Layer viewer.
 6. ~~Motion-path handles in the viewer; graph editor transform box and snapping.~~ (M5.8)
 7. Point tracking and stabilization (in progress).
@@ -41,14 +41,15 @@ with every L0–L4 crate and `effectcraft-ui-egui`, for `wasm32-unknown-unknown`

 URL flags: `?empty` (a blank project; the session is not restored or recorded), `?demo` (the demo
 project instead of the last session), `?home` (show the start screen), `?storage=indexeddb` /
-`?storage=memory` (force a storage backend), `?noworkers` (render and analyse on the page's
-thread), `?nosw` (don't register the service worker).
+`?storage=memory` (force a storage backend), `?noworkers` (render, analyse and draw viewer
+frames on the page's thread), `?frameworkers=N` (frame workers, default 2; 0 = viewer frames on
+the page's thread), `?nosw` (don't register the service worker).

 ## How the desktop pieces map to the browser

 | Desktop | Web |
 |---|---|
-| frame render thread pool (`ui-egui/src/frames.rs`) | `Frames::pump`: queued frames render on the UI thread after each egui frame, most important first (the viewer's frame, then prefetch), within 40 ms (24 ms while playing) |
+| frame render thread pool (`ui-egui/src/frames.rs`) | frame workers (below): `Frames::pump` hands queued frames to them, most important first (the viewer's frame, then prefetch); frames the GPU compositor can keep on the GPU render on the page. Without workers, queued frames render on the UI thread after each egui frame within 40 ms (24 ms while playing) |
 | Render Queue on a background thread | a Web Worker running a second engine instance (below); progress streams back, the page never waits |
 | tracker / mask tracker / Warp Stabilizer / 3D Camera Tracker / Roto Brush Freeze threads | the same workers; the analysed property group comes back as one undo step |
 | `rayon` parallel loops (raster, effects, export batches) | rayon's global pool falls back to the calling thread when threads are unavailable: same code, serial |
@@ -59,6 +60,7 @@ thread), `?nosw` (don't register the service worker).
 | media reads (`MediaPool`, `probe`) | `files::WebImporter`: bytes from the file table, handed to `MediaPool::add_bytes` / `probe_bytes` |
 | export writes (`effectcraft-export`) | the job's `sink` (`effectcraft_host::FileExporter { sink }`): files land in the table and download after the render; several files (an image sequence) download as one stored `.zip` |
 | rfd file dialogs | `<input type=file>` for File ▸ Open / Import; drop files anywhere on the page (`.ecproj` opens, everything else imports); "Save As" / "Output To" pick a download name |
+| Media Browser on the file system | browser storage and folders opened with the File System Access API (below) |
 | system fonts | not scanned; the bundled fonts (Inter, Noto Serif, JetBrains Mono) are always there |
 | TCP control channel / MCP | `window.effectcraft` (below) |
 | cpal audio output | Web Audio (below) |
@@ -109,10 +111,65 @@ compiled twice) and its own memory (`crates/engine/src/offload.rs`, `src/worker.
   tracker / mask group is replaced; other edits made meanwhile are kept) and the downloads start.

 Stopping a job terminates its worker (a worker can't be interrupted mid-frame): the item being
-rendered becomes "User Stopped", an analysis writes nothing. `renderQueue.render {wait: true}` (the
-default for agents) and analysis commands with `wait: true` still run on the page's thread and
-return when done. Roto Brush propagation fills the session's segmentation cache rather than the
-project, so it runs on the page's thread too, as do viewer frames (`Frames::pump`).
+rendered becomes "User Stopped", an analysis writes nothing. Every job shows in Window ▸ Progress
+(`jobs.list`) with its progress and a cancel button (`jobs.cancel`).
+
+**Roto Brush propagation** runs in a job worker too (`WorkerJob::RotoPropagate`): the worker
+streams the segmentations it computes back at most every 250 ms (`WorkerReply::Segs`: each
+`FrameSeg` in a compact binary form, run-length coded planes, base64), the page puts them into its
+segmentation cache and relays them to the frame workers. Stopping it keeps the frames propagated
+so far.
+
+**`wait: true`** (the default of `renderQueue.render` for agents, and an option of the analysis
+and Roto Brush commands) no longer blocks the page: over `window.effectcraft` (the control
+channel) such a command runs with `wait: false`, and the promise resolves when the job it started
+ends, with what the blocking command returns (final render item statuses, the analysis status)
+or rejects with the job's error (`ui-egui/src/control.rs`, `JobWaiter`). Engine commands executed
+directly on the session (scripts) still block.
+
+### Viewer frames: frame workers
+
+Viewer frames (the frame on screen, RAM preview and prefetch) render in long-lived **frame
+workers** (`src/frames.rs`, `crates/engine/src/remote.rs`), two by default. Each holds a replica
+of the project:
+
+1. Before a render, the page sends a worker the footage files it lacks, then a sync: the whole
+   project the first time, afterwards a **diff** of the serialized project from the revision the
+   worker holds (`remote::diff`: object members added / changed / removed, arrays element-wise
+   when their length is unchanged; a slider drag sends a few hundred bytes, not the project).
+2. Then the render request (`FrameMsg::Render`: revision, comp, time, render options). The worker
+   renders on its CPU renderer and posts the frame back as premultiplied RGBA8 in a transferred
+   buffer (`FrameReply::Frame`); the page puts it in the frame cache.
+3. One frame per worker at a time, so the page always picks what renders next (the viewer's frame
+   before prefetch); a request for a revision the worker does not hold is refused, a worker that
+   lost its replica asks for the whole project again (`FrameReply::Resync`).
+
+Frames the WebGPU compositor can finish alone still render on the page (they stay on the GPU, no
+readback); everything else (CPU-only effects, 3D runs, the Software Only renderer, WebGL2) goes to
+the workers. If no worker is usable, frames render on the page's thread as before.
+`effectcraft.info().frameWorkers` reports `{workers, alive, busy, rendered, failed, lastMs,
+syncs, syncBytes}`.
+
+**Why workers and not wasm threads:** shared-memory threads (SharedArrayBuffer + atomics, a
+`wasm-bindgen-rayon`-style pool) need the standard library rebuilt with atomics (`build-std`,
+nightly Rust); the repository builds on stable, so each worker runs its own engine instance with
+its own memory. The page is still cross-origin isolated (`--serve` and the service worker send
+COOP / COEP), so a threaded build can be added later without changing the deployment.
+
+### Media Browser
+
+Window ▸ Media Browser browses a virtual tree (`src/browse.rs`):
+
+- **Browser Storage**: every file in browser storage (imported media, saved projects, files added
+  with **Add Files…** or **Upload Folder…**, plain file inputs that work in every browser). This is
+  the persistent recent list where folders can't be opened.
+- **Folders**: **Open Folder…** (File System Access API, `showDirectoryPicker`, Chromium) lists a
+  folder from the user's disk; only the listing is read, and a file's bytes are read when it is
+  imported (then kept in browser storage). The folder handles are remembered in IndexedDB; after
+  a reload the folders come back if the browser still grants access, else **Reconnect <name>**
+  asks again.
+
+`mediaBrowser.list` reports the places and these actions; `mediaBrowser.action {action}` runs one.

 ### Audio

@@ -192,15 +249,24 @@ cargo xtask web --serve 8765 &
 node apps/effectcraft-web/tests/smoke.mjs --url http://127.0.0.1:8765/ --out target/web/smoke
 ```

+It also checks the M13.10 paths: viewer frames rendered in frame workers while scrubbing with the
+CPU renderer (project synced as diffs, event-loop gaps under 400 ms), a `wait: true` render that
+replies when done while the page keeps running, and the Media Browser over browser storage.
+
 Native unit tests cover the storage model (`apps/effectcraft-web/src/store.rs`: write
 coalescing, file table, `ConfigStore` / `FileOps`, auto-save and crash recovery through the
 browser store) and the worker protocol (`crates/engine/src/offload.rs`: serde round trips of
-every request and reply, a render through an in-process offload).
+every request and reply, a render through an in-process offload; `tests_roto.rs`: Roto Brush
+propagation through an offload streaming segmentations), the frame-worker protocol
+(`crates/engine/src/remote.rs`: diff / patch, a replica following edits renders the same pixels;
+`crates/ui-egui/tests/ui_web_offload.rs`: the frame cache through a remote renderer, `wait: true`
+deferred until the offloaded job ends) and the Media Browser's virtual tree (`media_browser.rs`,
+`tests_panels.rs`).

 ## Gaps

- Viewer frames, RAM preview and Roto Brush propagation still render on the page's thread (one
-  frame at a time between UI frames).
+- No shared-memory threads: each worker is a separate engine instance (memory per worker: the
+  project replica and the footage it reads).
 - GPU effects run only in the desktop GPU path: in the browser, effects run on the CPU (inside
  workers for renders) because the page's thread can't wait for mid-render readbacks.
 - No disk cache (Settings ▸ Media & Disk Cache) in the browser: the layer cache stays in memory.