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.3 (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:

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

Now, as the root user:

install -vm755 target/release/alacritty /usr/bin/alacritty                      &&
install -vDm755 extra/logo/alacritty-term.svg /usr/share/pixmaps/Alacritty.svg  &&
install -vDm644 extra/linux/Alacritty.desktop -t /usr/share/applications/
[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 /usr/share/zsh/site-functions/_alacritty
install -vDm644 extra/completions/alacritty.fish /usr/share/fish/vendor_completions.d/alacritty.fish

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 docs/* -t /usr/share/doc/alacritty-0.16.1 &&
install -vm644 README.md /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