Personalizando WezTerm no Linux

Hoje vamos falar de um emulador de terminal ainda subestimado por muitos desenvolvedores Linux: o WezTerm. Vamos ver suas principais features e como fazer uma customização simples.

O que é?

O WezTerm é um poderoso emulador de terminal cross-platform e multiplexer criado por Wez Furlong com base em Rust.

Diferenciais

Disponível para quase todas as distribuições (consulte a documentação oficial)
GPU Acceleration – renderização acelerada por placa de vídeo
Suporte ao protocolo de imagens do iTerm
Moderno e altamente customizável via Lua

Exemplo de uso do protocolo de imagem do iTerm

Principais features

Multiplex nativo – Gerencia painéis (panes), abas e janelas localmente e em hosts remotos (SSH), com suporte a mouse e scrollback. Funciona como um tmux integrado.
Ligaduras e fontes – Suporte a ligaduras tipográficas (ex: ->, != viram um único glifo), emojis coloridos e fallback de fontes. Você pode misturar fontes sem quebras.
True color e temas dinâmicos – 24 bits por canal (16 milhões de cores) e troca de esquema de cores em tempo real.
Scrollback pesquisável – Navegue com roda do mouse ou Shift+PageUp/PageDown. Busque com Ctrl+Shift+F.
Múltiplas janelas – O atalho padrão Super+N (tecla Windows + N) abre uma nova janela independente. Atenção: dependendo do seu gerenciador de janelas (GNOME, KDE, etc.), esse atalho pode ser capturado pelo sistema antes de chegar ao WezTerm. Se não funcionar, verifique os atalhos do seu WM ou redefina a combinação no arquivo de configuração.
Configuração via Lua – Todo o comportamento, atalhos e aparência em um único arquivo Lua. Permite lógica condicional e reaproveitamento.

Pré‑requisitos

WezTerm instalado – recomendo via Flatpak (comando: flatpak install org.wezfurlong.wezterm)
Conhecimento básico de programação (ajuda, mas não é obrigatório)

Criando nosso primeiro tema

Passo 1 – Criar o arquivo de configuração

O WezTerm aceita o arquivo de configuração em dois locais. Escolha o que melhor se encaixa no seu setup:

~/.wezterm.lua – caminho direto na pasta pessoal, mais simples
~/.config/wezterm/wezterm.lua – segue o padrão XDG, recomendado para setups modernos que organizam configs em ~/.config

Para criar o arquivo pelo terminal (escolha um dos dois):

nano ~/.wezterm.lua
# ou
mkdir -p ~/.config/wezterm && nano ~/.config/wezterm/wezterm.lua

⚠️ Evite ter os dois arquivos ao mesmo tempo. O WezTerm prioriza ~/.wezterm.lua — se ambos existirem, o que está em ~/.config/wezterm/ será ignorado.

Passo 2 – Configuração mínima com tema, fonte e transparência

Cole o seguinte código:

-- Arquivo: ~/.wezterm.lua (ou ~/.config/wezterm/wezterm.lua)
local wezterm = require 'wezterm'

return {
  -- Tema (você pode trocar por qualquer nome listado com o comando abaixo)
  color_scheme = 'Catppuccin Mocha',   -- ou 'OneDark', 'Solarized Dark', etc.

  -- Fonte com fallback para evitar erros (exemplo com Fira Code)
  font = wezterm.font_with_fallback({
    'Fira Code',
    'JetBrains Mono',
    'Monospace',
  }),
  font_size = 14.0,

  -- Transparência de fundo (0.0 = transparente, 1.0 = opaco)
  window_background_opacity = 0.95,

  -- Opcional: esconde a barra de abas quando só há uma
  enable_tab_bar = false,
}

Salve (Ctrl+O, Enter, Ctrl+X). O WezTerm recarrega automaticamente – você verá o tema novo e a transparência aplicados na hora (o que alias, é muito legal 😁).

Passo 3 – Corrigindo erro de fonte (se aparecer)

Se você vir uma mensagem como Unable to load a font specified by your font=wezterm.font('Fira Code'..., é porque a fonte não foi encontrada. As soluções:

Instalar a fonte (Fedora): sudo dnf install fira-code-fonts
Usar fallback – o código acima já inclui font_with_fallback, que tenta outras fontes automaticamente.

💡 Dica bônus: Em distribuições como Ubuntu/Debian, instale a Fira Code com sudo apt install fonts-firacode.

Dicas Extras

Existem centenas de temas prontos para WezTerm. Para ver a lista completa, use o REPL Lua embutido no Debug Overlay:

Digite e execute linha a linha:

Abra o Debug Overlay com Ctrl+Shift+L
Digite e execute linha a linha:

t = wezterm.get_builtin_color_schemes()
for k in pairs(t) do print(k) end

Os nomes dos temas disponíveis aparecerão listados direto no overlay — é só copiar o que quiser e colar no campo color_scheme do seu arquivo de configuração.

Você também pode encontrar mais temas e dicas de personalização na documentação oficial, que é constantemente atualizada pela comunidade.

Conclusão

WezTerm é uma excelente opção de terminal moderno, tanto pela facilidade de uso quanto pelas funções integradas e alta personalização. Com o avanço do Linux desktop, a aceleração por GPU em terminais é mais do que bem‑vinda.

Agora é a sua vez: teste as configurações, quebre e remende o arquivo Lua, e me conta nos comentários ou lá no @coisa_de_dev qual tema você escolheu! 🚀