2021-08-03 05:46:27 -04:00
|
|
|
.TH ALACRITTY "1" "August 2018" "alacritty 0.9.0" "User Commands"
|
2018-03-07 16:34:05 -05:00
|
|
|
.SH NAME
|
2020-12-29 15:05:19 -05:00
|
|
|
Alacritty \- A fast, cross-platform, OpenGL terminal emulator
|
2018-03-07 16:34:05 -05:00
|
|
|
.SH "SYNOPSIS"
|
|
|
|
alacritty [FLAGS] [OPTIONS]
|
|
|
|
.SH DESCRIPTION
|
2020-12-29 15:05:19 -05:00
|
|
|
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.
|
2018-03-07 16:34:05 -05:00
|
|
|
.SH "FLAGS"
|
|
|
|
.TP
|
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
|
|
Prints help information
|
|
|
|
.TP
|
2019-10-09 17:37:48 -04:00
|
|
|
\fB\-\-hold\fR
|
|
|
|
Remain open after child process exits
|
|
|
|
.TP
|
2018-03-07 16:34:05 -05:00
|
|
|
\fB\-\-print\-events\fR
|
2019-03-11 08:35:49 -04:00
|
|
|
Print all events to stdout
|
2018-03-07 16:34:05 -05:00
|
|
|
.TP
|
|
|
|
\fB\-q\fR
|
|
|
|
Reduces the level of verbosity (the min level is \fB\-qq\fR)
|
|
|
|
.TP
|
|
|
|
\fB\-\-ref\-test\fR
|
|
|
|
Generates ref test
|
|
|
|
.TP
|
|
|
|
\fB\-v\fR
|
|
|
|
Increases the level of verbosity (the max level is \fB\-vvv\fR)
|
|
|
|
.TP
|
|
|
|
\fB\-V\fR, \fB\-\-version\fR
|
|
|
|
Prints version information
|
|
|
|
.SH "OPTIONS"
|
|
|
|
.TP
|
2020-07-04 02:13:32 -04:00
|
|
|
\fB\-\-class\fR <instance> | <instance>,<general>
|
|
|
|
Defines the window class hint on Linux [default: Alacritty,Alacritty]
|
|
|
|
|
|
|
|
On Wayland the instance class sets the `app_id`, while the general class is ignored.
|
2018-07-21 13:17:41 -04:00
|
|
|
.TP
|
2018-03-07 16:34:05 -05:00
|
|
|
\fB\-e\fR, \fB\-\-command\fR <command>...
|
|
|
|
Command and args to execute (must be last argument)
|
2019-03-11 08:35:49 -04:00
|
|
|
.TP
|
2018-03-07 16:34:05 -05:00
|
|
|
\fB\-\-config\-file\fR <config\-file>
|
2020-01-06 11:14:59 -05:00
|
|
|
Specify alternative configuration file
|
|
|
|
|
|
|
|
Alacritty looks for the configuration file at the following paths:
|
|
|
|
1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
|
|
|
|
2. $XDG_CONFIG_HOME/alacritty.yml
|
|
|
|
3. $HOME/.config/alacritty/alacritty.yml
|
|
|
|
4. $HOME/.alacritty.yml
|
|
|
|
|
|
|
|
On Windows, the configuration file is located at %APPDATA%\\alacritty\\alacritty.yml.
|
2019-03-11 08:35:49 -04:00
|
|
|
.TP
|
2020-08-22 16:55:27 -04:00
|
|
|
\fB\-\-embed\fR <parent>
|
|
|
|
Defines the X11 window ID (as a decimal integer) to embed Alacritty within
|
|
|
|
.TP
|
|
|
|
\fB\-o\fR, \fB\-\-option\fR <option>...
|
2020-09-13 17:10:44 -04:00
|
|
|
Override configuration file options [example: cursor.style=Beam]
|
2020-08-22 16:55:27 -04:00
|
|
|
.TP
|
2018-03-07 16:34:05 -05:00
|
|
|
\fB\-t\fR, \fB\-\-title\fR <title>
|
|
|
|
Defines the window title [default: Alacritty]
|
|
|
|
.TP
|
|
|
|
\fB\-\-working\-directory\fR <working\-directory>
|
|
|
|
Start the shell in the specified working directory
|
|
|
|
.SH "SEE ALSO"
|
2020-01-10 20:23:13 -05:00
|
|
|
See the alacritty github repository at https://github.com/alacritty/alacritty for the full documentation.
|
2018-03-07 16:34:05 -05:00
|
|
|
.SH "BUGS"
|
2020-01-10 20:23:13 -05:00
|
|
|
Found a bug? Please report it at https://github.com/alacritty/alacritty/issues.
|
2020-12-29 15:05:19 -05:00
|
|
|
.SH "MAINTAINERS"
|
2018-03-07 16:34:05 -05:00
|
|
|
.sp
|
|
|
|
.RS 4
|
|
|
|
.ie n \{\
|
|
|
|
\h'-04'\(bu\h'+03'\c
|
|
|
|
.\}
|
|
|
|
.el \{\
|
|
|
|
.sp -1
|
|
|
|
.IP \(bu 2.3
|
|
|
|
.\}
|
2020-01-10 20:23:13 -05:00
|
|
|
Christian Duerr <contact@christianduerr.com>
|
|
|
|
.sp
|
|
|
|
.ie n \{\
|
|
|
|
\h'-04'\(bu\h'+03'\c
|
|
|
|
.\}
|
2018-03-07 16:34:05 -05:00
|
|
|
Joe Wilm <joe@jwilm.com>
|