2023-05-28 06:13:09 -04:00
|
|
|
ALACRITTY(1)
|
|
|
|
|
|
|
|
# NAME
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Alacritty - A fast, cross-platform, OpenGL terminal emulator.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
# FLAGS
|
|
|
|
|
|
|
|
*-h, --help*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Prints help information.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*--hold*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Remain open after child process exits.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*--print-events*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Print all events to stdout.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*-q*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Reduces the level of verbosity (the min level is *-qq*).
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*--ref-test*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
2023-05-28 06:13:09 -04:00
|
|
|
Generates ref test
|
|
|
|
|
|
|
|
*-v*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Increases the level of verbosity (the max level is *-vvv*).
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
*-V, --version*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Prints version information.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# OPTIONS
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*--class* _<GENERAL>_ | _<GENERAL>_,_<INSTANCE>_
|
|
|
|
|
|
|
|
Defines the window class hint on Linux.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
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.
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Default: _Alacritty,Alacritty_
|
|
|
|
|
|
|
|
*-e, --command* _<COMMAND>..._
|
|
|
|
|
|
|
|
Command and args to execute (must be last argument).
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*--config-file* _<CONFIG_FILE>_
|
|
|
|
|
|
|
|
Specify alternative configuration file.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
Alacritty looks for the configuration file at the following paths:
|
2023-11-23 12:39:18 -05:00
|
|
|
. _$XDG_CONFIG_HOME/alacritty/alacritty.toml_
|
|
|
|
. _$XDG_CONFIG_HOME/alacritty.toml_
|
|
|
|
. _$HOME/.config/alacritty/alacritty.toml_
|
|
|
|
. _$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>..._
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Override configuration file options.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Example: _alacritty -o 'cursor.style="Beam"'_
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*--socket* _<SOCKET>_
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Path for IPC socket creation.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
*-T, --title* _<TITLE>_
|
2023-05-28 06:13:09 -04:00
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Defines the window title.
|
|
|
|
|
|
|
|
Default: _Alacritty_
|
|
|
|
|
|
|
|
*--working-directory* _<WORKING_DIRECTORY>_
|
|
|
|
|
|
|
|
Start the shell in the specified working directory.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# SUBCOMMANDS
|
|
|
|
|
|
|
|
*msg*
|
2023-11-23 12:39:18 -05:00
|
|
|
|
|
|
|
Send IPC socket messages (see *alacritty-msg*(1)).
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
|
2023-07-01 08:41:09 -04:00
|
|
|
*alacritty-msg*(1), *alacritty*(5), *alacritty-bindings*(5)
|
|
|
|
|
2023-05-28 06:13:09 -04:00
|
|
|
# BUGS
|
|
|
|
|
2023-11-23 12:39:18 -05:00
|
|
|
Found a bug? Please report it at _https://github.com/alacritty/alacritty/issues_.
|
2023-05-28 06:13:09 -04:00
|
|
|
|
|
|
|
# MAINTAINERS
|
|
|
|
|
|
|
|
- Christian Duerr <contact@christianduerr.com>
|
|
|
|
- Kirill Chibisov <contact@kchibisov.com>
|