rb.clipboard

rb.clipboard reads the text on the clipboard and puts new text on it. A script reaches for it to work on text the user copied, or to paste long or multi-line text: setting the clipboard and sending the paste chord is more reliable than typing. Needs: the clipboard:read permission for get and clipboard:write for set in a script that declares permissions. This script trims the whitespace around the copied text and puts the result back on the clipboard:

-- rebind: min_sdk=3.9.0 name=example version=1.0.0 permissions=clipboard:read,clipboard:write
local text = rb.clipboard.get()
if text == nil then
  print("the clipboard holds no text")
  return
end

local trimmed = (text:gsub("^%s+", ""):gsub("%s+$", ""))
rb.clipboard.set(trimmed)
print("trimmed the clipboard to", #trimmed, "characters")

Signature	Returns
`rb.clipboard.get() -> string?`	the clipboard text, or `nil` when it holds no text
`rb.clipboard.set(text: string) -> ()`

A denied call raises Clipboard.Get() requires 'clipboard:read' permission (or Set and write).

Overview

Script basics

Input and output

Timing and script control

Panels, overlays and dialogs

Screen, windows and apps

Operating system

Files and data

Network and pipes

Rebind Pro

Lookup