Skip to main content
Alacritty is a modern terminal emulator written in Rust that focuses on simplicity and performance. It’s one of the fastest terminal emulators available, with GPU acceleration and minimal resource usage.

​
Why Alacritty?

Performance

Blazingly fast with GPU rendering and Rust efficiency

Simplicity

No tabs, splits, or bells - just a fast terminal

Cross-Platform

Consistent experience on macOS, Linux, and Windows

TOML Config

Simple, readable configuration format

​
Installation

1

Install Alacritty

brew install --cask alacritty
2

Install IosevkaTerm Nerd Font

# macOS
brew tap homebrew/cask-fonts
brew install font-iosevka-term-nerd-font

# Linux - Download from nerdfonts.com
3

Link Gentleman.Dots configuration

# Create config directory
mkdir -p ~/.config/alacritty

# Link the configuration
ln -sf ~/Gentleman.Dots/alacritty.toml ~/.config/alacritty/alacritty.toml
4

Launch Alacritty

Open Alacritty and enjoy your blazingly fast terminal!

​
Configuration Breakdown

The Gentleman.Dots Alacritty config (alacritty.toml) includes:

​
Color Scheme: Kanagawa Wave

[colors.primary]
background = "#1F1F28" # winterBlue - deep, calm background
foreground = "#DCD7BA" # fujiWhite - soft white text
The Kanagawa Wave theme is inspired by the famous Japanese woodblock print “The Great Wave off Kanagawa” by Hokusai. The colors evoke ocean depths, mountain peaks, and traditional Japanese aesthetics.

​
Font Configuration

alacritty.toml
[font]
size = 16

[font.normal]
family = "IosevkaTerm NF"
The configuration uses:
  • IosevkaTerm Nerd Font - A programming font with excellent readability
  • Size 16 - Comfortable for long coding sessions
  • Nerd Font icons - Support for file icons in terminal tools (exa, lsd, etc.)

​
Window Settings

alacritty.toml
[window]
option_as_alt = "Both"  # macOS: Makes Option key work as Alt
opacity = 0.96          # Slight transparency for modern look
The option_as_alt = "Both" setting is crucial for macOS users - it enables Alt+f (forward word) and Alt+b (backward word) navigation in shells like Zsh and Fish.

​
Cursor Configuration

alacritty.toml
[cursor]
style = "Block"              # Classic block cursor
unfocused_hollow = true      # Hollow cursor when unfocused

​
Environment Variables

alacritty.toml
[env]
TERM = "xterm-256color"  # Ensures proper color support

​
Key Features

​
GPU Acceleration

Alacritty renders everything using your GPU, making it incredibly fast:
  • Low latency - Minimal input lag
  • Smooth scrolling - Buttery smooth even with thousands of lines
  • Efficient rendering - Only redraws changed cells

​
Minimal Design Philosophy

Alacritty intentionally omits features that can be better handled by other tools:

No Tabs

Use tmux, zellij, or your window manager instead

No Splits

Better handled by terminal multiplexers

No Scrollback Search

Use your shell’s history or multiplexer features

No Built-in Themes

Manual color configuration for full control
This minimalism is a strength, not a limitation. It keeps Alacritty lean, fast, and focused on doing one thing exceptionally well.

​
Working with Gentleman.Dots

​
With Tmux

Alacritty pairs perfectly with tmux for tab and split functionality: 
# Launch tmux automatically
alias t='tmux attach || tmux new'
The Gentleman.Dots tmux config provides:
  • Beautiful status bar matching the Kanagawa theme
  • Intuitive key bindings
  • Session management

​
With Zellij

Or use Zellij as a modern alternative: 
# Launch zellij
zellij

​
Shell Integration

Works seamlessly with all Gentleman.Dots shells:
  • Zsh - Fast and compatible
  • Fish - Auto-suggestions and highlighting work perfectly
  • Nushell - Full structured data support

​
Customization Tips

​
Adjusting Font Size

alacritty.toml
[font]
size = 14  # Smaller for more content
# size = 18  # Larger for presentations

​
Changing Opacity

alacritty.toml
[window]
opacity = 1.0    # Fully opaque
# opacity = 0.85  # More transparent
# opacity = 0.96  # Default (subtle transparency)

​
Alternative Color Schemes

The config includes a commented-out Sakura theme:
To switch themes, uncomment the Sakura theme section and comment out the Kanagawa section in alacritty.toml:4-42.

​
Troubleshooting

​
Colors Look Wrong

1

Check TERM variable

Ensure TERM="xterm-256color" is set in the config or your shell profile.
2

Verify terminal info

echo $TERM
# Should output: xterm-256color
3

Test colors

curl -s https://gist.githubusercontent.com/HaleTom/89ffe32783f89f403bba96bd7bcd1263/raw/ | bash

​
Font Not Rendering

Make sure IosevkaTerm Nerd Font is installed system-wide, not just in your user fonts directory.
# Verify font installation
fc-list | grep -i iosevka

# macOS: Check Font Book
open -a "Font Book"

​
Option/Alt Key Not Working (macOS)

Ensure this line is in your config: 
[window]
option_as_alt = "Both"

​
Performance Tuning

Alacritty is already optimized, but you can tweak:
alacritty.toml
[window]
# Reduce padding for more space
padding.x = 0
padding.y = 0

[scrolling]
# Adjust scrollback buffer
history = 10000  # Default: 10000 lines

​
Comparison with Other Terminals

AspectAlacrittyWezTermKitty
Startup Speed⚡⚡⚡⚡⚡⚡⚡
Memory Usage~15MB~50MB~30MB
Built-in Tabs❌✅✅
Lua Config❌✅❌
Simplicity⭐⭐⭐⭐⭐⭐
Customization⭐⭐⭐⭐⭐⭐⭐⭐

​
Next Steps

Tmux Configuration

Add tabs and splits with tmux

Zsh Configuration

Configure your shell environment

Neovim Setup

Complete your development environment

Terminal Overview

Compare all terminal options

​
Resources

Build docs developers (and LLMs) love

Get started for freeTalk to us