.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "ALACRITTY" "1" "2024-03-31"
.PP
.SH NAME
.PP
Alacritty - A fast, cross-platform, OpenGL terminal emulator.\&
.PP
.SH SYNOPSIS
.PP
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.\&
.PP
.SH FLAGS
.PP
\fB-h, --help\fR
.PP
.RS 4
Prints help information.\&
.PP
.RE
\fB--hold\fR
.PP
.RS 4
Remain open after child process exits.\&
.PP
.RE
\fB--print-events\fR
.PP
.RS 4
Print all events to STDOUT.\&
.PP
.RE
\fB-q\fR
.PP
.RS 4
Reduces the level of verbosity (the min level is \fB-qq\fR).\&
.PP
.RE
\fB--ref-test\fR
.PP
.RS 4
Generates ref test
.PP
.RE
\fB-v\fR
.PP
.RS 4
Increases the level of verbosity (the max level is \fB-vvv\fR).\&
.PP
.RE
\fB-V, --version\fR
.PP
.RS 4
Prints version information.\&
.PP
.RE
.SH OPTIONS
.PP
\fB--class\fR \fI<GENERAL>\fR | \fI<GENERAL>\fR,\fI<INSTANCE>\fR
.PP
.RS 4
Defines the window class hint on Linux.\&
.PP
When only the general class is passed, instance will be set to the same value.\&
.PP
On Wayland the general class sets the \fIapp_id\fR, while the instance class is ignored.\&
.PP
Default: \fIAlacritty,Alacritty\fR
.PP
.RE
\fB-e, --command\fR \fI<COMMAND>.\&.\&.\&\fR
.PP
.RS 4
Command and args to execute (must be last argument).\&
.PP
.RE
\fB--config-file\fR \fI<CONFIG_FILE>\fR
.PP
.RS 4
Specify alternative configuration file.\&
.PP
Alacritty looks for the configuration file at the following paths:
.RS 4
.PD 0
.IP 1. 4
\fI$XDG_CONFIG_HOME/alacritty/alacritty.\&toml\fR
.IP 2. 4
\fI$XDG_CONFIG_HOME/alacritty.\&toml\fR
.IP 3. 4
\fI$HOME/.\&config/alacritty/alacritty.\&toml\fR
.IP 4. 4
\fI$HOME/.\&alacritty.\&toml\fR
.PD
.PP
.RE
On Windows, the configuration file is located at \fI%APPDATA%\ealacritty\ealacritty.\&toml\fR.\&
.PP
.RE
\fB--embed\fR \fI<PARENT>\fR
.PP
.RS 4
X11 window ID to embed Alacritty within (decimal or hexadecimal with \fI0x\fR prefix).\&
.PP
.RE
\fB-o, --option\fR \fI<OPTION>.\&.\&.\&\fR
.PP
.RS 4
Override configuration file options.\&
.PP
Example: \fIalacritty -o '\&cursor.\&style="Beam"'\&\fR
.PP
.RE
\fB--socket\fR \fI<SOCKET>\fR
.PP
.RS 4
Path for IPC socket creation.\&
.PP
.RE
\fB-T, --title\fR \fI<TITLE>\fR
.PP
.RS 4
Defines the window title.\&
.PP
Default: \fIAlacritty\fR
.PP
.RE
\fB--working-directory\fR \fI<WORKING_DIRECTORY>\fR
.PP
.RS 4
Start the shell in the specified working directory.\&
.PP
.RE
.SH SUBCOMMANDS
.PP
\fBmsg\fR
.PP
.RS 4
Send IPC socket messages (see \fBalacritty-msg\fR(1)).\&
.PP
.RE
\fBmigrate\fR
.PP
.RS 4
Migrate the configuration file.\&
.PP
\fB-c, --config-file\fR \fI<CONFIG_FILE>\fR
.PP
.RS 4
Path to the configuration file.\&
.PP
.RE
\fB-d, --dry-run\fR
.PP
.RS 4
Only output TOML config to STDOUT.\&
.PP
.RE
\fB-i, --skip-imports\fR
.PP
.RS 4
Do not recurse over imports.\&
.PP
.RE
\fB--skip-renames\fR
.PP
.RS 4
Do not move renamed fields to their new location.\&
.PP
.RE
\fB-s, --silent\fR
.PP
.RS 4
Do not output to STDOUT.\&
.PP
.RE
\fB-h, --help\fR
.PP
.RS 4
Print help information.\&
.PP
.RE
.RE
.SH SEE ALSO
.PP
\fBalacritty-msg\fR(1), \fBalacritty\fR(5), \fBalacritty-bindings\fR(5)
.PP
.SH BUGS
.PP
Found a bug?\& Please report it at \fIhttps://github.\&com/alacritty/alacritty/issues\fR.\&
.PP
.SH MAINTAINERS
.PP
.PD 0
.IP \(bu 4
Christian Duerr <contact@christianduerr.\&com>
.IP \(bu 4
Kirill Chibisov <contact@kchibisov.\&com>