Alacritty-0.16.1

Introduction to Alacritty

The Alacritty package provides a fast, cross-platform OpenGL terminal emulator.

Alacritty Dependencies

Required

fontconfig, freetype, libxcb, libxkbcommon, rustc, and Xorg Libraries

Optional

scdoc-1.11.4 (to build the man pages)

[Note]

Note

An Internet connection is needed for building this package. The system certificate store may need to be set up with make-ca before building this package.

Installation of Alacritty

Install Alacritty by running the following commands:

cargo build --release

To test the results, issue: cargo test --release.

If you installed scdoc and wish to build the man pages, execute the following commands:

for f in extra/man/*.scd; do
    scdoc < $f > ${f%.*}
done

Now, as the root user:

install -vDm755 target/release/alacritty      -t /usr/bin/                &&
install -vDm644 extra/linux/Alacritty.desktop -t /usr/share/applications/ &&
install -vDm644 extra/logo/alacritty-term.svg /usr/share/icons/hicolor/scalable/apps/Alacritty.svg
[Note]

Note

This package installs desktop files into the /usr/share/applications hierarchy. System performance and memory usage may be improved by updating /usr/share/applications/mimeinfo.cache if you have desktop-file-utils installed. To perform the update, issue the following command as the root user:

update-desktop-database -q

To ensure Alacritty's terminfo is present, run the following command as the root user:

tic -xe alacritty,alacritty-direct extra/alacritty.info

If you wish to install shell completions, execute the relevant commands for your shell(s) as the root user:

install -vDm644 extra/completions/alacritty.bash    /usr/share/bash-completion/completions/alacritty
install -vDm644 extra/completions/_alacritty     -t /usr/share/zsh/site-functions/
install -vDm644 extra/completions/alacritty.fish -t /usr/share/fish/vendor_completions.d/

If you built the man pages, install them as the root user:

install -vDm644 extra/man/*.1 -t /usr/share/man/man1/ &&
install -vDm644 extra/man/*.5 -t /usr/share/man/man5/

If you wish to install the documentation, execute the following as the root user:

install -vDm644 README.md docs/* -t /usr/share/doc/alacritty-0.16.1/

Command Explanations

cargo build --no-default-features --features=x11: This command builds Alacritty without wayland support.

cargo build --no-default-features --features=wayland: This command builds Alacritty without X11 support.

Configuring Alacritty

Config Files

~/.config/alacritty/alacritty.toml. If you wish to configure Alacritty, manually create this file; otherwise, a default configuration will be used. For configuration options, see alacritty(5), or if you built the man pages, run man 5 alacritty.

Contents

Installed Programs: alacritty
Installed Libraries: None
Installed Directories: /usr/share/doc/alacritty-0.16.1

Short Descriptions

alacritty

is a fast, cross-platform OpenGL terminal emulator