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 <general> | <general>,<instance>
38 Defines the window class hint on Linux [default:
39 Alacritty,Alacritty]
40
41 When only the general class is passed, instance will be set to
42 the same value.
43
44 On Wayland the general class sets the `app_id`, while the in‐
45 stance class is ignored.
46
47 -e, --command <command>...
48 Command and args to execute (must be last argument)
49
50 --config-file <config-file>
51 Specify alternative configuration file
52
53 Alacritty looks for the configuration file at the following
54 paths:
55 1. $XDG_CONFIG_HOME/alacritty/alacritty.yml
56 2. $XDG_CONFIG_HOME/alacritty.yml
57 3. $HOME/.config/alacritty/alacritty.yml
58 4. $HOME/.alacritty.yml
59
60 On Windows, the configuration file is located at %APP‐
61 DATA%\alacritty\alacritty.yml.
62
63 --embed <parent>
64 X11 window ID to embed Alacritty within (decimal or hexadecimal
65 with "0x" prefix)
66
67 -o, --option <option>...
68 Override configuration file options [example: cursor.style=Beam]
69
70 --socket <socket>
71 Path for IPC socket creation
72
73 -T, --title <title>
74 Defines the window title [default: Alacritty]
75
76 --working-directory <working-directory>
77 Start the shell in the specified working directory
78
80 msg Available socket messages
81
83 See the alacritty github repository at
84 https://github.com/alacritty/alacritty for the full documentation.
85
87 Found a bug? Please report it at
88 https://github.com/alacritty/alacritty/issues.
89
91 • Christian Duerr <contact@christianduerr.com>
92
93 • Joe Wilm <joe@jwilm.com>
94
95
96
97alacritty 0.12.3 August 2018 ALACRITTY(1)