alacritty(1)
Alacritty is a GPU-accelerated terminal emulator written in Rust, designed for speed and simplicity.
Synopsis
alacritty [OPTIONS] [COMMAND]Description
Alacritty is a modern terminal emulator that prioritizes performance by leveraging GPU acceleration. It renders text using OpenGL and is cross-platform, supporting Linux, macOS, and Windows.
Configuration is done via YAML files, typically located at ~/.config/alacritty/alacritty.toml or ~/.config/alacritty/alacritty.yml. Alacritty supports standard terminal features including 256 colors, true color (24-bit), and sixel image protocol.
Common options
| Flag | What it does |
|---|---|
-e, --command | Execute a command instead of the shell; remaining arguments are passed to the command |
-t, --title | Set the window title |
-o, --option | Override a configuration option; format: <key>=<value> |
-w, --working-directory | Set the working directory for the shell |
--class | Set the X11 window class name |
--embed | Embed Alacritty in another application (X11 only, requires window ID) |
-v, --verbose | Increase verbosity; can be used multiple times for more logging |
--help | Display help message and exit |
--version | Print version information and exit |
Examples
Launch Alacritty with the default shell and configuration
alacrittyOpen Alacritty and immediately run vim to edit /etc/hosts
alacritty -e vim /etc/hostsLaunch Alacritty with title 'My Project' and working directory set to ~/project
alacritty -t 'My Project' -w ~/projectStart Alacritty with font size 14 and 90% window opacity, overriding config
alacritty -o 'font.size=14' -o 'window.opacity=0.9'Run a bash command that echoes text and waits for input
alacritty -e bash -c 'echo Hello && read'Launch Alacritty as a background process with window class 'floating-term' for window managers
alacritty --class='floating-term' &