A Pointman extension that publishes a folder's work as it settles. It watches a folder on a node, waits for each new or changed file to stop changing, and posts it in the thread of the sync that covers it: video as a playable proxy, plus images, audio, PDFs, HTML pages with the files they load, and frame sequences as one video. Comments on what it posts are written back into each project's folder as a notes file, so a session working there can read them.

Python (standard library only), run by the node on Python 3.12.

pointman add dailies

• ffmpeg and ffprobe on the PATH, for video proxies, posters, audio and frame sequences.
• On macOS, sips and Quick Look (built in) for images and documents. Elsewhere, pdftoppm (poppler) for a PDF's picture, if it's there.
• macOS (Apple silicon) or Linux (x86-64 or arm64).

• Watches root: FSEvents on macOS, elsewhere a poll of the folders' modified times, plus a full scan every scan_interval.
• Settles: a file is published once its size and modified time have held still for stable_seconds, so recordings and renders in progress are left alone. Eight or more numbered frames (seq/shot-####.png) wait for the render to pause and publish as one video. An HTML page is published with the files it loads.
• Publishes only what a sync covers (create_sync on the board), in that sync's thread. Nothing else publishes by itself. Ignored names and rules with skip = true never publish.
• What it builds: for a video, a proxy (HEVC on a Mac with VideoToolbox, H.264 elsewhere, at video's or a rule's size and bitrate; a video that's already light is only remuxed) with a poster and thumbnail. Images in a form every app shows, audio as AAC with a waveform, a PDF with a picture of it, and pages with what they use. 3D files are left to the Blender extension.
• Review notes: each project's comments go to <project>/review-notes.md (notes_file). Notes at a timecode on a DaVinci Resolve timeline are left for the Resolve extension's markers.
• The Files tab: the folder's file list goes to the board after each scan that changed it.
• Keeps the Mac awake while there's publishing to do (keep_awake).
• Keeps disk free: it publishes nothing while less than min_free_gb is free.

It holds no token: files go to the board through the node, and so does every other call.

Agents call them on a machine with create_job. share_file and pointman push of a file in the folder come here too.

It reads the board's syncs and review notes as it starts, then again only when the node says they changed (syncs.changed, notes.changed: core pushes them, from node 0.4.6), so it never polls them. A read that fails is tried again after 30 s.

dailies.status: the folder, what's waiting to settle, queued, being published, published and failed, recent failures, the syncs, the last scan, the last error, whether it's watching, whether the node lets it publish from root, and what it took over from an older node.

Per machine, in ~/.config/pointman/extensions/dailies/config.toml, or pointman config set node.extensions.dailies.<key> <value>:

The folder it may use: the node lets it publish only from inside its permissions.folders, ~/Documents/youtube. So root must be that folder or one inside it.