1ALACRITTY(1) User Commands ALACRITTY(1)
2
3
4
6 Alacritty - A fast, cross-platform, OpenGL terminal emulator
7
9 alacritty [SUBCOMMANDS] [FLAGS] [OPTIONS]
10
12 Alacritty is a modern terminal emulator that comes with sensible de‐
13 faults, but allows for extensive configuration. By integrating with
14 other applications, rather than reimplementing their functionality, it
15 manages to provide a flexible set of features with high performance.
16
18 -h, --help
19 Prints help information
20
21 --hold Remain open after child process exits
22
23 --print-events
24 Print all events to stdout
25
26 -q Reduces the level of verbosity (the min level is -qq)
27
28 --ref-test
29 Generates ref test
30
31 -v Increases the level of verbosity (the max level is -vvv)
32
33 -V, --version
34 Prints version information
35
37 --class <instance> | <instance>,<general>
38 Defines the window class hint on Linux [default:
39 Alacritty,Alacritty]
40
41 On Wayland the instance class sets the `app_id`, while the gen‐
42 eral class is ignored.
43
44 -e, --command <command>...
45 Command and args to execute (must be last argument)
46
47 --config-file <config-file>
48 Specify alternative configuration file
49
50 Alacritty looks for the configuration file at the following
51 paths:
52 1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
53 2. $XDG_CONFIG_HOME/alacritty.yml
54 3. $HOME/.config/alacritty/alacritty.yml
55 4. $HOME/.alacritty.yml
56
57 On Windows, the configuration file is located at %APP‐
58 DATA%\alacritty\alacritty.yml.
59
60 --embed <parent>
61 Defines the X11 window ID (as a decimal integer) to embed
62 Alacritty within
63
64 -o, --option <option>...
65 Override configuration file options [example: cursor.style=Beam]
66
67 --socket <socket>
68 Path for IPC socket creation
69
70 -t, --title <title>
71 Defines the window title [default: Alacritty]
72
73 --working-directory <working-directory>
74 Start the shell in the specified working directory
75
77 msg Available socket messages
78
80 See the alacritty github repository at
81 https://github.com/alacritty/alacritty for the full documentation.
82
84 Found a bug? Please report it at
85 https://github.com/alacritty/alacritty/issues.
86
88 • Christian Duerr <contact@christianduerr.com>
89
90 • Joe Wilm <joe@jwilm.com>
91
92
93
94alacritty 0.10.1 August 2018 ALACRITTY(1)