vtx.foundation draft d03

VTX 1 · core · beta draft d03

VTX 1 Wire Specification: core

Oct 11, 2026, revised Nov 16, 202639 pagesALPN vtx1-d03MIT licence

§13Clipboard

The clipboard channel lets an application copy to and, with permission, read from the user's clipboard. User pastes do not use it; they arrive as PASTE input (Section 11).

Type Name Direction Payload
0x10 WRITE S→C { items, ? more }
0x11 READ S→C { id, mimes }
0x12 DATA C→S { id, items, ? more }
0x13 DENIED C→S { id }

An item is { mime, data } with data as bytes.

  • Writes. The client applies a WRITE without asking only within 1 second of a user activation: an intent the user triggered, a key press or a pointer down. Pointer moves, releases and key repeats do not count, and one activation allows one write. Otherwise the client asks for clipboard.write permission first. This blocks silent clipboard replacement.
  • Reads. A READ always requires clipboard.read permission. If the user declines, the client answers DENIED.
  • Media types. Only types accepted in the clipboard capability are used. text/plain;charset=utf-8 is always supported.
  • Large items. An item larger than max_frame is split. The first frame carries the item with the first part of its data; each following frame carries one item with the same mime, whose data is appended. Every frame but the last carries more: true.

Size. No clipboard item may exceed the client's max_clip (default 1 MiB), in either direction. The server sends no larger item. A client answers a READ with only the items that fit, or DENIED when none do.