1
0
Fork 0
mirror of https://github.com/alacritty/alacritty.git synced 2024-11-18 13:55:23 -05:00
A cross-platform, OpenGL terminal emulator.
Find a file
Christian Duerr bd4906722a
Switch to TOML configuration format
This switches Alacritty's default configuration format from yaml to
toml. While yaml is still supported, it is done by converting it to toml
and should be removed entirely in the future.

All existing features were persisted based on my testing. Behavior
should not change much, though `--option` might have slightly different
behavior since the entire line is not interpreted as one line of toml.

A new `alacritty migrate` subcommand has been added which allows
automatic migration from yaml to toml. This also could be used as a
facility to automatically fix configuration file changes in the future.

Closes #6592.
2023-06-12 00:23:41 +00:00
.builds Update patch dependencies 2023-05-17 08:36:41 +03:00
.github Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
alacritty Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
alacritty_config Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
alacritty_config_derive Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
alacritty_terminal Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
docs Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
extra Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
scripts Switch to flamegraph-rs script 2020-01-27 02:30:23 +03:00
.editorconfig Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
.gitignore Add editorconfig 2020-11-06 05:12:29 +03:00
Cargo.lock Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
Cargo.toml Add resolver to workspace manifest 2023-06-11 18:58:30 +00:00
CHANGELOG.md Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
CONTRIBUTING.md Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
INSTALL.md Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
LICENSE-APACHE Remove copyright notice from files 2020-06-06 21:49:14 +03:00
LICENSE-MIT Add licenses to alacritty_config 2022-09-05 09:39:09 +03:00
Makefile Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
README.md Switch to TOML configuration format 2023-06-12 00:23:41 +00:00
rustfmt.toml Update rustfmt configuration 2021-10-11 00:54:18 +00:00

Alacritty Logo

Alacritty - A fast, cross-platform, OpenGL terminal emulator

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

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

  • At least OpenGL ES 2.0
  • [Windows] ConPTY support (Windows 10 version 1809 or higher)

Configuration

You can find the documentation for Alacritty's configuration in man 5 alacritty, or by looking at the scdoc file if you do not have the manpages installed.

Alacritty doesn't create the config file for you, but it looks for one in the following locations:

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

Windows

On Windows, the config file should be located at:

%APPDATA%\alacritty\alacritty.toml

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 Libera.Chat.

License

Alacritty is released under the Apache License, Version 2.0.