Live: all twelve, defaults

Live: three presenters, cues, beats and a camera

Loading...

The code of both examples is in demo.js.

Presenters library, version 0.1.0

The PrompTugal.news presenters as a library: twelve synthetic presenters, built and animated by code in the browser with three.js. Each is an original character, not the likeness of a real person, and each is always labelled "synthetic presenter". There is no female figure in this set, at Dinis's word. Made by bulletins.b@PrompTugal.dinis on 21 November 2026, at Dinis Cruz's word the same day: "Yes, I would like to have the presenter engine as a reusable library using our current library publishing flow". The engine is version 2 (Claude) of the presenter language. It was adopted on 21 November and already draws the day's video bulletin at bulletins.promptugal.news/lab/bulletin-v2/.

Code: Apache-2.0. Text and data: CC BY 4.0. three.js 0.160.1 (vendor/): MIT, notice in vendor/three.LICENSE.

Versions and addresses

FolderWhat it holdsChanges?
v0.1.0/This versionNever. The publisher refuses to change a published version
v0.1/The newest 0.1.xMoves to each new 0.1.x
v0/The newest 0.x.yMoves to each new 0.x.y
latest/The newest versionMoves to each new version
versions.jsonEvery version, its date and its filesGrows

The base is https://bulletins.promptugal.news/lib/presenters/. A site that ships should use a pinned version, v0.1.0/. latest/ is for trying things out.

How a site takes it (our library flow, as for the shared map and the sites bar):

  1. Copy the whole version folder into your own site, for example as /assets/presenters/0.1.0/. Don't load it from bulletins.promptugal.news.
  2. Check every file against the pins listed for this version in the registry (promptugal.news/api/v1/sites.json). Pins are never stored in this repository. Until dev@ lists the pins after security@'s review reads "passed", treat the version as a preview. Use it in the lab, not on a published page.
  3. Serve it with script-src 'self'. It makes no request outside its own folder, and its data fetches are credential-free.

Use it

<div id="stage" style="width:640px;height:360px"></div>
<script type="module">
  import { mount } from '/assets/presenters/0.1.0/presenters.js';
  const show = await mount(document.getElementById('stage'), {
    presenters: ['anchor', 'holo', 'owl'],
    duration: 8,
    cues: [{ t: 0.5, who: 'anchor', do: 'wave' }, { t: 2, who: 'all', do: 'nod', stagger: 0.1 }],
  });
  show.play();
</script>

That is all the code a site needs. mount makes the canvas, the name tags and the label inside your element, and takes the element's size.

mount(element, options) returns a show

OptionMeaningDefault
presentersids to put on stage, in orderall twelve
slots{ id: [x, z] } positions on the floor (z from -3.4 to -1.25 stands on the riser)each character's own
cues[{ t, who, do, ...params, stagger }]. who is an id, a list, 'all' or a group; do is a movenone
camerashots, { t, pos, look, fov, ease } or { t, focus, dist, h, lh, orbit, cut, only }one wide shot
beats[{ t, title }], a caption in the cornernone
groups{ name: [ids] } for whoall
durationseconds10
tracks{ name: { mouthCues: [{ start, end, value }] } }, mouth shapes A to H and X (Rhubarb's), for speaknone
audioa URL to play with the show; the show then follows the audio's clocknone
tagsname tags above each headtrue
background, autostage colour; automatic { idle, blink, fidget }'#060914'; idle and blink

The corner label "n synthetic presenters · made by code, no real person" is always drawn and cannot be turned off.

The show: play(), pause(), seek(t), renderAt(t) (one exact frame; every frame is a pure function of t, so the same t always gives the same picture), t, duration, playing, resize(), destroy(), and stage, director and data for advanced use.

Also exported: loadData() (the four data files), Stage, Director, CH (the pose channels), VERSION and LABEL.

The twelve

idNameStyle
holoTejohologram
anchorDuarteflat, newsreader
realistRuinearer realism
teletextCeefaxteletext blocks
guideThe Guidehatched (after storyboards.sgit.ai)
agentThe Agenthatched robot (after storyboards.sgit.ai)
conductorConductorflat robot (after the-ultimate-insider.book.sgit.ai)
researcherResearcherflat robot (after the book)
rowanRowanline (after riskmandate.ai's cast)
caretakerThe Caretakerline robot (after riskmandate.ai's cast)
owlMochoflat owl
cubeCubo3D cube

The styles after the storyboards, the book and RiskMandate are new models made in those styles and credited; they are not copies.

The moves

There are 69 moves in data/moves.json, each with its parameters and defaults. Some to start with:

data/choreography.json is the 114 s showcase written as data (118 cues, 49 camera shots): a worked example of every kind of cue.

What is in the folder

presenters.js (the entry), engine/ (14 modules), vendor/ (three.js and its licence), data/ (characters, moves, choreography, visemes), index.html (this page with live examples), demo.js, README.md, manifest.json (name, version, files, licences; no hashes: the pins are in the registry).

Performance

Measured on a 4-CPU container with no GPU (the same machine as the bulletin): drawing all twelve takes p50 12.3 ms a frame. Taking a screenshot of a frame costs about 0.5 s there, because WebGL is drawn in software. In a normal browser with a GPU, it plays live at 60 frames a second.

Changes

Made by agents: bulletins.b@PrompTugal.dinis. Every presenter is synthetic and labelled; none is the likeness of a real person.