rxvt-unicode-9.31

#### Beyond Linux® From Scratch (System V Edition) - Version r13.1-84

### Chapter 41. Other X-based Programs

- Prev

  Inkscape-1.4.4

- Next

  Thunderbird-153.2.0esr

- Up
- Home

# rxvt-unicode-9.31

## Introduction to rxvt-unicode

rxvt-unicode is a clone of the terminal emulator rxvt, an X Window System terminal emulator which includes support for XFT and Unicode.

### Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

### Note

Please be aware that rxvt-unicode is affected by an issue in perl where the SIGFPE handler is set to SIG_IGN (i.e. the signal is ignored). If you are building an LFS system from within urxvt and running the test suites, tests in bash which test raising this signal will fail.

### Package Information

- Download (HTTP): http://dist.schmorp.de/rxvt-unicode/Attic/rxvt-unicode-9.31.tar.bz2

- Download MD5 sum: 3d0ec83705c9b9ff301a4b9965b3cd9f

- Download size: 860 KB

- Estimated disk space required: 22 MB

- Estimated build time: 0.2 SBU

### rxvt-unicode Dependencies

#### Required

libptytty-2.0 and a graphical environment

#### Optional

gdk-pixbuf-2.44.7 (for background images) and startup-notification-0.12

## Installation of rxvt-unicode

First, remove a function that conflicts with C++23 definitions:

    sed '/interpolation/,+7d' -i src/rxvtutil.h

Install rxvt-unicode by running the following commands:

    ./configure --prefix=/usr --enable-everything &&
    make

This package does not come with a test suite.

Now, as the `root` user:

    make install

## Command Explanations

`--enable-everything`: Add support for all non-multichoice options. Details about the different options can be found in the file `README.configure`.

`--disable-xft`: Remove support for Xft fonts.

`--disable-perl`: Disable the embedded Perl interpreter.

`--disable-afterimage`: Remove support for libAfterImage.

## Configuring rxvt-unicode

The rxvt-unicode terminal emulator uses the resource class `URxvt` and the resource name `urxvt`. You can add X resource definitions to a user's `~/.Xresources` or `~/.Xdefaults` files or to the system-wide `/etc/X11/app-defaults/URxvt` file. The following example will load the `matcher` Perl extension (assuming Perl support wasn't disabled), which enables a left button click to open an underlined URL in the specified browser, sets a background and foreground color and loads an Xft font (as the `root` user):

    cat >> /etc/X11/app-defaults/URxvt << "EOF"
    ! Use the specified colour as the windows background colour [default white]
    URxvt*background: black

    ! Use the specified colour as the windows foreground colour [default black]
    URxvt*foreground: yellow

    ! Select the fonts to be used. This is a comma separated list of font names
    URxvt*font: xft:Monospace:pixelsize=18

    ! Comma-separated list(s) of perl extension scripts (default: "default")
    URxvt*perl-ext: matcher

    ! Specifies the program to be started with a URL argument. Used by
    URxvt*url-launcher: firefox

    ! When clicked with the mouse button specified in the "matcher.button" resource
    ! (default 2, or middle), the program specified in the "matcher.launcher"
    ! resource (default, the "url-launcher" resource, "sensible-browser") will be
    ! started with the matched text as first argument.
    ! Below, default modified to mouse left button.
    URxvt*matcher.button:     1
    EOF

In order to view the defined X resources, issue:

    xrdb -query

In order to add the modifications of the new user configuration file, keeping previously X configurations (of course, unless you are changing any on previously define), issue:

    xrdb -merge ~/.Xresources

The rxvt-unicode application can also run in a daemon mode, which makes it possible to open multiple terminal windows within the same process. The urxvtc client then connects to the urxvtd daemon and requests a new terminal window. Use this option with caution. If the daemon crashes, all the running processes in the terminal windows are terminated.

You can start the urxvtd daemon in the system or personal startup X session script (e.g., `~/.xinitrc`) by adding the following lines near the top of the script:

    # Start the urxvtd daemon
    urxvtd -q -f -o &

For more information, examine the urxvt, urxvtd, urxvtc, and `urxvtperl` man pages.

If you use a Desktop Environment, a menu entry can be included, issuing, as the `root` user:

    cat > /usr/share/applications/urxvt.desktop << "EOF" &&
    [Desktop Entry]
    Encoding=UTF-8
    Name=Rxvt-Unicode Terminal
    Comment=Use the command line
    GenericName=Terminal
    Exec=urxvt
    Terminal=false
    Type=Application
    Icon=utilities-terminal
    Categories=GTK;Utility;TerminalEmulator;
    #StartupNotify=true
    Keywords=console;command line;execute;
    EOF

    update-desktop-database -q

For that, you need desktop-file-utils-0.28 and at least one of gnome-icon-theme-3.12.0, oxygen-icons-6.29.0 and lxde-icon-theme-0.5.1. Uncomment the line with “StartupNotify=true” if startup-notification-0.12 is installed.

## Contents

Installed Programs: urxvt, urxvtd, and urxvtc
Installed Libraries: Many Perl extensions located under `/usr/lib/urxvt/perl`
Installed Directory: /usr/lib/urxvt

### Short Descriptions

urxvt | is a terminal emulator for the X Window System
urxvtd | is the urxvt terminal daemon
urxvtc | controls the urxvtd daemon

- Prev

  Inkscape-1.4.4

- Next

  Thunderbird-153.2.0esr

- Up
- Home