ambition

The Ambition user manual

Your work,
on every screen.

Ambition shows Designer projects on the screens in your room. Speak or use the room page to choose what each screen shows; Ambition answers on screen, never out loud.

Sign in and out

Open your installation’s address and sign in with your Diffusion staff account. Ambition sends you to the Diffusion sign-in page and returns you to the room page afterwards. To sign out of Ambition in this browser, open Sign out.

Sign the room in from your phone

When nobody is signed in, the main room screen shows a large QR code. Scan it with your phone camera and sign in with your Diffusion staff account on the phone; the code disappears, the screen shows “Signed in”, and the room acts on what you say from then on. The room stays signed in, through restarts and for days, until someone says “Ambition log out” or your access is revoked in Portal. To hand the room to someone else, say “Ambition switch user”: the code appears for five minutes and whoever scans it takes over. Someone who has not used this room before is asked once, on their phone, to approve Ambition in Portal. Each code works once and changes every few minutes, so a photo of it soon stops working. After “Ambition log out”, signing in on the room page does not sign the room back in; scan the code. While the screensaver shows, the code waits behind it; say “Ambition wake” to see it.

Ambition shows the room page only when its room host is connected. If the page reports that the room host is unavailable, the host is restarting or offline; try again shortly or ask the person who looks after the installation.

Connect a room through Diffusion Portal

The room page shows all defined screens live, updating as their content changes. Choose Zoom to focus on one, then All screens to return. Screen settings and History open below the monitor. Preview shows rendered content; AirPlay source shows the sender’s composed source. Lossless means full-quality frames; Preview JPEG means the room is using the slower compressed fallback. Frame age and unavailable states identify interrupted monitoring.

On a room installation, sign in with your Diffusion staff account. Open Connect your screens, create an Ambition production key in Designer’s key settings, and paste it into the secure Connect Designer form. Select the projects you want the room to use, then review their exact permissions in Portal. Never paste a key into the conversation.

Approval can let existing output continue after ordinary sign-out for up to 24 hours. New microphone use, navigation and edits still require a current signed-in controller. Disconnect or revoke access in Portal to stop the room’s authorization.

When automatic recovery is enabled, opening the room reconnects its saved app views under current approval. If someone AirPlays to a room TV from their own device, Ambition leaves that TV to them, including after a restart, until you ask by voice to show something on that screen. It keeps their saved versions; it does not repeat edits or page advances. Requesting Neutral keeps that screen stopped until you explicitly reopen it. On your phone, open the same installation’s phone controller, sign in, and tap Start voice. The browser asks for microphone permission. Starting on another controller explicitly transfers the room microphone. On installations with continuous voice enabled, Stop turns the microphone off while its last words finish sending. Voice is real time: audio that does not reach Ambition is gone, and nothing is kept in the browser to recover or download. If the microphone stops on its own, start it again. Reconcile an unknown original action instead of repeating it. Logical screens without a trusted receiver show app previews only; they do not establish television output. Use each screen’s simulated display link to open its preview. To use a configured television, save its receiver choice and explicitly choose Connect selected receiver. Enter a requested current television code only in that private form. Neutralize before changing an existing receiver. An unconfirmed result stays listed with Look up original receiver operation; Connect selected receiver is unavailable only while an operation is still in progress, and a result that says Not done reached nothing and can simply be tried again; a paired receiver still needs a separately confirmed output admission. If the app action is confirmed but rendering is blocked, use Reload saved view to recover the pinned view. Do not repeat a page advance to test whether it happened.

Voice in, visuals out

The predictive room installation and opt-in local trial respond entirely on screen: candidate commands before execution, visible progress, large choices when a request is ambiguous, and results. It does not speak acknowledgments, questions or replies. Start its microphone explicitly. The room screens show what was heard: a band along the bottom of the screen a command is for, led by a large picture and one or two words for what is about to happen (a deck and “Launch review”) with a line such as “Opening Launch review on Center”; the band stays up while a slow open is still working. When the result is itself visible, such as the next slide or an opened presentation, the band simply clears; otherwise the picture turns into a green check when done or a red cross when not done, while the presentation stays visible above it. When a request matches several presentations, the center screen shows up to five large numbered choices; say the number (“one”, “two”…) or the name, “more choices” to page through the list, or “cancel this request”. Choices are also shown on the controller, which must stay open for a spoken choice to count. Independent requests keep their own progress. An unseen candidate remains blocked, and an uncertain action must be reconciled by its original result. Real phone, timing and television acceptance require separate checks; unresolved authority or an unbound receiver can still block app output.

Which one? When two to four things match what you said, such as “Open Conveyor” while a Clarity specification is also called Conveyor, the screen dims behind a short list stacked top to bottom. Answer with “top” or “bottom” (or “middle”), a number, or the word shown on the row such as “the app” or “the spec”; say “never mind” to close it. It closes by itself after about twenty seconds. To skip the question, say which one up front: “Open the Conveyor app”, “Open the Conveyor spec” or “Open Clarity Conveyor”.

Voice help appears on the room screens, never spoken. Its quoted examples are drawn from what that screen accepts right now, such as “Show recent projects” or a number from a list on screen. After a command is not done or a screen is unclear, a short strip of examples appears under the result for about eight seconds. Empty and list screens keep a small hint strip along the bottom. Say “Never mind” or “Hide projects” to close a list; the screen keeps what was behind it. “Help” over a list replaces it with the help card, and numbers still pick from that list. Say “What can I say?”, “Help” or “Help on Ambition Center” for a larger card of grouped commands on that screen for about twelve seconds or until your next command. Opening a deck or specification shows a short strip for about five seconds, then the presentation is left clear.

Gravity R–01 Colorways

With slide 2 of the Design and Colorways deck on the focused room screen, say “give me an orange upper and black laces.” To select all four layers at once, say “make the upper gray, the midsole white, the outsole cyan and the laces black.” Say “match the laces to the sole” to link them again. Say “explode” (or “explode the shoe”) to separate the layers or “assemble” (or “reassemble the shoe”) to bring them together in their current colors. Short requests such as “orange midsole” work too, and you can add a screen: “orange midsole on Center”. Say “shuffle all”, “shuffle upper”, “shuffle midsole”, “shuffle sole” or “shuffle laces” for a random new color. A small label in the lower left shows what was heard. The pieces glide between exploded and assembled in Glass rendering; Flipbook shows only the final position. In Lab, click Cyan, Orange, Pink or Green to show the standard shoe with matching laces and outsole. These previews last for the current slide session.

Missed speech

Voice is real time. If Ambition cannot act on a request when you say it, for example because the microphone stream was interrupted, its timing or the screens changed before it could run, or the room host restarted, the request is dropped. Nothing is held for later review, and blocked requests are not shown. Say the request again. An installation in intake-only testing can transcribe your speech while showing “App actions are held for testing.”; commands do not run until the operator finishes qualification. For a controller summary, say “Show room status.” An uncertain earlier action must be reconciled with its original result before you repeat it.

Screensaver

The room screens are on all the time, so Ambition covers them with a dim, slowly moving screensaver to protect the televisions from burn-in. It starts after an hour with no recognized command and at 8 p.m. each evening. There are three scenes: Tide, a slow deep-blue plasma; Aurora, faint green and violet curtains; and Ink, warm embers folding through dark water. Each start picks one at random, different from the last.

Say “Ambition screensaver”, or just “Screensaver” on its own, to start it now; saying it again switches to another scene. To bring the screens back, hail Ambition: say “Ambition wake”, “Ambition start” or “Ambition hello”. A near miss such as “Ambition week” wakes it too. You can add a command after the hail, such as “Ambition hello, show recent projects”. While the screensaver shows, everything else you say is ignored, so conversation and stray commands never wake it. Any action on the room page also wakes it. Nothing on a screen changes underneath, so the presentation returns as it was, along with any notes or idea gallery it was showing. A screen cleared from the room page stays black and does not show the screensaver.

Clear and focus

Say “Focus left” (or center, right) to edge that screen in a yellow frame; commands that name no screen then go to it. Say “Clear left” to take the presentation off a screen: it shows its “Nothing on … yet” page instead, and a focused screen keeps its yellow frame, so you can clear a screen and still point your next command at it. Showing anything on that screen again, including “next slide”, brings the presentation back. Say “Remove focus” (or “Zoom out”) to drop the frame. “Focus left” and “Remove focus” work even while you are dictating a note or describing ideas; the note or ideas stay open. If Ambition mishears “Clear” (for example as “Claire left”), it does not clear anything; the screen shows how to say it, so say it again.

Mute

To talk without Ambition reacting at all, say “Ambition mute”. A red frame edges every screen, a “Muted” band stays on the main screen, and Ambition ignores everything it hears, including the screensaver words. Say “Ambition unmute”, on its own, to resume. Ambition accepts it even when it mishears the words (for example “Ambition on mute”), but not when people are only talking about unmuting. Mute stays on after a restart. The room page still works while muted.

Glass and Flipbook rendering

Ambition can draw Lab slides on the room screens two ways. Flipbook, the usual way, sends a fresh picture of each slide about once a second. Glass streams the slide to the screen as it moves, so animations are smooth. Say “Glass mode” or “Flipbook mode” to switch; the screen confirms which one is on, and the choice stays after a restart. Glass is new and still being tried.

Slide commands

Some Lab slides answer to their own short commands, such as “Shuffle”, “Play” or “Rotate shoe”. Say the command on its own and the slide reacts at once; the command shows briefly on the screen first. If two screens show slides with the same command, the focused screen gets it; otherwise add the screen, as in “Shuffle on left”. Room commands such as “Next slide”, “Clear” and “Focus” always keep their usual meaning, and slide commands also work while you are dictating a note. A slide offers its commands about a second after it appears. Say “What can I say” to see them: help lists up to six of the slide’s commands first. Commands are built into a slide in Lab, together with the script that reacts to them; a room note cannot add one, because notes never change a slide’s script.

Notes

You can leave a spoken note on whatever a screen is showing, like a comment in a shared document: a Lab slide or project, a Clarity section, or a gallery of generated ideas. Ambition keeps the note with that object, and the app that owns it (for example Lab’s agent) picks it up from Ambition and works on it. A note on an idea gallery moves to the gallery’s Lab project once the gallery is saved there, and notes on a Lab project also show on its slides.

Say “Make a note”, or name the screen: “Make a note on the left”. You can start talking straight away: “Make a note, I want this heading blue.” Without a screen name the note goes to the focused screen, to the only screen showing something, or to the screen you last spoke to; otherwise Ambition shows the screens and you say the number or the name. A panel on the right of that screen shows the note as Ambition tidies it up, with the words it is hearing right now in grey underneath, with ums, repeats and false starts removed and later corrections (“no, make it red”) applied. Keep talking until you are finished, then say “Save note”, “Done note” or “Close note”. Say “Execute note” instead of “Save note” to save and start working on a Lab note immediately. Say “Cancel note” to throw it away. A plain “Done” or “Save it” saves too; you can always reopen a note with “Edit note …”. Ambition only asks “Save this note?” when it is unsure, for example after “Never mind”: say “Save”, “Keep going” or “Discard”. A note left alone for five minutes is kept as a draft.

Say “Show notes” (or “Show notes on Ambition Center”) to list the notes on what a screen shows: a short summary and the date of each. Say “Show note two” to read that note in full in a panel beside the list. Say “Edit note two” to add to or correct a note by talking again, then “Save note”. Say “Delete note two” to archive it; archived notes leave the list but are not destroyed. Say “Hide notes” to close the list. While a note is open, everything you say goes into the note, except “Focus …” and “Remove focus”, so finish or cancel it before giving other commands.

Notes use OpenAI for transcription and clean-up when the installation has an OpenAI key configured; otherwise they keep Ambition’s own transcript. Saving a note does not change the slide. Say “Execute note one” to release a saved Lab note. Clear minor edits, such as a specified heading or color change, are applied promptly and shown on the original screen when it still shows that slide. The note surfaces dismiss immediately, leaving only a small bottom-right spinner until the saved change is displayed. Released edits run using the agent’s best judgment; correct the result with another note. Notes you have only saved say “Saved only”. Say “Hold note one” to stop pending work. A save already in flight may finish; its result is checked before any further work. Editing or archiving a note withdraws its previous release.

Say “Execute note” to dismiss the note immediately and apply it using the agent’s best judgment. A small spinner in the bottom right shows it is being worked on; the notes list does not open. The spinner disappears after the saved change is shown. Correct anything you dislike with another note. Notes for different projects can progress independently. Done notes are automatically deleted after about 60 seconds; the applied changes remain.

Say “Undo the last change” (or “Revert that”) to put the slide back the way it was before its most recent change. Saying it again, or “Redo that”, brings the change back. This also works while you are dictating a note: the change is undone and your note stays open. “Revert note one” undoes that note’s change. Undo only works while that change is still the newest one on the slide: if anything has changed the slide since, the screen says so and nothing is undone. Earlier versions are never lost; an undo is saved as a new version in Lab.

Notes about pictures. A note can redraw a picture on a Lab slide: “Make the hero warmer”, “Turn the sky on the left photo pink” or, on a slide that is one big picture, just “Make it a winter scene”. Ambition works out which picture you mean from its name, what it shows, its size and its place on the slide, and the spinner names it (“Applying note on hero”). If it cannot tell, the screen shows the pictures as numbered choices: say the number or the picture’s name, or “skip” to let the editor choose. Say “Show pictures” to see the pictures on a slide and the names you can use. A picture built in Lab with a name such as “hero” always answers to it, and keeps it when redrawn.

To restore a saved picture, leave a note such as “Go back to the original image” or “Use the runner from ten versions ago”. Ambition looks through that slide’s versions and restores the saved picture while keeping the latest text and layout. This saves a new version; it does not redraw the picture. If the requested version or picture cannot be identified or read, the change cannot be completed.

Record into Clarity

Open your Clarity on a room screen, then say “Show Record”. The screen says “Ready to record”. Say “Start recording” to begin. A red bar across the top of the screen, a large red “Recording” with a gently pulsing dot and a timer show that recording is active. Your words appear in large type as they are recognized. When you pause for about three seconds, Ambition tidies what you said into one statement, removing ums, repeats and commands such as “Stop recording”, and saves it; “Saved to Clarity” shows under confirmed statements. Problems such as a missing microphone or access show in amber with what to do. Say “Stop recording” to stop adding words and keep the transcript on screen. Say “Start recording” to begin again.

Keep one Clarity on Record at a time. Say “Show the Priorities” to leave, or “Ambition mute” to pause. Opening Record or restarting the room does not start recording; say “Start recording” when ready. The room needs a signed-in owner, a working microphone and capture access approved in Portal. The screen tells you when access or the connection needs attention.

Generate ideas

Ambition can sketch a set of ideas as pictures on one screen. Say “Generate some ideas”, or say how many and where: “Generate five ideas on the left about a mascot for the robotics team.” A panel shows what you asked for, tidied up, and how many ideas it will make. Keep talking to add detail or correct yourself (“no, make it a café”); say “Make it eight” to change the number. Nothing is drawn until you say “Generate” or “Go ahead”. Say “Cancel ideas” to stop.

The gallery appears at once with a short name for each idea, and the pictures fill in over the next ten to twenty seconds. One idea is shown large with its name and a line about it; the others sit along the bottom. Say “Next idea” or “Previous”, an idea’s number (“Idea three”), its name, or both (“Number three, Garden”) to look at another. Say “Redraw” to draw the current picture again, “Close ideas” to put the gallery away and “Show ideas” to bring it back. Ideas works like any other app on its screen: opening something else there (“Open Conveyor”, a Lab project) replaces the gallery, and “Show ideas” switches back to it. When two names sound alike, Ambition numbers the ideas instead, so use the numbers. Each screen can show its own gallery at the same time. With more than one showing, name the screen (“Next idea on the left”), or focus it; otherwise Ambition turns the gallery you used last.

Ideas use OpenAI for clean-up and pictures and Inception for planning the ideas, when the installation has those keys configured. When the pictures are done, Ambition saves the gallery as a new project in your Designer account, named with a short title shown on the gallery (for example “Saved as “Tide Mascots””). Say “Open Tide Mascots” any time later to bring it back as slides; archive the ones you don’t want in Designer.

Try the local screen operator

The reboot trial opens a separate local operator with disposable Designer content. Ask your developer to start the predictive local trial and give you its local address. Add a logical screen, assign the offered project, and wait for Presentation and Agenda to be ready. Select a view for manual navigation. For voice, use the single Room conversation panel, allow microphone access and wait for it to connect. Name the screen you want to control or explicitly set conversational focus.

Try “next page on the left screen,” or request a heading change on a named screen. An accepted edit first enters the app’s journal. Use Refresh app result to see whether its source was saved. When a new snapshot is offered, explicitly adopt it in the intended view; saving alone does not replace the snapshot already shown. Presentation and Agenda retain separate snapshot choices. Voice remains connected when a view is replaced or a saved snapshot is adopted.

The local host restores saved Designer assignments automatically when current app access permits it; you can also reopen them manually. Neutral keeps the local output cleared across restarts. Logical screens begin without a receiver binding; this trial does not pair with a television. These instructions describe the separate local trial.