A banner is your own image placed anywhere on the picture: a sponsor strip, "Follow me @handle", a logo, or a full-frame frame with a transparent hole (plan 186). Banners are free for everyone.
- Import in Assets → Banners: "Import image…" takes a PNG, JPEG or WebP (up to 25 MB and 40 megapixels). Transparency is kept, so a PNG with a transparent background works best. Videorc stores a copy whose longest side is at most 3840 px and applies a photo's rotation. You can keep 24 banners; animated images are refused. A new banner shows at once unless four already show or the running session refuses it; then it stays hidden and the list explains why.
- Sharp sizes, shown in the Assets description: wide banner 2400 × 400, logo 512 × 512, full frame 3840 × 2160. Each is sharp at its default place on a 4K recording.
- Place on the Scene page: drag or resize a banner on the canvas (its shape stays the image's), or use the snaps in its inspector (Top left, Top center, Top right, Bottom left, Bottom center, Bottom right, Full frame). A press anywhere on a banner's picture grabs it, except a banner that fills the canvas (a frame), which is picked by its label or its toolbar chip so the sources under it stay reachable. A drag snaps to the canvas, the sources and the other banners (never to the highlight, captions or avatar zones); Alt drags without snapping. The inspector says how big the banner is drawn on your largest output and warns when your image is too small to stay sharp there ("it will look soft at this size. Use one at least 2304 × 384 px."). With a vertical destination armed, Overlays on: Vertical places the vertical stream's copy separately.
- Show and Hide from the Scene page's Banners section or the inspector,
and while on air from Stream Manager's Banners menu,
/banner <name>or/banner offin the chat composer, ⌘K, a Stream Deck Banner key, the phone remote, or Sidekick ("show the sponsor banner", "hide the banners"). Up to four banners show at once. Show and Hide fade over 200 ms (instant on 4K60 recordings). - Appears in: each banner has Stream and Recording switches, both on by default. They follow the same rules as the highlight card and the avatar (overlays.md); when a session cannot honor both, the Go Live sheet says so ("Recording will include banners while streaming vertical.").
- Timing (in the inspector, folded): Hide after 10 s to 5 min, and Show every 5 to 30 min, which repeats only while you're recording or live ("Shows for 30 s every 15 min"). Showing or hiding a banner by hand always wins and restarts its cycle.
- A banner that is showing stays when you switch scenes and after you restart Videorc. Banners stay over a takeover and under captions, the avatar and the highlight card. Everything can be changed while recording or live except deleting a banner that is showing.
An HTML banner is a banner whose picture is a web page with a transparent background, so it can move: an animated badge, a ticker, a lower third (plan 232). On macOS for now.
- Import in Assets → Banners: "Import HTML…" takes an
.htmlfile, or a folder withindex.htmlbeside its images, fonts, styles and scripts. Videorc keeps its own copy (up to 64 MB, 512 files, 8 folders deep, no links to files outside the folder). A single.htmlfile is copied alone, so a page that needs other files is imported as its folder. - The page's size is 1920 × 1080 unless the page says otherwise with
<meta name="videorc-overlay-size" content="640x360">. The banner keeps that shape wherever you put it, and the page is drawn at exactly the size it has on your picture (up to a 1080p frame), so text stays sharp. - Everything a banner does, it does: Show and Hide from every surface, a place per orientation, opacity, Appears in, the fade, Timing, the order. It counts among the four banners that show at once.
- The network is off. The page loads only the files in its own folder: a font or a script it expects from the internet does not arrive, and the Scene inspector says how many requests were blocked. Put those files in the folder.
- What it cannot do: use the camera, the microphone, the screen or any other permission; open a window or a link; download; reach the app or another banner's files. Its sound is muted.
- Where it draws: on macOS, Windows and Linux, in the Preview, the recording and every stream leg. On Windows and Linux, Import HTML… first asks whether you import a folder or a single file (their file pickers can't take either in one go, as the Mac's does).
- Where it does not draw yet: in a recording Videorc makes without its own compositor, such as 4K60: Show is refused there with "HTML banners can't join this recording. Hide it, or record at 30 fps.", and one that was already showing stays out of that recording and says so in its inspector. The same holds for a Windows screen-only recording that started with no banner showing (it goes straight from the screen to the file).
- A page that never draws (it loaded, but nothing reached Videorc in
10 seconds) is said to have stopped, in the Scene inspector. On Linux in
a Wayland session the sentence also says to start Videorc with
--ozone-platform=x11if that keeps happening: offscreen drawing is the one part of an HTML banner that leans on the desktop session. - Its tile shows the page's own picture a second after it first runs.
The Preview shows the program: a showing banner appears whenever a running output carries it, or either switch is on while nothing runs. That holds in every row, Clips at idle and split record + stream included, where the Preview composes its own picture, the program leg (overlays.md); a clip saved while nothing runs still holds what the recording would (Show in recording).
- Backend table
banners(storage.rs), managed filesBanners/<id>.pngand<id>.thumb.pngbesideScreens; the renderer gets basenames only and shows them throughvideorc-asset://banner/<file>(shared/banner-assets.ts, main'sresolveManagedBannerFile). crates/videorc-backend/src/banners.rs: import (sniff, animated refusal, limits, EXIF, premultiplied Lanczos3 downscale, atomic write, thumbnail), validation,banner_default_places,banner_draw_rect(the one geometry oracle), the leg plan per banner (banner_leg_carries),show_banner(cap, 160 MB prepared-bitmap budget, the after-start refusal) andon_banners_changed, where every mutation ends: install into the compositor, recompose the legacy overlay frame, emitbanners.changed, wake the timers.- RPCs
banners.list | importImage | update | reorder | delete | show | hideand the eventbanners.changed;importImageruns on theAssetImportlane,showandhideonLiveControl. Strict schemas inshared/backend-rpc-contract.ts; the wire example isprotocol-fixtures/high-risk-contracts.json→banner. - Geometry is pinned by
protocol-fixtures/banner-geometry.json, which Rust (banner_draw_rect) and TS (shared/banner-geometry.ts,bannerDrawRect) both reproduce exactly.
CompositorRuntime.bannersis oneArc<BannerSet>at snapshot level, shared by the idle preview and both legs;install_banner_setswaps it and touches nothing else.banner_draws_for_legderives each leg's draws per tick (leg plan, 200 ms ease-out fade, prepared bitmap).banner_prepare.rs: off-thread prepare to the exact contained pixel size per canvas, opacity baked, BGRA, in a 160 MB LRU cache; until a prepare lands the last bitmap is drawn.- Metal: blended quads from key-addressed textures in namespace 9 (four
slots), uploaded once per prepare (
push_banner_gpu_sources). CPU:composite_banners, a true straight-alpha 1:1 blend. Windows D3D11 media session: image layers at z 6 to 9 (windows_d3d11_session.rs). Legacy FFmpeg graph (4K60, bridge off): banners composed into the takeover's full-canvas RGBA FIFO frame (legacy_overlay_frame); a session without that FIFO, or the direct D3D11 recording, refuses a banner shown after it starts. Electron proof surface (Windows idle and Linux previews):main/preview-surface-banners.ts. - Z order on every path: scene, takeover, banners, captions, the avatar, highlight card.
- Scene editor drafts with the stage id
banner:<id>move the banner's picture live on the idle macOS preview: on the live canvas, and in the floating preview while a drag runs. The schematic canvas (the preview floating, Windows, Linux) draws the banner's own image in its rect, so a drag there shows the picture moving too.
- Renderer state:
useStudioBanners()(hooks/use-studio.tsx), refusal copy inlib/banners.ts, Assets sectioncomponents/banners-section.tsx, Scenecomponents/scene/banner-inspector.tsx, size advicelib/banner-size.ts, snapslib/banner-place.ts, Go Live sentenceslib/banner-start-notices.ts(Rust twin:overlay_start_notices), timinglib/banner-timing.ts. - Stream Manager relays through main (
comments-window:banner*); the composer grammar isshared/banner-commands.ts; ⌘K's Banners group is incomponents/command-palette.tsx. - Remote intents
bannerShow,bannerHide,bannerTogglewithdescribe.banners(remote-control.md); the phone and the Stream Deck use them. - Timers:
banner_timers.rs(a pure book plus one process task woken by every banner change). - Voice:
cohost_command.rs, banner phrases parsed before the highlight grammar (buddy-commands-contract.md).
Code and wire names say html overlay; copy says HTML banner.
- Store: a
bannersrow withkind = 'html'(the wire omitskindfor an image).widthandheightare the page size. The page lives inBanners/<id>.overlay/;<id>.pngand<id>.thumb.pngare its own picture, saved by the backend a second after its first frame. Import:html_overlay::import_html_overlayon the AssetImport lane, from aninput-fileorinput-directorycapability. - Rendering: Electron main,
main/html-overlay-host.ts: one offscreen window per showing banner, in its own in-memory session. Every rule is a pure function inmain/html-overlay-policy.ts: sandbox, context isolation, no Node, no preload; requests only to its ownvideorc-overlay://<id>/scheme (handled only in that session),data:andblob:; no navigation away, no windows, no downloads, every permission refused; the session's only proxy is a closed port and WebRTC may not use UDP. Never give that window a preload or a way to message the app. - Targets: the backend decides what main renders.
htmlOverlays.targetscarries, per banner, the page size, the frame size (its contained draw size on the largest canvas that carries it, at most 2,073,600 px) and the rate (the compositor's, at most 30). Main sizes the window asframe ÷ display scaleDIP with a zoom offrame ÷ (scale × page), so the page lays out at its own size and paints the frame's pixels. - Frames:
POST /html-overlays/frames?token=<admin>, one long-lived chunked upload of records (a 40-byte header pinned byprotocol-fixtures/html-overlay-frame.json, then premultiplied BGRA). Latest wins on both sides: main drops a frame while the socket still holds the last one, and the backend keeps one frame per banner. The backend converts to straight alpha on the upload task (html_overlay::append_straight_alpha), never on the render thread. - Drawing:
banner_draws_for_legreturns the latest frame for an HTML banner, so it rides the banner layer on the primary leg, the auxiliary leg and the Preview's program leg under the same leg plan. On Metal the keyed slot reuses its texture and uploads once per new frame. The CPU path blits 1:1 and scales a frame made for another canvas nearest neighbour. The legacy FFmpeg frame, the Windows D3D11 session and the Electron proof surface never draw one. - Status: main reports
loading,liveorfailedfor each page (htmlOverlays.host.report, admin role only); the backend publisheshtmlOverlays.status(alsounavailable, for a session that cannot draw one).htmlOverlays.statscounts frames, bytes and conversion time.
cargo test -p videorc-backend banner(store, import, geometry, leg plan, fade, budget, timers, legacy frame, D3D11 layer geometry),cpu_and_metal_draw_the_same_bannerandmetal_uploads_a_banner_once_across_120_ticks(Metal-gated, run on a Mac), and the TS tests beside each file above.pnpm smoke:bannersdrives the dev app through recordings and a local stream with banners shown, moved and hidden, and checks the pixels in the artifacts; it is part ofpnpm smoke:recording-studio.- HTML banners:
cargo test -p videorc-backend html_overlay,main/html-overlay-policy.test.ts,main/html-overlay-frames.test.ts, andpnpm smoke:html-overlay(the fixture inscripts/fixtures/html-overlay/animated-badge/, recorded, streamed and both at once, read back from every artifact); also part ofpnpm smoke:recording-studio.