A cross-platform, OpenGL terminal emulator.
Go to file
Christian Duerr d387ebe1d7
Add hidden escape sequence
This adds support for the `hidden` escape sequence `\e[8m`, which will
render the text as invisible.

This has also raised a few questions about the rendering of foreground
and background colors and their interaction with the different escape
sequences. Previously, Alacritty has oriented itself after URxvt, which
has some strange and unexpected behavior.

The new implementation of color inversion is modeled after XTerm, which
has a consistent pattern of always inverting the foreground and
background colors. This should hopefully lead to less confusion for the
user and a more consistent behavior.

A full matrix showcasing the new way Alacritty inverses text can be
found here:
https://i.imgur.com/d1XavG7.png

This fixes #1454 and fixes #1455.
2018-09-19 19:18:51 +00:00
.github Add issue template 2017-08-29 08:32:14 -07:00
assets/osx/Alacritty.app/Contents Opt-in to macOS Mojave Dark Mode 2018-09-18 20:27:40 +00:00
copypasta Scrollback cleanup 2018-07-21 17:17:41 +00:00
docs `starting` not `staring` (#1074) 2018-02-11 09:50:52 -08:00
font Fix style issues 2018-09-17 23:34:56 +00:00
res Fix solid background color opacity (#847) 2017-10-21 15:26:42 -07:00
scripts Add hidden escape sequence 2018-09-19 19:18:51 +00:00
snap Bump version number to 0.2.0 (#1492) 2018-09-17 07:54:47 -07:00
src Add hidden escape sequence 2018-09-19 19:18:51 +00:00
tests Optimize Row::reset 2018-06-02 09:56:50 -07:00
.agignore Add silver searcher ignore file 2016-12-29 10:49:12 -05:00
.gitignore Adding snapcraft.yaml 2017-06-20 07:56:30 -07:00
.travis.yml Merge master into scrollback 2018-07-28 23:10:13 +00:00
CHANGELOG.md Add hidden escape sequence 2018-09-19 19:18:51 +00:00
Cargo.lock Bump version number to 0.2.0 (#1492) 2018-09-17 07:54:47 -07:00
Cargo.toml Fix fish completion name in deb installer 2018-09-17 21:44:29 +00:00
LICENSE-APACHE Add license headers to source files 2016-06-29 20:59:14 -07:00
Makefile Scrollback cleanup 2018-07-21 17:17:41 +00:00
README.md Add `fontconfig-devel` dependency for building on Void Linux 2018-09-17 22:01:54 +00:00
alacritty-completions.bash Merge master into scrollback 2018-07-28 23:10:13 +00:00
alacritty-completions.fish Added -d & -e to fish completions 2018-03-12 23:06:04 -07:00
alacritty-completions.zsh Add shell completions and manpage 2018-03-07 21:34:05 +00:00
alacritty.desktop Update to glutin 0.16.0 2018-05-29 09:50:49 -07:00
alacritty.info Add terminfo file supporting true color, italics 2017-05-27 19:55:43 -07:00
alacritty.man Bump version number to 0.2.0 (#1492) 2018-09-17 07:54:47 -07:00
alacritty.yml Mention required terminfo update when changing tabspaces 2018-09-18 20:20:59 +00:00
alacritty_macos.yml Mention required terminfo update when changing tabspaces 2018-09-18 20:20:59 +00:00
build.rs Remove built crate 2017-12-22 14:25:14 -08:00

README.md

Alacritty

Build Status

Alacritty is the fastest terminal emulator in existence. Using the GPU for rendering enables optimizations that simply aren't possible in other emulators. Alacritty currently supports FreeBSD, Linux, macOS, and OpenBSD. Windows support is planned before the 1.0 release.

Alacritty running vim inside tmux

About

Alacritty is focused on simplicity and performance. The performance goal means it should be faster than any other terminal emulator available. The simplicity goal means that it doesn't have features such as tabs or splits (which can be better provided by a window manager or terminal multiplexer) nor niceties like a GUI config editor.

The software is considered to be at an alpha level of readiness--there are missing features and bugs to be fixed, but it is already used by many as a daily driver.

Precompiled binaries will eventually be made available on supported platforms. This is minimally blocked on a stable config format. For now, Alacritty must be built from source.

Further information

Installation

Some operating systems already provide binaries for Alacritty, for everyone else there are instructions to compile Alacritty from source.

For the manual installation, please first read the prerequisites section, then find the instructions for your OS, and finally go through the building and configuration steps.

Arch Linux

pacman -S alacritty

Debian/Ubuntu

Using cargo deb, you can create and install a deb file.

git clone https://github.com/jwilm/alacritty.git
cd alacritty
cargo install cargo-deb
cargo deb --install

openSUSE Tumbleweed Linux

zypper in alacritty

Void Linux

xbps-install alacritty

Manual Installation

Prerequisites

  1. Alacritty requires the most recent stable Rust compiler; it can be installed with rustup.

Installing Rust compiler with rustup

  1. Install rustup.rs.

  2. Clone the source code:

    git clone https://github.com/jwilm/alacritty.git
    cd alacritty
    
  3. Make sure you have the right Rust compiler installed. Run

    rustup override set stable
    rustup update stable
    

Debian/Ubuntu

You can build alacritty using cargo deb and use your system's package manager to maintain the application using the instructions above.

If you'd still like to build a local version manually, you need a few extra libraries to build Alacritty. Here's an apt command that should install all of them. If something is still found to be missing, please open an issue.

apt-get install cmake libfreetype6-dev libfontconfig1-dev xclip

Arch Linux

On Arch Linux, you need a few extra libraries to build Alacritty. Here's a pacman command that should install all of them. If something is still found to be missing, please open an issue.

pacman -S cmake freetype2 fontconfig pkg-config make xclip

Fedora

On Fedora, you need a few extra libraries to build Alacritty. Here's a dnf command that should install all of them. If something is still found to be missing, please open an issue.

dnf install cmake freetype-devel fontconfig-devel xclip

CentOS/RHEL 7

On CentOS/RHEL 7, you need a few extra libraries to build Alacritty. Here's a yum command that should install all of them. If something is still found to be missing, please open an issue.

yum install cmake freetype-devel fontconfig-devel xclip
yum group install "Development Tools"

openSUSE

On openSUSE, you need a few extra libraries to build Alacritty. Here's a zypper command that should install all of them. If something is still found to be missing, please open an issue.

zypper install cmake freetype-devel fontconfig-devel xclip

Slackware

Compiles out of the box for 14.2 For copy & paste support (middle mouse button) you need to install xclip https://slackbuilds.org/repository/14.2/misc/xclip/?search=xclip

Void Linux

On Void Linux, install following packages before compiling Alacritty:

xbps-install cmake freetype-devel freetype expat-devel fontconfig-devel fontconfig xclip

FreeBSD

On FreeBSD, you need a few extra libraries to build Alacritty. Here's a pkg command that should install all of them. If something is still found to be missing, please open an issue.

pkg install cmake freetype2 fontconfig xclip pkgconf

OpenBSD

Alacritty builds on OpenBSD 6.3 almost out-of-the-box if Rust and Xenocara are installed. If something is still found to be missing, please open an issue.

pkg_add rust

Solus

On Solus, you need a few extra libraries to build Alacritty. Here's a eopkg command that should install all of them. If something is still found to be missing, please open an issue.

sudo eopkg install fontconfig-devel

NixOS/Nixpkgs

The following command can be used to get a shell with all development dependencies on NixOS.

nix-shell -A alacritty '<nixpkgs>'

Gentoo

On Gentoo, there's a portage overlay available. Make sure layman is installed and run:

sudo layman -a slyfox

Then, add x11-terms/alacritty ** to /etc/portage/package.accept_keywords and emerge alacritty:

sudo emerge alacritty

It might be handy to mask all other packages provided in the slyfox overlay by adding */*::slyfox to /etc/portage/package.mask and adding x11-terms/alacritty::slyfox to /etc/portage/package.unmask.

Cargo

If you have a rust toolchain setup you can install Alacritty via cargo:

cargo install --git https://github.com/jwilm/alacritty

Note that you still need to download system build dependencies via your package manager as mentioned above. The binary alacritty will be placed into $HOME/.cargo/bin. Make sure it is in your path (default if you use rustup).

Other

If you build Alacritty on another distribution, we would love some help filling in this section of the README.

Building

BEFORE YOU RUN IT: Install the config file as described below; otherwise, many things (such as arrow keys) will not work.

Linux

Once all the prerequisites are installed, compiling Alacritty should be easy:

cargo build --release

If all goes well, this should place a binary at target/release/alacritty.

Desktop Entry

Many linux distributions support desktop entries for adding applications to system menus. To install the desktop entry for Alacritty, run

sudo cp target/release/alacritty /usr/local/bin # or anywhere else in $PATH
sudo desktop-file-install alacritty.desktop
sudo update-desktop-database

MacOS

To build an application for macOS, run

make app
cp -r target/release/osx/Alacritty.app /Applications/

Manual Page

Installing the manual page requires the additional dependency gzip. To install the manual page, run

sudo mkdir -p /usr/local/share/man/man1
gzip -c alacritty.man | sudo tee /usr/local/share/man/man1/alacritty.1.gz > /dev/null

Shell completions

To get automatic completions for alacritty's flags and arguments you can install the provided shell completions.

Zsh

To install the completions for zsh, you can place the alacritty-completions.zsh as _alacritty in any directory referenced by $fpath.

If you do not already have such a directory registered through your ~/.zshrc, you can add one like this:

mkdir -p ${ZDOTDIR:-~}/.zsh_functions
echo 'fpath+=${ZDOTDIR:-~}/.zsh_functions' >> ${ZDOTDIR:-~}/.zshrc

Then copy the completion file to this directory:

cp alacritty-completions.zsh ${ZDOTDIR:-~}/.zsh_functions/_alacritty

Bash

To install the completions for bash, you can source the alacritty-completions.bash in your ~/.bashrc file.

If you do not plan to delete the source folder of alacritty, you can run

echo "source $(pwd)/alacritty-completions.bash" >> ~/.bashrc

Otherwise you can copy it to the ~/.bash_completion folder and source it from there:

mkdir -p ~/.bash_completion
cp alacritty-completions.bash ~/.bash_completion/alacritty
echo "source ~/.bash_completion/alacritty" >> ~/.bashrc

Fish

To install the completions for fish, run

sudo cp alacritty-completions.fish $__fish_datadir/vendor_completions.d/alacritty.fish

Configuration

Although it's possible the default configuration would work on your system, you'll probably end up wanting to customize it anyhow. There is a default alacritty.yml and alacritty_macos.yml at the git repository root for Linux and macOS respectively.

Alacritty looks for the configuration file at the following paths:

  1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
  2. $XDG_CONFIG_HOME/alacritty.yml
  3. $HOME/.config/alacritty/alacritty.yml
  4. $HOME/.alacritty.yml

If none of these paths are found then $XDG_CONFIG_HOME/alacritty/alacritty.yml is created once alacritty is first run. On most systems this often defaults to $HOME/.config/alacritty/alacritty.yml.

Many configuration options will take effect immediately upon saving changes to the config file. The only exception is the font and dimensions sections which requires Alacritty to be restarted. For further explanation of the config file, please consult the comments in the default config file.

Issues (known, unknown, feature requests, etc.)

If you run into a problem with Alacritty, please file an issue. If you've got a feature request, feel free to ask about it. Keep in mind that Alacritty is very much not looking to be a feature-rich terminal emulator with all sorts of bells and widgets. It's primarily a cross-platform, blazing fast tmux renderer that Just Works.

FAQ

  • Is it really the fastest terminal emulator?

    In the terminals I've benchmarked against, alacritty is either faster, WAY faster, or at least neutral. There are no benchmarks in which I've found Alacritty to be slower.

  • macOS + tmux + vim is slow! I thought this was supposed to be fast!

    This appears to be an issue outside of terminal emulators; either macOS has an IPC performance issue, or either tmux or vim (or both) have a bug. This same issue can be seen in iTerm2 and Terminal.app. I've found that if tmux is running on another machine which is connected to Alacritty via SSH, this issue disappears. Actual throughput and rendering performance are still better in Alacritty.

  • When will Windows support be available?

    When someone has time to work on it. Contributors would be welcomed :).

  • My arrow keys don't work.

    It sounds like you deleted some key bindings from your config file. Please reference the default config file to restore them.

IRC

Alacritty discussion can be found in #alacritty on freenode.

Wayland

Wayland support is available, but not everything works as expected. Many people have found a better experience using XWayland which can be achieved launching Alacritty with the WAYLAND_DISPLAY environment variable cleared:

env WAYLAND_DISPLAY= alacritty

If you're interested in seeing our Wayland support improve, please head over to the Wayland meta issue on the winit project to see how you may contribute.

License

Alacritty is released under the Apache License, Version 2.0.