webdav-server / Guides

Web Media Projection Resolver

Use .wm rules to turn web media listing pages into browseable WebDAV-style media resources.

web-mediawm-ruleprojection

What a .wm rule describes

A .wm marker file tells Zwind how to read a website: the source page, item selector, optional detail links, title selector, thumbnail selector, media type, projection mode, and runtime settings such as browser-like parsing.

Common projection shapes

Use projection=by-item when each listing card should become a folder. Use projection=flat when media resources should appear directly in the projected directory. Use detail_url_mode=expand when one item page contains multiple episode or part links.

Debug-first workflow

When a site does not resolve, run the generator debug command. The debug output should answer:

  • Which source page was loaded.
  • Which candidate items matched.
  • Which item URLs were extracted.
  • Whether intermediate detail pages were expanded.
  • Which media URLs were found.

This is the fastest way to tell whether the rule needs a selector change, a browser runtime, a longer selector wait, or a different media type.