urxvt-scripts

September 8, 2018 · View on GitHub

A small collection of perl extensions for the rxvt-unicode terminal emulator.

Installation

Place the scripts you want to install in $HOME/.urxvt/ext/ folder.

See the following sections for information on how to enable the scripts or set script-specific options and keyboard mappings in your ~/.Xresources.

font-size

Author: Jan Larres
License: MIT License
URL: https://github.com/majutsushi/urxvt-font-size
Based on:

Change the font size on the fly with keyboard shortcuts. It has the following features:

  • Supports both xft and X11 fonts; X11 fonts work in both full form and as aliases.
  • Supports all four font settings: font, boldFont, italicFont and boldItalicFont and changes them in accordance with the base font (the first one from font).
  • Can apply the font change globally for the whole server, so that new terminals will inherit the same size, and even save it to ~/.Xresources to be able to survive a reboot.
  • Should work even with complicated font setups like the example in the urxvt man-page.

After installing, enable the extension by adding the following line in your ~/.Xresources:

URxvt.perl-ext-common: ...,font-size

Then add some keybindings:

URxvt.keysym.C-Up:     font-size:increase
URxvt.keysym.C-Down:   font-size:decrease
URxvt.keysym.C-S-Up:   font-size:incglobal
URxvt.keysym.C-S-Down: font-size:decglobal
URxvt.keysym.C-equal:  font-size:reset
URxvt.keysym.C-slash:  font-size:show

Note that for urxvt versions older than 9.21 the resources have to look like this:

URxvt.keysym.C-Up:     perl:font-size:increase
URxvt.keysym.C-Down:   perl:font-size:decrease
URxvt.keysym.C-S-Up:   perl:font-size:incglobal
URxvt.keysym.C-S-Down: perl:font-size:decglobal
URxvt.keysym.C-equal:  perl:font-size:reset
URxvt.keysym.C-slash:  perl:font-size:show

The following functions are supported:

  • increase/decrease: Increase or decrease the font size of the current terminal.
  • incglobal/decglobal: Same as above and also adjust the X server values so all newly started terminals will use the same fontsize.
  • incsave/decsave: Same as incglobal/decglobal and also modify the ~/.Xresources file so the changed font sizes will persist over a restart of the X server or a reboot.
  • reset: Reset the font size to the value of the resource when starting the terminal.
  • show: Show the current value of the font resource in a popup.

You can also change the step size that the script will use to increase the font size:

URxvt.font-size.step: 4

The default step size is 1. This means that with this setting a size change sequence would be for example 8->12->16->20 instead of 8->9->10->11->12 etc. Please note that many X11 fonts are only available in specific sizes, though, and odd sizes are often not available, resulting in an effective step size of 2 instead of 1 in that case.

Troubleshooting

At its core font-size is just a fancy wrapper around the ESC ] 710;Pt ST (and 711/712/713 for bold, italic, and bold-italic) escape sequences. So if you are having trouble with this script please try the escape sequence directly like this (outside of a terminal multiplexer like screen or tmux):

$ echo -e "\033]710;fixed\033\\"

You can exchange fixed for any (single) font that you want to try, like for example -xos4-terminus-medium-r-normal--12-120-72-72-c-60-iso10646-1:

$ echo -e "\033]710;-xos4-terminus-medium-r-normal--12-120-72-72-c-60-iso10646-1\033\\"

If you can reproduce the problem this way then the problem does not lie with the font-size script, but either directly with urxvt or some other component that may interfere (like for example a window manager). Please report the bug to those projects in that case.

fullscreen

Author: Christopher Luna
License: GPLv3
URL: https://aur.archlinux.org/packages/urxvt-fullscreen

Use keyboard shortcut to toggle fullscreen.

After installing, enable the extension by adding the following line in your ~/.Xresources:

URxvt.perl-ext-common: ...,fullscreen

Then add a keybinding:

URxvt.keysym.F11: perl:fullscreen:switch

keyboard-select

Author: Bert Muennich
License: GPLv2
URL: http://www.github.com/muennich/urxvt-perls

Use keyboard shortcuts to select and copy text.

After installing, enable the extension by adding the following line in your ~/.Xresources:

URxvt.perl-ext-common: ...,keyboard-select

Then add some keybindings:

URxvt.keysym.M-Escape: perl:keyboard-select:activate

The following line overwrites the default Meta-s binding and allows to activate keyboard-select directly in backward search mode:

URxvt.keysym.M-s: perl:keyboard-select:search

Use Meta-Escape to activate selection mode, then use the following keys:

  • h/j/k/l: Move cursor left/down/up/right (also with arrow keys)
  • g/G/0/^/$/H/M/L/f/F/;/,/w/W/b/B/e/E: More vi-like cursor movement keys
  • //?: Start forward/backward search
  • n/N: Repeat last search, N: in reverse direction
  • Ctrl-f/b: Scroll down/up one screen
  • Ctrl-d/u: Scroll down/up half a screen
  • v/V/Ctrl-v: Toggle normal/linewise/blockwise selection
  • y/Return: Copy selection to primary buffer, Return: quit afterwards
  • Y: Copy selected lines to primary buffer or cursor line and quit
  • q/Escape: Quit keyboard selection mode

Options:

URxvt.keyboard-select.clipboard: If true, copy to clipboard too

vtwheel

Author: PyroPeter
License: Unknown
URL: https://aur.archlinux.org/packages/urxvt-vtwheel

Scroll wheel support.

After installing, enable the extension by adding the following line in your ~/.Xresources:

URxvt.perl-ext-common: ...,vtwheel