VTX 1 · core · beta draft d03
VTX 1 Wire Specification: core
§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.writepermission first. This blocks silent clipboard replacement. - Reads. A READ always requires
clipboard.readpermission. If the user declines, the client answers DENIED. - Media types. Only types accepted in the
clipboardcapability are used.text/plain;charset=utf-8is always supported. - Large items. An item larger than
max_frameis split. The first frame carries the item with the first part of its data; each following frame carries one item with the samemime, whose data is appended. Every frame but the last carriesmore: 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.