Manual / Documentação atual do desktop

& Editores de Terminais

Kitty, tmux, cmux TUI, LazyVim, VS Code, banners de tarefas e histórico de shell.

Este é o Manual do desktop, publicado a partir do mesmo catálogo gerado. Botões, painéis e menus se referem ao desktop instalado. As atualizações podem ser mais recentes que a ISO disponível. Consulte o escopo de instalação e validação.

SUPER + Enter abre o terminal escolhido (Kitty por padrão). SUPER + Ctrl + Enter abre ou conecta à sessão principal do tmux. SUPER + P busca arquivos por correspondência aproximada; SUPER + Ctrl + P busca no conteúdo. Aprender > Comandos Cmux, Comandos Tmux e Comandos LazyVim são referências pesquisáveis; selecionar um comando o copia, sem executá-lo.

O Kitty mostra uma trilha curta em saltos de pelo menos duas células, como Enter, Home/End ou movimentos entre palavras. Ela começa após o cursor ficar parado por 3 ms e desaparece em 0,05–0,15 segundo. Ajuste cursor_trail, cursor_trail_decay ou cursor_trail_start_threshold em ~/.config/kitty/local.conf; cursor_trail 0 desativa a trilha. Suas opções têm prioridade sobre as do pacote e são mantidas nas trocas de tema.

Fogo do cursor

Configurações > Estilo > Terminal > Fogo do cursor oferece Desativado (padrão) e Ativado. Ativado usa o efeito cursor-trail-blaze integrado do Kitty nos movimentos do cursor, sem detectar velocidade de digitação. Desativado restaura a trilha rápida normal e a seleção pessoal de shader.

O efeito exige Kitty 0.49+ e shader-slang, incluídos nas dependências do Eitr. A ativação valida o shader antes de salvar ou recarregar o Kitty. A preferência local fica em ~/.config/eitr/terminal.json; o auxiliar escreve kitty/cursor-fire.conf, incluído por último pelo carregador do usuário. Ativado, escolhe o shader de fogo e reduz o limiar para uma célula. Fontes, temas e configurações pessoais permanecem intactos.

Escolher o terminal

Configurações > Estilo > Terminal no Walker e Central de controle > Estilo > Terminal oferecem Kitty (padrão) e Ghostty. O campo local terminal em ~/.config/eitr/terminal.json controla Super+Enter, tmux, sessões do usuário, terminais de IA/projetos e ações do Walker para abrir no terminal. Se Ghostty não estiver instalado, escolhê-lo abre o fluxo normal de instalação do pacote oficial: Enter instala e Esc cancela. Kitty continua selecionado até a instalação terminar com sucesso. Se Ghostty for removido depois, os lançamentos usam Kitty. Ghostty é opcional e não faz parte do conteúdo da ISO.

Trocar o tema regenera ~/.config/ghostty/eitr.conf com as 16 cores ANSI e as cores de fundo, texto, seleção e cursor de texto. Alterar a fonte atualiza a família escolhida; o tamanho padrão é 10 pontos. Ghostty usa o mesmo zsh e prompt, por padrão com 75% de opacidade e sem espaçamento interno em janelas normais. Hyprland fornece desfoque, decorações e regras normais de janela. Família, tamanho e escolha Auto/Claro/Escuro do ponteiro em eitr/cursor.json continuam valendo pelo GTK e compositor, separados do cursor de texto.

O lançador do Eitr carrega o arquivo gerado. Coloque ajustes pessoais como font-size = 12 ou cursor-style = bar em ~/.config/ghostty/local.conf, carregado por último e preservado nas trocas de tema. Sessões abertas recebem o sinal de recarga suportado após mudar tema ou fonte. Algumas opções só afetam novas janelas. O rastro e o Fogo do cursor do Kitty são exclusivos dele; Ghostty não tem uma opção Blaze integrada equivalente.

Os terminais de tarefas, menus, status e configuração do Eitr sempre usam Kitty, incluindo eitr-menu-terminal, eitr-plugins e fif-terminal: suas opções --class, --hold, --title e regras de janelas flutuantes dependem do Kitty. Escolher Ghostty não os altera.

Aparência do terminal e desfoque compartilhado

Configurações > Estilo > Terminal e Central de controle > Estilo > Terminal aplicam opacidade, espaçamento interno e desfoque ao Kitty e ao Ghostty. A opacidade oferece Sólido (100%), Leve (90%), Médio (80%), Padrão (75%) e Forte (70%). O espaçamento oferece Nenhum, Pequeno (4 pontos) e Confortável (8 pontos). Os padrões mantêm 75% de opacidade, nenhum espaçamento e desfoque ativado. Terminais utilitários mantêm seu fundo sólido e espaçamento de tarefas.

Desativar o desfoque o remove das janelas normais do Kitty e do Ghostty, sem torná-las opacas. A intensidade é compartilhada por toda a área de trabalho: Leve (tamanho 2, uma passagem), Média (tamanho 3, duas passagens, padrão) e Forte (tamanho 5, três passagens). A mesma escolha aparece em Barra da área de trabalho no Walker e Barra na Central de controle, junto da aparência. O Hyprland 0.57 só oferece intensidade global; a escolha afeta painéis, notificações, Visão geral e outros aplicativos que já usam desfoque. Escolher uma intensidade não ativa o desfoque do terminal. Desfoque mais forte exige mais da GPU. Cor do tema mantém a aparência sólida.

As escolhas do terminal ficam em eitr/terminal.json; blur-strength compartilhado fica em quickshell/desktop-bar/bar-settings.json (versão 1). Essas preferências regeneram kitty/appearance.conf, ghostty/eitr.conf e hypr/appearance.lua. O compositor carrega a aparência antes de hypr/local.lua, preservando a prioridade das regras pessoais. kitty/local.conf e ghostty/local.conf têm prioridade sobre os presets. Trocas de tema e atualizações do pacote regeneram os arquivos. Kitty recebe SIGUSR1 e sessões compatíveis do Ghostty recebem SIGUSR2; opções sem suporte a recarregamento valem para novas janelas.

O comando eitr

eitr reúne as ferramentas do Eitr; execute-o sem argumentos para listar opções. Usa os mesmos scripts dos menus, mantendo o mesmo comportamento.

eitr update                  # System Update: snapshot, packages, AUR, Flatpak
eitr update aur              # only AUR packages, without a snapshot
eitr theme list              # installed themes, the current one marked *
eitr theme set "Eitr" # switch theme
eitr firewall on             # also: off, status
eitr snapshots               # recovery snapshots
eitr snapshots changes       # what each update changed
eitr reset keep-files        # factory reset, after the usual two warnings
eitr report                  # prepare a problem report
eitr handbook troubleshooting
eitr version
eitr about

eitr about abre a janela de informações do Eitr ou traz a janela existente para o primeiro plano.

eitr config e eitr git encaminham argumentos para eitr-config e eitr-git. Cada comando oferece --help.

Seus próprios hooks

Um hook é um pequeno script seu que o Eitr executa em um momento específico, permitindo ampliar o comportamento sem alterar o Eitr. Coloque um executável com o nome desse momento em ~/.config/eitr/hooks/:

Arquivo Quando executa Argumento recebido
post-update após Atualização do sistema ou atualização pacman/AUR system, pacman, yay ou full
theme-set após trocar o tema nome da pasta do tema
battery-low uma vez sempre que a bateria cai para 15% percentual
post-boot no primeiro login após cada inicialização nenhum

Por exemplo, para recolorir o Spotify com Spicetify a cada troca de tema, crie ~/.config/eitr/hooks/theme-set:

#!/usr/bin/env bash
spicetify config color_scheme "$1" && spicetify apply

Torne-o executável com chmod +x ~/.config/eitr/hooks/theme-set. Cada hook pode levar até 60 segundos; saída e falhas vão para ~/.local/state/eitr/hooks.log. Uma falha nunca interrompe a atualização ou troca de tema. eitr hook list lista os hooks existentes; eitr hook run theme-set eitr testa um. Atualizações nunca alteram essa pasta.

cmux TUI

Execute cmux no Kitty ou cmux --session work para nomear a sessão. cmux TUI é opcional, ao lado do tmux; não substitui Kitty nem seus atalhos. Novas instalações incluem um binário oficial com versão fixada em /usr/bin/cmux; instalações pessoais anteriores podem ter prioridade no PATH. Confira com command -v cmux. less é incluído para ler saídas e arquivos de texto.

O prefixo padrão é Ctrl-b: solte as teclas e pressione a próxima.

Atalho Ação
Ctrl-b ? Mostrar atalhos atuais
Ctrl-b W Criar espaço de trabalho
Ctrl-b c Criar tela
Ctrl-b % / Ctrl-b " Dividir à direita / abaixo
Ctrl-b t Nova aba de terminal
Ctrl-b h/j/k/l Focar esquerda/abaixo/acima/direita
Ctrl-b s Mostrar/ocultar barra lateral
Ctrl-b d Sair localmente ou desconectar de um servidor

Para continuar a sessão sem a interface, execute cmux --headless --session work e depois cmux attach --session work para reconectar. Abas de navegador exigem Chrome/Chromium. Fechar abas, painéis ou espaços pode afetar tarefas em execução; confira antes. Aprender > Comandos Cmux inclui comandos de sessão, navegação, mouse e fechamento. Os padrões podem mudar ou ser personalizados; Ctrl-b ? é a referência atual.

Terminais de tarefas

Terminais abertos por menus e pelas notificações de atualização e relatório ficam centralizados sobre suas janelas, com fundo sólido do tema. Sessões de assistentes de IA e projetos LazyVim, em Desenvolvimento, abrem como janelas normais em mosaico, com fundo translúcido, assim como terminais abertos por você. Terminais comuns são interativos e não exibem marca. Instalação, atualização e configuração mostram o banner rúnico do EITR; tarefas bem-sucedidas normalmente fecham, falhas permanecem até serem dispensadas. Relatórios informativos podem ficar abertos. Reiniciar o Elephant não deve fechar aplicativos lançados: aplicativos e terminais abertos por menus, atalhos e botões da barra usam escopos de aplicação separados em uma sessão uwsm. Sem uwsm, eles são iniciados diretamente. O Elephant mantém o encerramento somente do processo para auxiliares da área de trabalho e inicializações sem uwsm.

Pressione Esc para fechar terminais de tarefas, contas, relatórios e Sobre que aguardam uma tecla. Enter continua sendo usado para respostas e confirmações, incluindo confirmar que a chave de recuperação foi anotada e desligar o instalador.

Histórico do shell

history lista comandos recentes. No zsh, confira o caminho real com:

printf '%s\n' "$HISTFILE"

Para abri-lo no Neovim:

nvim "$HISTFILE"

O histórico pode conter tokens e credenciais; não o copie para relatórios de problemas. Feche outros shells antes de editar manualmente, pois podem gravar o histórico ainda em memória. O histórico estendido do zsh pode conter horários e comandos de várias linhas: remova a entrada inteira, não um fragmento arbitrário. Faça um backup privado se precisar desfazer.

Aparência dos editores

Trocas de tema atualizam as preferências geradas de VS Code e LazyVim. Sessões LazyVim compatíveis atualizam sem reabrir. Suas personalizações e plugins podem escolher cores próprias; confira a configuração se um editor não acompanhar o desktop. A fonte padrão só é integrada onde o aplicativo oferece suporte.