alacritty - Man Page

• Open a new Alacritty window: alacritty
• Run in a specific directory: alacritty --working-directory path/to/directory
• [e]xecute a command in a new Alacritty window: alacritty -e command
• Use an alternative configuration file (defaults to $XDG_CONFIG_HOME/alacritty/alacritty.toml): alacritty --config-file path/to/config.toml
• Run with live configuration reload enabled (can also be enabled by default in alacritty.toml): alacritty --live-config-reload --config-file path/to/config.toml

tldr.sh

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.

-h,  --help

Prints help information.

--hold

Remain open after child process exits.

--print-events

Print all events to STDOUT.

-q

Reduces the level of verbosity (the min level is -qq).

--ref-test

Generates ref test

-v

Increases the level of verbosity (the max level is -vvv).

-V,  --version

Prints version information.

--class <GENERAL> | <GENERAL>,<INSTANCE>

Defines the window class hint on Linux.

When only the general class is passed, instance will be set to the same value.

On Wayland the general class sets the app_id, while the instance class is ignored.

Default: Alacritty,Alacritty

-e,  --command <COMMAND>...

Command and args to execute (must be last argument).

--config-file <CONFIG_FILE>

Specify alternative configuration file.

Alacritty looks for the configuration file at the following paths:

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

On Windows, the configuration file is located at %APPDATA%\alacritty\alacritty.toml.

--embed <PARENT>

X11 window ID to embed Alacritty within (decimal or hexadecimal with 0x prefix).

-o,  --option <OPTION>...

Override configuration file options.

Example: alacritty -o 'cursor.style="Beam"'

--socket <SOCKET>

Path for IPC socket creation.

-T,  --title <TITLE>

Defines the window title.

Default: Alacritty

--working-directory <WORKING_DIRECTORY>

Start the shell in the specified working directory.

msg

Send IPC socket messages (see alacritty-msg(1)).

migrate

Migrate the configuration file.

-c, --config-file <CONFIG_FILE>

Path to the configuration file.

-d, --dry-run

Only output TOML config to STDOUT.

-i, --skip-imports

Do not recurse over imports.

--skip-renames

Do not move renamed fields to their new location.

-s, --silent

Do not output to STDOUT.

-h, --help

Print help information.

alacritty-msg(1), alacritty(5), alacritty-bindings(5)

Found a bug? Please report it at https://github.com/alacritty/alacritty/issues.

• Christian Duerr <contact@christianduerr.com>
• Kirill Chibisov <contact@kchibisov.com>

alacritty(5), alacritty-bindings(5), alacritty-msg(1), xde-menu(1).