Omniscio

The video player

The one player every Omniscio video — and every audio clip on a share page — plays in: in the app, on a shared link, on the page other websites embed, for films drawn live by code, and for an .mp3 or .wav published on its own. Covers its controls, the Repeat button, the slim audio layout, keyboard shortcuts, full screen, phones, and what happens to links shared before it existed.

On this page

What it is

Omniscio has one player, and every video plays in it. Whether you are watching a video in the app, opening a shared link in a browser, looking at a video embedded on another website, or watching a film an agent drew live with code, you get the same controls in the same places and the same keyboard shortcuts. An audio clip on a share page plays in that same player too, in a slimmer bar made for sound.

The controls are always the normal ones you expect from a video: play and pause, a bar you can drag to jump around, the time, volume, a speed menu, a Repeat button, captions, picture-in-picture, download and full screen. If the player ever fails to start for some reason, the browser's own built-in controls stay in place instead, so a video can always be played.

Where to find it

It appears wherever a video or a share-page audio clip plays:

  • In the app — a video in your daily drip feed, a video opened in a chat or gallery lightbox, a screen recording you are reviewing, a Telegram video message, and the video preview on an inbox card.
  • On a shared link — the page a shared screen recording opens on, in any browser, on a computer or a phone.
  • On an embedded video — the small player other websites (and the inbox card) show for a shared video.
  • On a live film — a film an agent builds by drawing each frame with code rather than recording a file.
  • On a share page that contains an audio clip — every clip the page shows a play bar for plays in the player; an .mp3 or .wav shared on its own opens as a page with one clip in it.

How it behaves

The controls

  • A large play button sits in the middle of the video until it starts.
  • The bar along the bottom holds every control: the Omniscio mark, play/pause, volume, the time (for example 0:12 / 1:30), Repeat, captions, picture-in-picture, download, the speed, and full screen. Buttons only appear when they do something — captions only when the video has captions, download only when the video offers a file.
  • The Repeat button loops the video: it starts OFF, so a video ends exactly as it always did until you turn repeat on. See Repeat below.
  • The speed control is in that bar, beside full screen, with speeds from half speed to triple speed. Inside the app the speed you pick is remembered for the next video; see Video playback speed.
  • The Omniscio mark — the brand orb — begins the bar. It is decoration, not a button: it does nothing when clicked and is invisible to a screen reader, and on a very small player it steps aside so the controls keep their room. On a phone it is drawn at the size of the icons beside it, and on a bar with no room to spare it gives way rather than pushing a control to the edge.
  • Clicking the picture plays or pauses; double-clicking it goes full screen.
  • While the video plays and you are not touching it, the bar fades away after about two and a half seconds. Moving the mouse brings it back, and moving the mouse off the video hides it straight away. It never hides while the video is paused, while the mouse rests on the controls, while you are dragging the bar, or while the speed menu is open.
  • Tab moves from control to control, and the one you are on is outlined.
  • Full screen takes the whole player, so the bar and every control on it come along, and the video fills the screen. A labelled Exit full screen pill also sits in the top-right corner for as long as you are full screen, and it does not fade with the bar — so the way out is still on screen after the controls have gone. On a website that shows the video in a frame without allowing full screen, the browser refuses it there, so the button is left out rather than shown doing nothing. On Omniscio's own inbox cards and on a shared recording's page, full screen always works.

Keyboard shortcuts

Click the video, press its play button, or tab to it first — the keys only act while the player has focus, and they never also trigger one of the app's own shortcuts.

Key What it does
Space or K Play / pause
J / L Back / forward 10 seconds
← / → Back / forward 5 seconds
↑ / ↓ Volume up / down
M Mute / unmute
F Full screen
C Captions on / off
R Repeat on / off
Shift + > / Shift + < Faster / slower
0 – 9 Jump to that tenth of the video (0 is the start, 5 is halfway)
Home / End Jump to the start / the end
Esc Close the open menu (speed or More), or leave full screen when no menu is open

Each button's tooltip shows its key, and the keys listed there always work. When the volume slider is the control you are on, the arrow keys and Home / End change the volume instead; everywhere else in the player they move through the video.

Repeat

  • Every player has a Repeat button in its bar, and it starts off. With it off, a video — or an audio clip — ends exactly as it does today.
  • Click it or press R and the icon lights up in your theme colour. From then on the video starts over by itself each time it reaches the end, until you turn repeat off or close the player.
  • The button's tooltip says "Turn repeat on" or "Turn repeat off" and shows the R key, and a screen reader hears whether it is on.
  • Your choice is not remembered. Every video and every clip opens with repeat off, so a video you left looping yesterday does not loop today.
  • When the player closes, the video's own repeat setting is put back exactly the way it was found — nothing about the page is left changed.

Audio clips on a share page

  • An agent's share page can contain audio clips (an MP3 or WAV built into the page, like a voice audition). Each clip that shows a play bar plays in the same Omniscio player as every video, in a slim bar: play, seek, the time, volume, Repeat, download and speed — and none of the controls that need a picture (captions, picture-in-picture, full screen).
  • The clip keeps its own place and its width in the page, so an upgraded page looks like the agent designed it.
  • A clip with no play bar — a hidden background sound the page plays by itself — is left exactly alone.
  • If the player cannot load for any reason, the clip falls back to the browser's own audio bar and still plays.

Publishing an audio file on its own

  • Share an .mp3 or .wav file and you get a clean page with one clip in it, playing in the official player, with the same Repeat button.
  • Audio files can be up to 18 MB — the same limit as a PDF, because the clip is carried inside the page. That is well over fifteen minutes of MP3 but under two minutes of WAV, so a file that is too big is refused with a message suggesting MP3.

Phones

  • Videos play inside the page on a phone instead of jumping to the phone's own full-screen player.
  • A tap on the picture shows or hides the controls; it does not pause the video. Use the play button to pause.
  • The buttons are made for a thumb — about 48 pixels square, with a large icon and a big time display — and the bar keeps clear of the phone's own home bar and rounded corners, including in full screen. Every control size and glyph in the row, the Omniscio mark included, is multiplied by the same touch scale, so a phone showing a page laid out wide (a shared link inside a frame, or "desktop site" mode) gets a mark the size of its icons instead of a speck. The row's own gaps are not multiplied, which is why the phone layout reads tighter than the desktop one.
  • It applies to any phone-sized touch screen, so a phone showing a page in "desktop site" mode still gets the thumb-sized controls rather than tiny ones.
  • The pop-up lists are made for a thumb too. The speed menu and the More list take the same touch scale as the bar: their width, their row heights, their labels and the mark beside the chosen speed all grow with the phone, so a menu is always wider than the button that opened it. A list that does not fit above the button scrolls inside the player instead of hanging off its edge, and it re-measures itself if the player is resized or the phone is turned while it is open.
  • The controls that are not needed constantly (mute, Repeat, captions, picture-in-picture, download) move into a More button's pop-up when the bar gets too narrow to hold them all. Each row has its name beside it and is big enough to tap; the list scrolls inside the player if the player is short.
  • In full screen the controls fade after under two seconds of not touching the screen, and any tap brings them back immediately. The Exit full screen pill in the corner stays put the whole time and is a full thumb target, so leaving never depends on catching the bar while it is showing.
  • On an iPhone, full screen hands the video to Safari's own full-screen player (an iPhone has no full screen for anything but the video itself); an iPad keeps the whole player.
  • A shared video streams from a link that only stays valid for a short while, so a page left open a long time — a paused tab, or a share the app quietly preloaded for you — can outlive it.
  • When that happens the player fetches a fresh link by itself and carries on from the same moment, so the video never freezes a few seconds in. A paused video comes back paused.
  • If the video truly cannot be reached any more (the share was revoked or deleted), it stops after a few tries and shows the error instead of retrying forever.
  • This needs the new player, so a link shared before this change still freezes once its link runs out; reloading the page, or sharing the video again, fixes it.

Remaining gaps

  • Links shared before the one player existed keep their old page. A shared recording page is built at the moment it is shared, so an older link still shows the player it was published with. Sharing a recording again gives it the new player; a video file an agent published is refreshed on its same link with POST /share/refresh-video-pages (see Share via CLI — POST /share/refresh-video-pages).
  • A share published before Repeat existed has no Repeat button. The page, and the audio clips inside it, are rewritten when the page is published again or, for a video file, when it is refreshed on its same link — including your voice and sound audition pages, which keep the browser's own audio bar until an agent republishes them.
  • A shared link opened in a browser starts at the speed last picked on a share page in that browser (1× the first time) — that is separate from the speed you pick in the app, because a public page cannot read your Omniscio settings. A bare video link with no share page around it, and the embed page, start at 1×.

Video playback speed covers the speed menu and how the chosen speed is remembered. Shared recording rich previews covers the preview card and embeddable player a shared recording gets when its link is pasted elsewhere. Opening a media link covers what happens when an agent's message links to a video file.

Last verified 2026-10-26