3bd5ac221a
Previously Alacritty was using two different ways to reference lines in the terminal. Either a `usize`, or a `Line(usize)`. These indexing systems both served different purposes, but made it difficult to reason about logic involving these systems because of its inconsistency. To resolve this issue, a single new `Line(i32)` type has been introduced. All existing references to lines and points now rely on this definition of a line. The indexing starts at the top of the terminal region with the line 0, which matches the line 1 used by escape sequences. Each line in the history becomes increasingly negative and the bottommost line is equal to the number of visible lines minus one. Having a system which goes into the negatives allows following the escape sequence's indexing system closely, while at the same time making it trivial to implement `Ord` for points. The Alacritty UI crate is the only place which has a different indexing system, since rendering and input puts the zero line at the top of the viewport, rather than the top of the terminal region. All instances which refer to a number of lines/columns instead of just a single Line/Column have also been changed to use a `usize` instead. This way a Line/Column will always refer to a specific place in the grid and no confusion is created by having a count of lines as a possible index into the grid storage. |
||
|---|---|---|
| .builds | ||
| .github | ||
| alacritty | ||
| alacritty_config_derive | ||
| alacritty_terminal | ||
| docs | ||
| extra | ||
| scripts | ||
| .agignore | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| alacritty.yml | ||
| Cargo.lock | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| INSTALL.md | ||
| LICENSE-APACHE | ||
| Makefile | ||
| README.md | ||
| rustfmt.toml | ||
Alacritty - A fast, cross-platform, OpenGL terminal emulator
About
Alacritty is a modern terminal emulator that comes with sensible defaults, but allows for extensive configuration. By integrating with other applications, rather than reimplementing their functionality, it manages to provide a flexible set of features with high performance. The supported platforms currently consist of BSD, Linux, macOS and Windows.
The software is considered to be at a beta level of readiness; there are a few missing features and bugs to be fixed, but it is already used by many as a daily driver.
Precompiled binaries are available from the GitHub releases page.
Features
You can find an overview over the features available in Alacritty here.
Further information
- Announcing Alacritty, a GPU-Accelerated Terminal Emulator January 6, 2017
- A talk about Alacritty at the Rust Meetup January 2017 January 19, 2017
- Alacritty Lands Scrollback, Publishes Benchmarks September 17, 2018
- Version 0.3.0 Release Announcement April 07, 2019
- Version 0.5.0 Release Announcement July 31, 2020
Installation
Alacritty can be installed by using various package managers on Linux, BSD, macOS and Windows.
Prebuilt binaries for macOS and Windows can also be downloaded from the GitHub releases page.
For everyone else, the detailed instructions to install Alacritty can be found here.
Requirements
- OpenGL 3.3 or higher
- [Windows] ConPTY support (Windows 10 version 1809 or higher)
Configuration
You can find the default configuration file with documentation for all available fields on the GitHub releases page for each release.
Alacritty doesn't create the config file for you, but it looks for one in the following locations:
$XDG_CONFIG_HOME/alacritty/alacritty.yml$XDG_CONFIG_HOME/alacritty.yml$HOME/.config/alacritty/alacritty.yml$HOME/.alacritty.yml
Windows
On Windows, the config file should be located at:
%APPDATA%\alacritty\alacritty.yml
Contributing
A guideline about contributing to Alacritty can be found in the
CONTRIBUTING.md file.
FAQ
Is it really the fastest terminal emulator?
Benchmarking terminal emulators is complicated. Alacritty uses vtebench to quantify terminal emulator throughput and manages to consistently score better than the competition using it. If you have found an example where this is not the case, please report a bug.
Other aspects like latency or framerate and frame consistency are more difficult to quantify. Some terminal emulators also intentionally slow down to save resources, which might be preferred by some users.
If you have doubts about Alacritty's performance or usability, the best way to quantify terminal emulators is always to test them with your specific usecases.
Why isn't feature X implemented?
Alacritty has many great features, but not every feature from every other terminal. This could be for a number of reasons, but sometimes it's just not a good fit for Alacritty. This means you won't find things like tabs or splits (which are best left to a window manager or terminal multiplexer) nor niceties like a GUI config editor.
IRC
Alacritty discussions can be found in #alacritty on freenode.
License
Alacritty is released under the Apache License, Version 2.0.