1
0
Fork 0
mirror of https://github.com/alacritty/alacritty.git synced 2024-11-25 14:05:41 -05:00
alacritty/docs/features.md
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

3.6 KiB

Features

This document gives an overview over Alacritty's features beyond its terminal emulation capabilities. To get a list with supported control sequences take a look at Alacritty's escape sequence support.

Vi Mode

The vi mode allows moving around Alacritty's viewport and scrollback using the keyboard. It also serves as a jump-off point for other features like search and opening URLs with the keyboard. By default you can launch it using Ctrl Shift Space.

Motion

The cursor motions are setup by default to mimic vi, however they are fully configurable. If you don't like vi's bindings, take a look at the [onfiguration file to change the various movements.

Selection

One useful feature of vi mode is the ability to make selections and copy text to the clipboard. By default you can start a selection using v and copy it using y. All selection modes that are available with the mouse can be accessed from vi mode, including the semantic (Alt v), line (Shift v) and block selection (Ctrl v). You can also toggle between them while the selection is still active.

Search allows you to find anything in Alacritty's scrollback buffer. You can search forward using Ctrl Shift f and backward using Ctrl Shift b.

In vi mode the search is bound to / for forward and ? for backward search. This allows you to move around quickly and help with selecting content. The SearchStart and SearchEnd keybinding actions can be bound if you're looking for a way to jump to the start or the end of a match.

During normal search you don't have the opportunity to move around freely, but you can still jump between matches using Enter and Shift Enter. After leaving search with Escape your active match stays selected, allowing you to easily copy it.

Hints

Terminal hints allow easily interacting with visible text without having to start vi mode. They consist of a regex that detects these text elements and then either feeds them to an external application or triggers one of Alacritty's built-in actions.

Hints can also be triggered using the mouse or vi mode cursor. If a hint is enabled for mouse interaction and recognized as such, it will be underlined when the mouse or vi mode cursor is on top of it. Using the left mouse button or Enter key in vi mode will then trigger the hint.

Hints can be configured in the hints and colors.hints sections in the Alacritty configuration file.

Selection expansion

After making a selection, you can use the right mouse button to expand it. Double-clicking will expand the selection semantically, while triple-clicking will perform line selection. If you hold Ctrl while expanding the selection, it will switch to the block selection mode.

Opening URLs with the mouse

You can open URLs with your mouse by clicking on them. The modifiers required to be held and program which should open the URL can be setup in the configuration file. If an application captures your mouse clicks, which is indicated by a change in mouse cursor shape, you're required to hold Shift to bypass that.

Multi-Window

Alacritty supports running multiple terminal emulators from the same Alacritty instance. New windows can be created either by using the CreateNewWindow keybinding action, or by executing the alacritty msg create-window subcommand.