wezterm/docs/config/lua/keyassignment/PasteFrom.md

# PasteFrom(source)

Paste the specified clipboard to the current pane.

This is only really meaningful on X11 and some Wayland systems that have multiple clipboards.

Possible values for source are:

* `Clipboard` - paste from the system clipboard
* `PrimarySelection` - paste from the primary selection buffer

See also [Paste](Paste.md).

```lua
local wezterm = require 'wezterm'
local act = wezterm.action

return {
  keys = {
    -- paste from the clipboard
    {key="V", mods="CTRL", action=act.PasteFrom("Clipboard")},

    -- paste from the primary selection
    {key="V", mods="CTRL", action=act.PasteFrom("PrimarySelection")},
  },
}
```

*Since: 20220319-142410-0fcdea07*

`PrimarySelection` is now also supported on Wayland systems that support [primary-selection-unstable-v1](https://wayland.app/protocols/primary-selection-unstable-v1) or the older Gtk primary selection protocol.
more configuration options for Copy/Paste * Adds `CopyTo` and `PasteFrom` assignments that specify the destination/source. * Adds `default_clipboard_copy_destination` and `default_paste_source` config options that specify the default destination/source for existing `Copy` and `Paste` operations (for @bew) * Deprecating `PastePrimarySelection` in favor of `PasteFrom`. * Added `CTRL-Insert` -> `Copy` (for @Babar) Aside from the new key assignment, these changes shouldn't change the default behavior, but do make it easier to consider changing that in a later commit. They should allow for example: * Set `default_clipboard_copy_destination = "PrimarySelection"` to prevent populating the clipboard by default when using the mouse. * Overriding the CTRL-Insert, CTRL-SHIFT-C to explicitly populate the clipboard * Set `default_paste_source = "PrimarySelection"` for middle click to paste the selection. * Overriding SHIFT-Insert, CTRL-SHIFT-V to explicitly paste from the clipboard. refs: #417 2021-01-27 19:43:59 +03:00			`# PasteFrom(source)`

			`Paste the specified clipboard to the current pane.`

Support primary selection on Wayland Closes #1423 2022-03-10 00:40:22 +03:00			`This is only really meaningful on X11 and some Wayland systems that have multiple clipboards.`
more configuration options for Copy/Paste * Adds `CopyTo` and `PasteFrom` assignments that specify the destination/source. * Adds `default_clipboard_copy_destination` and `default_paste_source` config options that specify the default destination/source for existing `Copy` and `Paste` operations (for @bew) * Deprecating `PastePrimarySelection` in favor of `PasteFrom`. * Added `CTRL-Insert` -> `Copy` (for @Babar) Aside from the new key assignment, these changes shouldn't change the default behavior, but do make it easier to consider changing that in a later commit. They should allow for example: * Set `default_clipboard_copy_destination = "PrimarySelection"` to prevent populating the clipboard by default when using the mouse. * Overriding the CTRL-Insert, CTRL-SHIFT-C to explicitly populate the clipboard * Set `default_paste_source = "PrimarySelection"` for middle click to paste the selection. * Overriding SHIFT-Insert, CTRL-SHIFT-V to explicitly paste from the clipboard. refs: #417 2021-01-27 19:43:59 +03:00
			`Possible values for source are:`

			* `Clipboard` - paste from the system clipboard
			* `PrimarySelection` - paste from the primary selection buffer

			`See also [Paste](Paste.md).`

			```lua
docs: update keyassignment reference for more ergnomic wezterm.action syntax 2022-06-25 16:58:10 +03:00			`local wezterm = require 'wezterm'`
			`local act = wezterm.action`

more configuration options for Copy/Paste * Adds `CopyTo` and `PasteFrom` assignments that specify the destination/source. * Adds `default_clipboard_copy_destination` and `default_paste_source` config options that specify the default destination/source for existing `Copy` and `Paste` operations (for @bew) * Deprecating `PastePrimarySelection` in favor of `PasteFrom`. * Added `CTRL-Insert` -> `Copy` (for @Babar) Aside from the new key assignment, these changes shouldn't change the default behavior, but do make it easier to consider changing that in a later commit. They should allow for example: * Set `default_clipboard_copy_destination = "PrimarySelection"` to prevent populating the clipboard by default when using the mouse. * Overriding the CTRL-Insert, CTRL-SHIFT-C to explicitly populate the clipboard * Set `default_paste_source = "PrimarySelection"` for middle click to paste the selection. * Overriding SHIFT-Insert, CTRL-SHIFT-V to explicitly paste from the clipboard. refs: #417 2021-01-27 19:43:59 +03:00			`return {`
			`keys = {`
			`-- paste from the clipboard`
docs: update keyassignment reference for more ergnomic wezterm.action syntax 2022-06-25 16:58:10 +03:00			`{key="V", mods="CTRL", action=act.PasteFrom("Clipboard")},`
more configuration options for Copy/Paste * Adds `CopyTo` and `PasteFrom` assignments that specify the destination/source. * Adds `default_clipboard_copy_destination` and `default_paste_source` config options that specify the default destination/source for existing `Copy` and `Paste` operations (for @bew) * Deprecating `PastePrimarySelection` in favor of `PasteFrom`. * Added `CTRL-Insert` -> `Copy` (for @Babar) Aside from the new key assignment, these changes shouldn't change the default behavior, but do make it easier to consider changing that in a later commit. They should allow for example: * Set `default_clipboard_copy_destination = "PrimarySelection"` to prevent populating the clipboard by default when using the mouse. * Overriding the CTRL-Insert, CTRL-SHIFT-C to explicitly populate the clipboard * Set `default_paste_source = "PrimarySelection"` for middle click to paste the selection. * Overriding SHIFT-Insert, CTRL-SHIFT-V to explicitly paste from the clipboard. refs: #417 2021-01-27 19:43:59 +03:00
			`-- paste from the primary selection`
docs: update keyassignment reference for more ergnomic wezterm.action syntax 2022-06-25 16:58:10 +03:00			`{key="V", mods="CTRL", action=act.PasteFrom("PrimarySelection")},`
more configuration options for Copy/Paste * Adds `CopyTo` and `PasteFrom` assignments that specify the destination/source. * Adds `default_clipboard_copy_destination` and `default_paste_source` config options that specify the default destination/source for existing `Copy` and `Paste` operations (for @bew) * Deprecating `PastePrimarySelection` in favor of `PasteFrom`. * Added `CTRL-Insert` -> `Copy` (for @Babar) Aside from the new key assignment, these changes shouldn't change the default behavior, but do make it easier to consider changing that in a later commit. They should allow for example: * Set `default_clipboard_copy_destination = "PrimarySelection"` to prevent populating the clipboard by default when using the mouse. * Overriding the CTRL-Insert, CTRL-SHIFT-C to explicitly populate the clipboard * Set `default_paste_source = "PrimarySelection"` for middle click to paste the selection. * Overriding SHIFT-Insert, CTRL-SHIFT-V to explicitly paste from the clipboard. refs: #417 2021-01-27 19:43:59 +03:00			`},`
			`}`
			```

docs: update for 20220319-142410-0fcdea07 2022-03-20 02:37:27 +03:00			`Since: 20220319-142410-0fcdea07`
Support primary selection on Wayland Closes #1423 2022-03-10 00:40:22 +03:00
			`PrimarySelection` is now also supported on Wayland systems that support [primary-selection-unstable-v1](https://wayland.app/protocols/primary-selection-unstable-v1) or the older Gtk primary selection protocol.