Este tutorial cobre a instalação de um ambiente gráfico mínimo com i3wm em uma máquina virtual KVM/QEMU rodando Debian minimal (netinst, sem ambiente de desktop). Ao final, você terá o i3 com configuração adaptada para teclado ABNT2, barra de status funcional e integração SPICE (ajuste de resolução e área de transferência compartilhada).
Os atalhos de teclado do dia a dia estão no cheatsheet i3wm: Atalhos de teclado.
sudospice-vdagent)ç para foco à direita (veja a nota na seção 4 se o seu for US)# Atualizar repositórios
sudo apt update
# Essencial para rodar Xorg + i3 (suckless-tools fornece o dmenu)
sudo apt install xorg i3-wm i3status suckless-tools
# Terminal leve e editor de texto
sudo apt install xfce4-terminal vim
# Navegador (o pacote de idioma já instala o firefox-esr)
sudo apt install firefox-esr-l10n-pt-br
# Wallpaper, gerenciador de arquivos gráfico e seletor de temas
sudo apt install feh pcmanfm lxappearance
# Integração com a VM (resolução dinâmica, copy/paste)
sudo apt install spice-vdagent
# Utilitários usados pelo autostart da configuração (seção 4)
sudo apt install i3lock xss-lock dex network-manager-gnome
Importante: o último grupo (
i3lock,xss-lock,dex,network-manager-gnome) é exigido pelas linhasexecda configuração do i3. Sem esses pacotes, o i3 exibe erros de autostart no primeiro login.
cat > ~/.xinitrc << 'EOF'
# Tenta definir resolução 1920x1080 na saída Virtual-1 (comum em VMs KVM)
if xrandr | grep -q "Virtual-1 connected"; then
xrandr --output Virtual-1 --mode 1920x1080
fi
exec i3
EOF
Se a resolução não for aplicada, rode
xrandrdentro da sessão gráfica para descobrir o nome correto da saída (pode serVirtual-0,Virtual1, etc.) e ajuste o.xinitrc.
sudo systemctl enable --now spice-vdagentd
Crie o diretório e o arquivo de configuração:
mkdir -p ~/.config/i3
cat > ~/.config/i3/config << 'EOF'
# ~/.config/i3/config
# ---------------------------------------------------------------------------------
# 1. Configurações gerais
# ---------------------------------------------------------------------------------
# Tecla modificadora (Mod4 = tecla Super/Win):
set $mod Mod4
# Tecla para atuar com o mouse sobre janelas:
floating_modifier $mod
# Habilita arrastar pela barra de título ou pela tecla modificadora:
tiling_drag modifier titlebar
# ---------------------------------------------------------------------------------
# 2. Espaços de trabalho
# ---------------------------------------------------------------------------------
set $ws1 "1"
set $ws2 "2"
set $ws3 "3"
set $ws4 "4"
set $ws5 "5"
set $ws6 "6"
set $ws7 "7"
set $ws8 "8"
set $ws9 "9"
set $ws10 "10"
bindsym $mod+1 workspace number $ws1
bindsym $mod+2 workspace number $ws2
bindsym $mod+3 workspace number $ws3
bindsym $mod+4 workspace number $ws4
bindsym $mod+5 workspace number $ws5
bindsym $mod+6 workspace number $ws6
bindsym $mod+7 workspace number $ws7
bindsym $mod+8 workspace number $ws8
bindsym $mod+9 workspace number $ws9
bindsym $mod+0 workspace number $ws10
bindsym $mod+Shift+1 move container to workspace number $ws1
bindsym $mod+Shift+2 move container to workspace number $ws2
bindsym $mod+Shift+3 move container to workspace number $ws3
bindsym $mod+Shift+4 move container to workspace number $ws4
bindsym $mod+Shift+5 move container to workspace number $ws5
bindsym $mod+Shift+6 move container to workspace number $ws6
bindsym $mod+Shift+7 move container to workspace number $ws7
bindsym $mod+Shift+8 move container to workspace number $ws8
bindsym $mod+Shift+9 move container to workspace number $ws9
bindsym $mod+Shift+0 move container to workspace number $ws10
# ---------------------------------------------------------------------------------
# 3. Aparência
# ---------------------------------------------------------------------------------
# Fonte das barras de título das janelas
font pango:monospace 8
# Definições do painel:
bar {
status_command i3status
}
# ---------------------------------------------------------------------------------
# 4. Teclas de ação
# ---------------------------------------------------------------------------------
# Matar janela em foco:
bindsym $mod+Shift+q kill
# Mudar foco com teclas da fila central do teclado (ABNT2: j k l ç):
bindsym $mod+j focus left
bindsym $mod+k focus down
bindsym $mod+l focus up
bindsym $mod+ccedilla focus right
# Mudar foco com teclas de direção:
bindsym $mod+Left focus left
bindsym $mod+Down focus down
bindsym $mod+Up focus up
bindsym $mod+Right focus right
# Mover janelas com teclas da fila central do teclado:
bindsym $mod+Shift+j move left
bindsym $mod+Shift+k move down
bindsym $mod+Shift+l move up
bindsym $mod+Shift+ccedilla move right
# Mover janelas com teclas de direção:
bindsym $mod+Shift+Left move left
bindsym $mod+Shift+Down move down
bindsym $mod+Shift+Up move up
bindsym $mod+Shift+Right move right
# Próxima janela será aberta à direita:
bindsym $mod+h split h
# Próxima janela será aberta abaixo:
bindsym $mod+v split v
# Alterna tela cheia da janela em foco:
bindsym $mod+f fullscreen toggle
# Alternar layouts:
bindsym $mod+s layout stacking
bindsym $mod+w layout tabbed
bindsym $mod+e layout toggle split
# Alternar tiling / floating:
bindsym $mod+Shift+space floating toggle
# Alterna foco entre as janelas tiling / floating:
bindsym $mod+space focus mode_toggle
# Muda o foco para o container pai:
bindsym $mod+a focus parent
# Recarregar as configurações:
bindsym $mod+Shift+c reload
# Reiniciar a sessão preservando o ambiente:
bindsym $mod+Shift+r restart
# Terminar a sessão do i3:
bindsym $mod+Shift+e exec "i3-nagbar -t warning -m 'You pressed the exit shortcut. Do you really want to exit i3? This will end your X session.' -B 'Yes, exit i3' 'i3-msg exit'"
# Definição do modo 'resize':
mode "resize" {
bindsym j resize shrink width 10 px or 10 ppt
bindsym k resize grow height 10 px or 10 ppt
bindsym l resize shrink height 10 px or 10 ppt
bindsym ccedilla resize grow width 10 px or 10 ppt
bindsym Left resize shrink width 10 px or 10 ppt
bindsym Down resize grow height 10 px or 10 ppt
bindsym Up resize shrink height 10 px or 10 ppt
bindsym Right resize grow width 10 px or 10 ppt
bindsym Return mode "default"
bindsym Escape mode "default"
bindsym $mod+r mode "default"
}
# Início do modo resize:
bindsym $mod+r mode "resize"
# ---------------------------------------------------------------------------------
# 5. Início de programas
# ---------------------------------------------------------------------------------
# Lançador de programas (dmenu):
bindsym $mod+d exec --no-startup-id dmenu_run
# Terminal:
bindsym $mod+Return exec i3-sensible-terminal
# ---------------------------------------------------------------------------------
# 6. Autostart
# ---------------------------------------------------------------------------------
# Início de programas por lançadores .desktop (padrão XDG)
exec --no-startup-id dex --autostart --environment i3
# Bloqueio de tela integrado à suspensão
exec --no-startup-id xss-lock --transfer-sleep-lock -- i3lock --nofork
# Ícone de rede na barra
exec --no-startup-id nm-applet
EOF
Teclado US (sem ç): substitua
ccedillaporsemicolon(;) nas quatro linhas de foco/movimentação e no modo resize — o;ocupa a mesma posição física da teclaçno ABNT2.
mkdir -p ~/.config/i3status
cat > ~/.config/i3status/config << 'EOF'
general {
colors = true
interval = 5
}
order += "ipv6"
order += "ethernet _first_"
order += "disk /"
order += "load"
order += "memory"
order += "tztime local"
ethernet _first_ {
format_up = "E: %ip (%speed)"
format_down = "E: down"
}
disk "/" {
format = "%avail"
}
load {
format = "%1min"
}
memory {
format = "%used | %available"
threshold_degraded = "1G"
format_degraded = "MEMORY < %available"
}
tztime local {
format = "%Y-%m-%d %H:%M:%S"
}
EOF
startx
Como a configuração já foi criada na seção 4, o assistente de primeira execução do i3 não será exibido. Se ele aparecer (config ausente ou em outro caminho), pressione
Enterpara aceitar as configurações padrão e depois substitua o arquivo gerado.
| Sintoma | Causa provável | Solução |
|---|---|---|
Tela preta ao rodar startx |
Xorg não instalado ou .xinitrc ausente |
Confira sudo apt install xorg e o conteúdo de ~/.xinitrc |
| Resolução não ajusta para 1920x1080 | Nome da saída não é Virtual-1 |
Rode xrandr na sessão gráfica e ajuste o .xinitrc com o nome correto |
| Copy/paste com o host não funciona | spice-vdagent parado ou canal SPICE ausente na VM |
systemctl status spice-vdagentd e confira o canal SPICE no virt-manager |
| Erros de autostart ao abrir o i3 | Pacotes da seção 1 (grupo final) não instalados | sudo apt install i3lock xss-lock dex network-manager-gnome |
| Foco à direita não funciona | Teclado US (sem ç) |
Troque ccedilla por semicolon na config (seção 4) |
| Barra sem informações | Config do i3status no caminho errado | O arquivo deve estar em ~/.config/i3status/config |