---
name: "urxvt-eval"
section: "1"
platform: "linux"
package: "rxvt-unicode"
version: "9.31-11"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/urxvt-eval"
---

# urxvt-eval(1)

evaluate arbitrary perl code using actions

## NAME

eval - evaluate arbitrary perl code using actions

## EXAMPLES

```
  URxvt.keysym.M-c: eval:selection_to_clipboard
  URxvt.keysym.M-v: eval:paste_clipboard
  URxvt.keysym.M-V: eval:paste_primary
  URxvt.keysym.M-Up: eval:scroll_up 1
  URxvt.keysym.M-Down: eval:scroll_down 1
  URxvt.keysym.M-Home: eval:scroll_to_top
  URxvt.keysym.M-End:  eval:scroll_to_bottom
```

## DESCRIPTION

Add support for evaluating arbitrary perl code using actions in keysym resources. If a keysym *action* takes the form `"eval:STRING"`, the specified **STRING** is evaluated as a Perl expression. While the full urxvt API is available, the following methods are also provided for users' convenience, as they implement basic actions:

- scroll\_up $count

  - scroll\_up\_pages $count

  - scroll\_down $count

  - scroll\_down\_pages $count

  Scroll up or down by `$count` lines or pages.

- scroll\_to\_top

  - scroll\_to\_bottom

  Scroll to the top or bottom of the scrollback.

- selection\_to\_clipboard

  Copy the selection to the CLIPBOARD.

- paste\_primary

  - paste\_clipboard

  Paste the value of the PRIMARY or CLIPBOARD selection.
