Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
ALACRITTY(1)		     General Commands Manual		    ALACRITTY(1)

NAME
     Alacritty - A fast, cross-platform, OpenGL terminal emulator.

SYNOPSIS
     Alacritty	is a modern terminal emulator that comes with sensible defaults,
     but allows for extensive configuration. By integrating with other	applica-
     tions,  rather  than reimplementing their functionality, it manages to pro-
     vide a flexible set of features with high performance.

FLAGS
     -h, --help

	 Prints help information.

     --hold

	 Remain open after child process exits.

     --daemon

	 Do not spawn an initial window.

     --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.

OPTIONS
     --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  doesn't create the config file for you, but it looks for one
	 in the following locations on UNIX systems:

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

	 On Windows, the config file will be looked for in:

	     1.  %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.

SUBCOMMANDS
     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.

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

BUGS
     Found a bug? Please report it at https://github.com/alacritty/alacritty/is-
     sues.

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

				   2026-06-13			    ALACRITTY(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=alacritty&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help