Configuração de Hyprland + Quickshell + Neovim, organizada em pacotes do GNU Stow e com um sistema de temas que troca o desktop inteiro de uma vez.
dotfiles/
├── install.sh instalação numa máquina nova
├── packages.txt pacotes que a configuração precisa
├── packages-extra.txt apps, toolchains e hardware (só com --extra)
├── packages/ os pacotes do stow (é o -d do stow)
├── profiles/ quais pacotes cada tipo de máquina linka
├── themes/ paletas + templates dos temas
├── zen-themes/ estilos do Zen Browser (CSS; as cores vêm de themes/)
└── wallpapers/
git clone <repo> ~/dotfiles
cd ~/dotfiles
./install.sh # ou ./install.sh --dry para só ver o que fariaO que ele faz, em ordem: instala os pacotes de packages.txt com o paru
(compilando o paru antes, se preciso), limpa symlinks de um layout antigo,
linka os pacotes em ~, aplica o tema, copia os arquivos de system/ para a
raiz, habilita os serviços (NetworkManager,
power-profiles-daemon, keyd, bluetooth, systemd-timesyncd e os timers
fstrim e paccache, além do hyprpolkitagent no systemd do usuário), roda o
xdg-user-dirs-update, troca seu shell para zsh e baixa os plugins do tmux e
do neovim. Serviço de pacote que não está instalado é pulado, então o
bluetooth e o paccache só entram com --extra.
Cada etapa é pulável — --skip-packages, --skip-services, --skip-plugins
— e tudo é idempotente: rodar de novo não quebra nada.
packages.txt tem só o que algum arquivo do repositório chama de fato — config,
script de packages/bin, keybind do Hyprland, módulo do waybar ou tema. É o
suficiente para a configuração funcionar, e é o que o install.sh instala por
padrão.
packages-extra.txt é o resto do que está instalado na máquina de referência:
apps pessoais, toolchains, bancos e pacotes presos ao hardware (intel-ucode,
nvidia-open-dkms, sbctl). Só entra com ./install.sh --extra, e vale
revisar antes de rodar em outro computador.
Dependências transitivas não aparecem em nenhuma das duas — o paru resolve. As
duas juntas também não são o paru -Qeq literal: o que caiu em desuso foi
tirado de propósito. Para comparar com o que está instalado hoje:
paru -Qeq # pacotes explícitos
paru -Qmq # os que vieram do AURSobra só o que não dá para automatizar: reiniciar a sessão do Hyprland e abrir
o Zen Browser uma vez (o perfil só existe depois disso) e rodar theme set de
novo para criar os symlinks de CSS dentro dele.
Cada diretório dentro de packages/ é um pacote independente, com a estrutura
que ele terá dentro de ~:
packages/waybar/.config/waybar/style.css -> ~/.config/waybar/style.css
packages/zsh/.zshrc -> ~/.zshrc
packages/bin/.local/bin/theme -> ~/.local/bin/theme
O wrapper dots cuida do stow:
dots list # pacotes disponíveis
dots status # o que está linkado
dots link # linka tudo
dots link nvim waybar # linka só alguns
dots link --except nvim # linka tudo menos alguns
dots unlink waybar
dots relink nvim # depois de renomear/mover arquivos
dots migrate # limpa symlinks quebrados que apontam para o repo
dots adopt btop # importa para o repo o que já existe em ~
dots link --profile server # linka a lista de outro perfil
dots link --dry # simuladots status distingue links ausentes, destinos incorretos e links quebrados.
Também procura links antigos que apontem para o repositório, mesmo quando o
arquivo de origem já foi removido. A busca inclui os links diretamente em ~
e os diretórios usados pelos pacotes, como ~/.config/nvim e ~/plugins/luar,
sem seguir symlinks de diretórios nem percorrer toda a home. Diretórios antigos
que já não correspondem a nenhum pacote podem ficar fora dessa busca.
O status só informa; use dots link <pacote> para arquivos novos e
dots relink <pacote> depois de renomear ou remover arquivos. Destinos que
sejam arquivos reais ou apontem para outro lugar precisam ser revisados antes.
--except aceita lista separada por vírgula (--except nvim,waybar) e pode ser
repetido. Vale para link, unlink e relink, e não combina com uma lista de
pacotes — ou você diz quais quer, ou quais não quer. Os nomes são conferidos
contra o dots list, então errar a grafia dá erro em vez de linkar tudo
caladamente, e a comparação é de nome inteiro: excluir nvim não leva o
nvim-plugins junto.
No Zsh, Tab completa os subcomandos e opções de dots e theme, além das
opções de ./install.sh. Pacotes, perfis e temas são lidos do repositório;
--except também completa listas separadas por vírgula. As funções ficam no
pacote zsh, em ~/.config/zsh/completions, carregadas antes do compinit.
Depois de adicionar esses arquivos, rode dots link zsh e reabra o Zsh.
O install.sh repassa a mesma flag, para pular configs já na instalação nova:
./install.sh --except nvim,waybardots migrate existe para quando o stow recusa com "existing target is not
owned by stow": são links de um layout anterior, apontando para caminhos que
não existem mais. Ele só remove symlinks que apontam para dentro deste
repositório e já não resolvem — arquivo de verdade, diretório e link para
outro lugar ficam intactos. O install.sh roda isso antes de linkar.
dots adopt é o caminho inverso do link: em vez de instalar a versão do
repositório, ele traz para o repositório a que já está em ~. Use quando a
config boa é a que está na máquina. Ele exige o repositório limpo e mostra o
diff no fim, porque o --adopt do stow sobrescreve os arquivos versionados
sem avisar. Se a versão boa é a do repositório, o caminho é o outro: apague o
arquivo de ~ e rode dots link.
dots sempre usa --no-folding. Isso é importante: sem ele o stow criaria
~/.config/waybar como um symlink para o repositório, e aí qualquer arquivo
gerado ali dentro sujaria o git. Com --no-folding, ~/.config/waybar é um
diretório de verdade, com symlinks dos arquivos versionados e os arquivos
de cor gerados convivendo lado a lado.
O stow só escreve em ~. O que vive em /etc fica em system/, com o mesmo
caminho a partir da raiz (system/etc/keyd/default.conf -> /etc/keyd/default.conf),
e o install.sh copia com sudo em vez de linkar. Hoje é só a config do keyd.
O perfil server pula essa etapa.
Por ser cópia, editar o arquivo do repositório não muda nada até você rodar
./install.sh de novo, ou copiar e recarregar na mão:
sudo install -Dm644 system/etc/keyd/default.conf /etc/keyd/default.conf
sudo keyd reloadEditar direto em /etc também não volta para o repositório: copie de volta
antes de commitar.
O mesmo repositório serve duas máquinas bem diferentes. desktop é a de
referência: Arch, Hyprland, zsh, neovim com plugins. server é máquina sem
desktop nenhum: bash, tmux, neovim pelado.
./install.sh --profile serverCada perfil é um arquivo em profiles/ listando os pacotes do stow que aquela
máquina quer, um por linha. O server deixa de fora o Hyprland, o waybar, o
quickshell, o rofi, os emuladores de terminal, o zathura e o zsh.
O perfil escolhido fica em ~/.local/state/dotfiles/profile, ao lado do
current-theme. É de lá que o dots, o theme e o neovim leem depois, cada
um por conta própria — a variável DOTFILES_PROFILE sobrepõe, o que é útil
para testar. Sem o arquivo, todos assumem desktop, então uma máquina que
nunca rodou o install.sh novo continua se comportando como antes.
O que muda de fato em cada perfil:
| desktop | server | |
|---|---|---|
| pacotes linkados | todos | profiles/server |
| pacotes do sistema | packages.txt via paru |
na mão, com o gerenciador da distro |
| serviços do systemd | habilitados | pulados |
| shell padrão | trocado para zsh | fica como está |
| plugins do nvim | baixados | nada a baixar |
| templates de tema | os 15 | só os que não precisam de desktop |
No neovim o lua/NeoVim/profile.lua decide entre o modo completo e o
mínimo. No mínimo o init.lua sai cedo, sem tocar em vim.pack, e quem assume
é o lua/NeoVim/server/. Lá está o que no completo vem de plugin — LSP nativo
de pyright e ruff, o navegador de diretórios nativo (ou netrw nas versões sem
nvim.dir), o wildmenu da cmdline e os keymaps de marca, que fazem as vezes
do harpoon. O núcleo (set.lua, remap.lua,
autocmd.lua, custom/statusline.lua, custom/align.lua) é o mesmo arquivo
nos dois, e o nvim.undotree também vale para os dois.
O modo segue o perfil (o servidor fica no mínimo), mas a variável
DOTFILES_NVIM sobrepõe, porque nem todo servidor dispensa os plugins e nem
toda máquina local os quer. Para fixar numa máquina, exporte no
~/.bashrc.local; para uma vez só, prefixe o comando:
export DOTFILES_NVIM=full # servidor com plugins, baixados na 1ª abertura
DOTFILES_NVIM=minimal nvim # sem plugins só desta vezNuma máquina emprestada dá para usar o nvim mínimo direto do clone, sem linkar
nada (sem o ~/plugins/luar o colorscheme cai no habamax):
XDG_CONFIG_HOME=~/dotfiles/packages/nvim/.config DOTFILES_NVIM=minimal nvimO wildmenu nativo é só do modo mínimo de propósito: no completo quem completa a
cmdline é o blink.cmp, e os dois brigariam pelas mesmas teclas. É por ele que
passa o :Find (<leader>pf), que faz as vezes do telescope: a lista de
arquivos vem do rg, com cache por cwd, e quem filtra e realça é o próprio nvim,
via fuzzy no wildoptions ligado só enquanto a cmdline é desse comando.
O neovim do servidor vem do gerenciador da distro, que costuma estar bem atrás
do Arch, então o server/ testa antes de usar o que é recente. O piso é o
0.11, de onde saem o vim.lsp.config e o winborder; abaixo disso a
config sobe sem LSP. O autocompletar da cmdline (wildtrigger(), pumborder)
e o nvim.undotree são do 0.12 e ficam de fora sozinhos quando não
existem. O navegador nvim.dir é detectado pelo módulo disponível no runtime;
no desktop, o Oil continua responsável pelos diretórios.
No navegador nativo do servidor, <leader>pv e - abrem o diretório pai,
e <leader>pr retorna ao último diretório visitado;
<C-b> abre a entrada em split horizontal e <C-s> recarrega a lista e os
metadados. <leader>i
alterna permissões, tamanho e data; links mostram o destino e executáveis
recebem destaque. Downloads e Imagens usam os arquivos mais recentes primeiro,
pela data de criação quando disponível ou pela modificação. A coluna de data
mostra o mesmo valor usado na ordenação; nas outras pastas, mostra a modificação.
Os atalhos _, gh e gd levam à raiz do projeto, Home e Downloads. + cria
pastas, R pede apenas o novo nome, M pede a pasta de destino com completação
de diretórios e d apaga com confirmação. M mantém o nome do arquivo. Renomear
ou mover recusa destinos existentes. Nomes com $ são tratados literalmente;
~ e ~/ no início do destino de M ou + apontam para Home. gi abre as
imagens na ordem da listagem se o imv estiver instalado.
Nos dois modos, <leader>pw preenche :edit com o diretório do buffer atual,
inclusive dentro do Oil, do navegador nativo e do netrw. No servidor,
<leader>fe mantém o mesmo atalho usado na configuração anterior. Ao salvar
um arquivo em uma pasta inexistente, o Neovim pergunta se deve criá-la.
Nos shells e no tmux não há chave de perfil: cada ferramenta extra vem
atrás de um teste. O .bashrc e o .zshrc usam o starship se ele existir e
caem num prompt próprio se não, e o mesmo vale para fzf, zoxide e fnm; o
.tmux.conf só define wl-copy como copy-command e só cria o popup de cores
se o que eles precisam estiver instalado. O tmux não usa gerenciador de plugins.
Para o que for de uma máquina só, os três leem um arquivo não versionado no fim:
~/.bashrc.local,
~/.zshrc.local e ~/.tmux.conf.local.
No Hyprland, o zsh reconecta à sessão main existente antes de carregar
plugins e o prompt. A primeira criação da sessão mantém a inicialização
completa para preparar o ambiente. Se houver ~/.zshrc.local, a entrada no
tmux continua no fim, depois dos ajustes locais.
O Zsh mantém entradas únicas no PATH e garante os diretórios pessoais também
dentro do tmux. Cada shell inicializa seu próprio ambiente do fnm, retirando
do seu PATH as entradas do diretório de ambientes do fnm herdado. Isso cobre
o caso em que o tmux recebe PATH e FNM_MULTISHELL_PATH de ambientes diferentes.
Os diretórios permanecem disponíveis para os outros shells que os utilizam.
O prompt do Starship é atualizado ao voltar o foco para o terminal ou painel
do tmux. Isso reflete trocas de branch feitas no Lazygit ou em outra janela,
preservando o comando que estiver sendo digitado. O tmux precisa manter
focus-events on, já habilitado na configuração.
No Zsh, entrar em um projeto ativa a .venv ou o ambiente existente do
micromamba indicado por um arquivo .mamba-env com o nome do ambiente, por
exemplo vgiws. A busca inclui os diretórios pais e usa a indicação mais
próxima; na mesma pasta, .mamba-env tem prioridade. O marcador é apenas texto,
não um script, e fica no ignore global do Git. O micromamba usa
MAMBA_ROOT_PREFIX, com ~/micromamba como padrão.
Ao sair, o hook desativa somente o ambiente que ativou automaticamente.
Ambientes já ativos manualmente são preservados. O Starship mostra o nome do
ambiente ativo no prompt, tanto para .venv quanto para micromamba. Depois
de alterar essa configuração, rode theme reload e reabra o Zsh.
theme # seletor (rofi no Hyprland, fzf no terminal)
theme list
theme current
theme set rose-pine-moon
theme show # imprime a paleta ativa com as cores no terminal
theme reload # reaplica o tema atual (depois de editar templates)Também está no menu do rofi-script em Setup → Tema.
Temas disponíveis: rose-pine-moon (padrão), rose-pine, rose-pine-dawn
(o único claro), catppuccin-mocha, tokyonight-moon.
themes/<tema>/theme.sh a paleta, em nomes genéricos
+
themes/templates/*.in um template por programa
=
~/.config/<programa>/colors arquivos gerados, fora do git
O theme set lê a paleta, roda cada template do themes/templates/manifest e
escreve o resultado direto em ~. Nada gerado entra no repositório.
Todo tema define as mesmas chaves, para que um template sirva para qualquer tema. Os nomes são genéricos de propósito — o "yellow" do Rosé Pine é o gold, o "cyan" é o rose:
| grupo | chaves |
|---|---|
| fundo | base surface overlay term_bg (só o alacritty; os outros usam base) |
| realces | highlight_low highlight_med highlight_high |
| texto | text subtle muted |
| ANSI | black red green yellow blue magenta cyan white (+ bright_*, que caem no normal se não forem definidos) |
| papéis | accent accent_alt success warning error info match (trecho que casou com a busca; cai em info se não for definido) brand brand_alt (identidade: relógio e perfil Desempenho do Quickshell, indicador de grupo travado do Hyprland, logo e gradientes do Zen, sessão do tmux e caixa de processos do btop; caem no accent e no accent_alt) |
| sintaxe | syn_comment syn_string syn_escape syn_constant syn_keyword syn_operator syn_type syn_function syn_variable syn_parameter syn_tag syn_attribute |
As cores básicas também podem identificar controles: no Quickshell, o volume
usa blue e o brilho usa yellow (gold no Rosé Pine). Os papéis descrevem
estados ou funções: um aviso usa warning, mesmo que hoje tenha a mesma cor
de yellow. Compartilhar uma cor não reserva seu uso a um único significado.
Escolha a chave pela intenção: mudar warning deve alterar os avisos sem
recolorir o brilho. Para foco e seleção, use accent; para identidade visual,
brand e brand_alt. Não crie um papel por componente quando uma cor básica
já expressa a escolha.
Mais os metadados: variant (dark/light), nvim_colorscheme, zen_theme,
wallpaper, gtk_theme, cursor_theme, e os estilos de sintaxe
syn_comment_style, syn_keyword_style, syn_parameter_style e
syn_attribute_style (valores: bold, italic, underline ou vazio).
O grupo de sintaxe é opcional e existe para o caso de o colorscheme do editor
discordar da paleta. Sem ele, cada syn_* cai num default derivado dos papéis
(syn_keyword vira accent_alt, syn_string vira warning, e assim por
diante), que é o que os temas de colorscheme externo usam.
Quem declara o grupo inteiro é o rose-pine-moon e o rose-pine-dawn, os dois
que rodam o luar. O luar não traz paleta: ele é uma distribuição de papéis
(poucas cores com função, identificador e operador sem tinta, tipos discretos)
e lê estes valores pelo lua/theme.lua gerado. Então o bloco
syn_* não é uma cópia do colorscheme, é a fonte dele, e é o mesmo bloco que
faz o preview do yazi bater com o buffer ao lado. Os dois temas usam a mesma
distribuição, com o dawn trocando a tinta das strings por medida de contraste (ver os
comentários no themes/rose-pine-dawn/theme.sh). A interface não sai da
sintaxe: cursor, item selecionado e foco usam o accent, e a busca usa o match.
No Moon, o Luar oferece quatro variantes de sintaxe: luar-aurora usa syn_type
para tipos e construtores; luar-bruma usa syn_type_lavanda nos dois;
luar-eclipse usa tipos lavanda e construtores pine. luar-crepusculo usa
a mesma combinação da Eclipse, com comentários em syn_comment_rose.
Strings, booleanos e interface são compartilhados; detalhes auxiliares
continuam neutros mesmo na Crepúsculo. luar usa Eclipse por padrão.
Em Python, os construtores usam o mesmo dourado das funções nas quatro variantes.
Nos temas que não definem syn_type_lavanda, todas usam a mesma cor de tipos.
Para comparar na sessão do Neovim:
:colorscheme luar-aurora
:colorscheme luar-bruma
:colorscheme luar-eclipse
:colorscheme luar-crepusculoPara escolher a variante padrão, altere nvim_colorscheme no theme.sh do
tema, rode theme reload e reabra o Neovim. A troca por :colorscheme afeta
apenas o editor; as prévias de código do Yazi e do Glow continuam usando
syn_type.
gtk_theme e cursor_theme são nomes de diretório em /usr/share/themes,
/usr/share/icons, ~/.local/share/icons e ~/.themes. Vazios, o theme não
escreve a chave correspondente no gsettings. É o nome do diretório mesmo, e não
o Name= do index.theme: o do BreezeX tem acento (BreezeX-RoséPine contra
BreezeX-RosePine-Linux) e a busca do XCursor, que é por diretório, não acha.
Quem manda no cursor é o XCURSOR_THEME, por dois caminhos: o theme set gera
o ~/.config/uwsm/env-hyprland, que o uwsm sourceia no login, e roda
hyprctl setcursor para a sessão que já está de pé. O
sync_gsettings_theme = true do Hyprland vai na direção contrária do que
parece: ele republica o XCURSOR_THEME no gsettings, sobrepondo a chave que o
próprio theme escreve ali. Por isso o valor precisa sair do tema nos dois
lugares; hardcodado no uwsm/env ele vencia o tema em toda troca.
O color-scheme do gsettings não depende de nenhum dos dois: sai sempre de
variant, porque é o que o xdg-desktop-portal-gtk republica como
org.freedesktop.appearance, e é daí que o Zen tira o esquema das páginas e os
apps GTK4 tiram o deles. Trocar de tema muda o esquema do Zen na hora, sem
reabrir. O que o Zen não segue sozinho é o esquema do chrome: ele tem uma
preferência própria, browser.theme.toolbar-theme, e enquanto ela estiver
fixada em claro ou escuro o light-dark() do CSS interno vai contra a paleta.
Deixe em Automático (Configurações → Aparência) para o navegador inteiro seguir
o tema.
Os apps GTK e Qt não seguem por gsettings sob Hyprland, que não tem daemon de
XSettings: seguem pelos arquivos, e por isso o settings.ini do GTK e o
qt6ct.conf são templates como qualquer outro (ver a tabela acima). O theme
deriva de variant o gtk-application-prefer-dark-theme e a base do tema de
ícones do qt6ct.
O settings.ini decide só claro contra escuro; a paleta em si vem do gtk.css
gerado em cada versão, que é a folha de estilo do usuário e é lida depois do
tema, sobrepondo as cores nomeadas que o Adwaita definiu. São dois arquivos
porque são vocabulários diferentes: o GTK3 usa theme_bg_color e companhia, e
o libadwaita usa window_bg_color, view_bg_color, headerbar_bg_color, que
desde a versão 1.6 são variáveis CSS com os @define-color de mesmo nome
sobrando como compatibilidade. O arquivo do GTK4 traz os três vocabulários, o
terceiro sendo os theme_* do Adwaita embutido, para o app GTK4 que não usa
libadwaita.
O alcance dos dois é muito diferente, e é por isso que o arquivo do GTK3 é
bem maior que a lista de @define-color sugere. Medindo os dois stylesheets
que vêm compilados nas bibliotecas:
| literais de cor | var(--) e @nomeada |
responde a override | |
|---|---|---|---|
| Adwaita do GTK3 | 1247 | 39 | 3% |
| libadwaita 1.9 | 411 | 1130 | 73% |
Ou seja, no GTK3 o @define-color sozinho não muda nada visível: o Adwaita
resolveu as cores para hex na hora de compilar. Por isso o gtk3-colors.css.in
traz, além dos @define-color, um bloco de regras reais para as superfícies que
dominam a tela: janela, barra de título, botão, campo, lista, popover, aba,
barra de rolagem e seleção. Como a folha do usuário tem prioridade maior que a
do tema, essas regras vencem os literais. O que elas não alcançarem continua no
cinza do Adwaita.
No libadwaita não é preciso nada disso para as superfícies: ele ignora o
gtk-theme-name e as variáveis são tudo que ele tem. As exceções são a dica de
contexto, fixada em preto 80% com texto branco, e o link, derivado do
--accent-color; as duas viram regra explícita nos dois arquivos, para
acompanharem o ToolTipBase e o Link do Qt.
Os papéis são os mesmos do qt6ct-colors.conf.in, para os dois toolkits caírem
na mesma cor: surface na janela, base no conteúdo, overlay no que precisa
se destacar da janela sem virar conteúdo.
Os ícones do Breeze são SVG de um traço só, com fill:currentColor e um bloco
.ColorScheme-* { color: ... } embutido. No Plasma quem reescreve esse bloco
conforme o esquema ativo é o KIconThemes; sob o qt6ct esse motor não existe,
então cada ícone sai na cor gravada no arquivo. Na prática: botão de diálogo
todo branco, e o que for de destaque no azul do KDE, seja qual for a paleta.
O apply_icons do theme gera então um tema em
~/.local/share/icons/dotfiles/, apontado pelo icon_theme do qt6ct, que
herda o Breeze da variante (breeze-dark ou breeze) e reescreve esse bloco.
Só a lista ICON_RECOLOR é recolorida, e não o tema inteiro: o Breeze tem
19844 SVG e 41M, e copiar tudo a cada theme set custaria caro para pintar
ícone que ninguém olha. O que ficar de fora resolve no tema herdado, com as
cores originais.
A substituição é por nome de classe, não por valor: o Breeze usa cinco azuis
diferentes de Accent, então casar pelo hex erraria. Nos ícones de status,
que são crachá de disco mais glifo vazado, o glifo também é trocado, por base:
branco sobre o dourado do warning ficaria ilegível.
Como o destino é um diretório de vários arquivos com os tamanhos descobertos em
tempo de execução, isso não cabe no manifest; fica no theme, como o
apply_zen.
Os ícones do GTK seguem fora disso, em AdwaitaLegacy: são um conjunto
próprio, já coerente entre si, e não saem da paleta.
Nos templates, cada chave tem quatro formas:
| placeholder | resultado |
|---|---|
{{base}} |
#232136 |
{{base:hex}} |
232136 |
{{base:rgb}} |
rgb(232136) |
{{base:argb}} |
0xff232136 |
| programa | arquivo gerado | como consome |
|---|---|---|
| hyprland | ~/.config/hypr/conf/colors.lua |
require("conf.colors") em appearance.lua |
| hyprlock | ~/.config/hypr/conf/colors.conf |
source = no topo do hyprlock.conf |
| hyprpaper | ~/.config/hypr/hyprpaper.conf |
arquivo inteiro (vem do wallpaper= do tema) |
| hyprtoolkit | ~/.config/hypr/hyprtoolkit.conf |
paleta, fontes e ícones do seletor de compartilhamento e demais apps do toolkit |
| waybar | ~/.config/waybar/colors.css |
@import no style.css |
| rofi | ~/.config/rofi/themes/colors.rasi |
@import no center.rasi |
| quickshell | ~/.config/quickshell/modules/Theme.qml |
singleton Theme |
| alacritty | ~/.config/alacritty/colors.toml |
general.import |
| ghostty | ~/.config/ghostty/colors |
config-file = colors |
| zathura | ~/.config/zathura/colors |
include "colors" |
| starship | ~/.config/starship.toml |
arquivo inteiro (starship não tem include) |
| tmux | ~/.config/tmux/colors.conf |
source-file -q no fim do .tmux.conf |
| tmux (perfil server) | ~/.config/tmux/server-colors.conf |
source-file -q no fim do server.conf |
| neovim | ~/.config/nvim/lua/theme.lua |
require("theme") em plugins/colors.lua |
| btop | ~/.config/btop/themes/dotfiles.theme |
color_theme = "dotfiles" no btop.conf |
| lazygit | ~/.config/lazygit/colors.yml |
LG_CONFIG_FILE junta com o config.yml (não tem include) |
| yazi | ~/.config/yazi/theme.toml |
camada de override sobre o tema embutido |
| yazi (preview) | ~/.config/yazi/theme.tmTheme |
[mgr] syntect_theme no theme.toml, com caminho absoluto |
| zen browser | <perfil>/chrome/colors.css e zen-logo.svg |
@import no userChrome.css do estilo |
| gtk | ~/.config/gtk-3.0/settings.ini e gtk-4.0/settings.ini |
arquivo inteiro (o GTK não tem include) |
| gtk3 (cores) | ~/.config/gtk-3.0/gtk.css |
folha do usuário, sobrepõe os @define-color do tema |
| gtk4 (cores) | ~/.config/gtk-4.0/gtk.css |
idem, no vocabulário do libadwaita |
| qt | ~/.config/qt6ct/qt6ct.conf e qt6ct/colors/dotfiles.conf |
custom_palette + color_scheme_path |
| cursor | ~/.config/uwsm/env-hyprland |
XCURSOR_THEME sourceado pelo uwsm no login |
Do hyprland ao zathura, e mais o gtk, o qt e o cursor, tudo é marcado como
desktop na terceira coluna do manifest e não é gerado no perfil servidor. O
server-colors.conf é o inverso: só sai no perfil servidor. O neovim
consome o theme.lua por dois caminhos: plugins/colors.lua no modo completo e
lua/NeoVim/server/init.lua no mínimo, que aplica o colorscheme sem plugin.
O Zen é o único que não passa pelo manifest: o diretório do perfil tem nome
sorteado, então quem escolhe o destino é o apply_zen do theme.
O seletor de compartilhamento do portal usa hyprtoolkit e tem configuração
própria, independente do Qt/GTK. O theme reload gera sua paleta com fundos
neutros, seleção em accent e as mesmas fontes e ícones do Qt. Feche o
seletor e abra uma nova solicitação de compartilhamento para conferir.
Essa configuração também vale para os demais aplicativos do hyprtoolkit;
o layout do seletor é definido pelo programa.
cp -r themes/rose-pine-moon themes/meu-tema
$EDITOR themes/meu-tema/theme.sh
theme set meu-temaO theme valida na hora: reclama se faltar alguma cor ou se algum valor não
for um #rrggbb.
- Escreva
themes/templates/<programa>.inusando os placeholders. - Adicione a linha correspondente no
themes/templates/manifest. A terceira coluna é opcional: liste os perfis em que ela vale (desktop), ou deixe vazia para valer em todos. - Faça a config do programa incluir o arquivo gerado.
theme reload.
-
Hierarquia de cores: contornos estruturais usam neutros; foco e seleção usam
accent, e a identidade fica em detalhes como o relógio, o nome da sessão do tmux e o gradiente suavizado da aba selecionada do Zen. No Hyprland, o foco se distingue pela bordamuted, contraoverlaynas inativas. Grupos têm uma faixa superior segmentada de 3 px, sem títulos: o segmento ativo usaaccent, oubrandquando travado (brand_altsebrandeaccentcoincidirem). No btop, as caixas preservam as cores por categoria e a seleção usa texto neutro para manter o contraste. No tmux, a borda ativa usaaccent, com exceções de cor para modo de cópia e painéis sincronizados. Os ícones da barra do Zen também usamaccent. -
Zoom do Hyprland:
Super+Zalterna entre 1× e 1,5×; quando já há ampliação, volta para 1×.Super+Shift+=eSuper+-ajustam em passos de 0,1× e repetem enquanto a tecla estiver pressionada.Super+Ctrl+rodaajusta em passos de 0,2×: para cima aumenta, para baixo diminui. O intervalo é de 1× a 3×;Super+rodacontinua trocando workspaces. O atraso global dos atalhos de scroll é zero para evitar que eventos intermediários cheguem ao aplicativo; a troca de workspaces pela roda também fica imediata. O zoom amplia a imagem já renderizada e não substitui o ajuste de fonte da aplicação. -
Zen Browser:
zen_themeescolhe só o estilo (defaultounebula), que é CSS escrito à mão; as cores saem dotheme.shcomo em qualquer outro programa.theme setaponta~/.zen/<perfil>/chrome/{themes,userChrome.css, userContent.css}parazen-themes/<zen_theme>/e escrevecolors.cssezen-logo.svgno mesmo diretório. O perfil vem doDefault=da seção[Install...]doprofiles.ini, que é o que o navegador abre de fato. Precisa reiniciar o navegador. -
Quickshell — central: o card Sistema abre o btop e Energia alterna o perfil de energia. A data no topo leva ao estado 1 com o calendário aberto. No ícone de volume, o clique esquerdo alterna o mudo e o direito abre o mixer; as trilhas aceitam arrasto e scroll. Controles indisponíveis mostram “—” e a bateria só aparece quando detectada. Captura de tela, microfone/câmera em uso e alertas de temperatura e bateria permanecem visíveis nos três estados, inclusive durante o OSD de volume e brilho. Na central, esse grupo aparece acima dos cards apenas quando ativo. No estado 1, a bateria baixa mantém o ícone e o percentual na cor de erro. Nesse estado, scroll sobre o volume ajusta de 5 em 5 pontos; no ícone, clique esquerdo alterna o mudo e direito abre o mixer. O percentual e o restante do bloco abrem a central. Enquanto o ponteiro estiver sobre o volume, seus ajustes não substituem o controle pelo OSD. O sino também aparece no estado 1 quando há notificações não lidas ou DND ativo, em um único indicador com contagem. Clicar nele abre a central; abrir o estado 1 não marca as notificações como lidas. As notificações identificam o aplicativo e têm um botão de fechar; a expiração pausa enquanto o ponteiro está sobre o card ou seus botões. Os dois-pontos do relógio usam
brandcomo detalhe de identidade; os números mantêm a cor de texto e os controles preservam suas próprias cores. Os valores de CPU e memória usam atenção a partir de 80% e crítico a partir de 95%; a temperatura usa 80 °C e 90 °C. As cores vêm dewarningeerrordo tema. Para sair de cada estado, o valor precisa cair abaixo de cinco pontos do limite, evitando oscilações. A consulta ocorre a cada dois segundos. Os limites de temperatura são referências visuais, não limites de segurança do hardware; o sensor usado éthermal_zone0. O ícone de temperatura acompanha o mesmo nível e a mesma margem de retorno do valor exibido na central. O perfil Desempenho usabrandcomo identificação visual, sem depender da cor de aviso. -
Quickshell — ocultar:
Super+Balterna a exibição da island e libera os 40 px reservados no topo.Super+Dabre a central eSuper+Shift+Eabre o relógio mesmo no modo oculto; ao fechar, a island volta a se ocultar. Volume e brilho aparecem temporariamente, e as notificações continuam funcionando. Captura de tela, uso do microfone ou câmera, alerta de temperatura e bateria baixa mantêm a island visível e o espaço reservado enquanto o estado durar. O Quickshell inicia com a island visível. -
Quickshell — gravação:
Super+Shift+Bsuspende as aparições automáticas da island, inclusive os indicadores de captura, microfone, câmera e alertas, os OSDs de volume e brilho e os popups de notificações. Também libera os 40 px do topo; ative antes de começar a gravação para evitar mover as janelas durante o vídeo. O monitoramento continua e as notificações ficam no histórico, respeitando o limite e o descarte habitual das transitórias. Os popups já abertos saem da tela e não reaparecem ao desativar o modo.Super+DeSuper+Shift+Eainda abrem a island manualmente; ao fechar, ela volta a ficar oculta. RepetirSuper+Shift+Brestaura a preferência anterior de visibilidade;Super+Bsai do modo e mostra a island. O modo de gravação inicia desativado e não altera o “não perturbe”. -
quickshell e o systray: os ícones da barra são glifos de Nerd Font e trocam de cor na recarga, como o resto. Os do systray e os das notificações não: são imagens resolvidas pelo tema de ícones do Qt, que o Qt fixa uma vez, quando a
QGuiApplicationnasce. Nem o hot reload do quickshell nem o observador de arquivo do qt6ct refazem essa resolução. O nome do tema não muda mais entre temas, mas o conteúdo dele sim, porque os ícones passaram a ser recoloridos pela paleta, então otheme setavisa em toda troca. -
Neovim: o tema escolhe o colorscheme (
nvim_colorscheme), não as cores uma a uma. Se o plugin do colorscheme não estiver instalado, o nvim avisa e cai nohabamax. -
~/plugins: o pacotenvim-pluginslinka os plugins locais (luar,present) em~/plugins, que é onde ocolors.luaos procura noruntimepath. -
Tema atual: fica em
~/.local/state/dotfiles/current-theme, e o perfil da máquina em~/.local/state/dotfiles/profile, ao lado. -
Wallpaper: cada tema declara o seu, e o
rofi-script wallpapertroca só a imagem, sem trocar de tema. O seletor mostra um preview à direita ao navegar pela lista e só aplica a escolha comEnter. Os previews ficam em~/.cache/rofi/wallpaperse são refeitos quando a imagem muda. A primeira entrada, "Sem wallpaper", encerra o hyprpaper e deixa à mostra omisc:background_colordo Hyprland, nobasedo tema. É assim porque o hyprpaper 0.8 perdeu o IPC deunload: não há como pedir que ele apague o fundo sem sair. A escolha fica em~/.local/state/dotfiles/no-wallpaper, o marcador que faz oautostart.luanão subir o hyprpaper e otheme setgerar o path vazio, no hyprpaper.conf e no$wallpaperque o hyprlock usa. Escolher uma imagem apaga o marcador e sobe o hyprpaper de volta. Transição animada na troca não existe: o hyprpaper não tem nada disso, e quem tem é oswww. -
tmux-sessionizer: a lista vem do zoxide (tudo que você já visitou, por frecência) mais as raízes de
~/.config/tmux-sessionizer/paths. Projeto clonado fora das raízes aparece depois do primeirocd. Os diretórios de~/.configque vêm de um pacote são excluídos automaticamente — lá são só symlinks, e uma sessão ali não fica dentro do repositório; o alvo certo é~/dotfiles/packages/<pkg>. O que não é do repositório continua aparecendo. Linha começando com-no arquivo de paths exclui à mão. -
tmux — cores: mesma divisão do lazygit. O
.tmux.confversionado tem só comportamento, e as cores vêm de~/.config/tmux/colors.conf, gerado pelotheme set. Aqui o tmux tem include de verdade, então basta osource-file -qno fim do arquivo; o-qé o que deixa o tmux subir antes do primeirotheme set, quando o arquivo ainda não existe, só com as cores padrão. Sessão já aberta não pega o tema novo sozinha:prefix + r. Após editar os templates de cores,theme reloadregenera os arquivos e recarrega o tmux. A barra mantém a sessão à esquerda, janelas comuns no centro e scratches à direita. A janela ativa e o scratch ativo usam a mesma cor de destaque;prefixaparece enquanto o tmux aguarda a segunda tecla do atalho. Nomes longos são abreviados apenas na barra, preservando os nomes reais. -
lazygit — cores: o
config.ymlversionado tem só comportamento; o tema sai dotheme setem~/.config/lazygit/colors.yml. Como o lazygit não tem include, quem junta os dois é oLG_CONFIG_FILE, definido em dois lugares: no.zshrc, para quando você rodalazygitna mão, e notmux-lazygit, porque a janela pode ser aberta por um atalho do tmux. Sem a variável o lazygit ainda sobe — só sem tema. Antes do primeirotheme setocolors.ymlnão existe, e os dois lugares checam isso antes de montar a lista (arquivo faltando na lista impede o lazygit de iniciar). -
lazygit — onde ele roda: numa janela scratch do tmux, por
Alt+Shift+Iouprefix+gno terminal ou<leader>gsno nvim. Os atalhos chamamtmux-lazygit, que usatmux-popup, assim como python (prefix+P), cores (prefix+H) e shell (M-O). -
Janelas scratch do tmux: cada sessão tem suas janelas
_scratch_<nome>_, com índices a partir de 100 e indicadores à direita da barra. Repetir o atalho volta à última janela comum, mesmo depois de alternar entre ferramentas. Se essa janela foi fechada, o retorno escolhe outra comum; se não houver nenhuma, abre uma nova. O programa do scratch continua aberto.prefix+n/prefix+ppercorrem somente as janelas comuns,prefix+lvolta à anterior e os seletoresprefix+s/prefix+wfiltram os scratches.prefix+kencerra apenas o scratch atual e não faz nada numa janela comum;prefix+Xencerra todos os scratches da sessão. No perfil server,n/pcontinuam trocando sessões ek/lcontinuam selecionando os índices 3/4. A renumeração automática fica desligada: fechar uma janela mantém os números das demais, e uma nova reutiliza a primeira vaga disponível. Recarregar a configuração migra os scratches antigos para os índices altos sem perder o foco. -
lazygit — editar:
tmux-nvim-editabre o arquivo em um Neovim existente na mesma sessão, fora das janelas scratch, e seleciona seu painel. Se não houver Neovim, cria uma janela nova. O número da linha é opcional; caminhos com espaços, acentos e caracteres especiais são preservados. -
Navegação no Neovim: no modo completo,
<leader>pvabre o Oil e<leader>pfabre o picker de arquivos do Telescope. No mínimo, os mesmos atalhos usam o navegador nativo (ou netrw) e o:Find, respectivamente. As integrações com Yazi foram removidas; suas configurações antigas permanecem disponíveis no repositório. -
Resultados no Neovim: nos modos completo (local/desktop) e mínimo (server),
:grep(:gr),:vimgrepe:makedigitados na linha de comandos abrem e focam o quickfix sem saltar para o primeiro resultado. Os equivalentes:lgrep,:lvimgrepe:lmakeusam a location list da janela. Sem resultados válidos, a lista é fechada e aparece um aviso.:Compilesegue a mesma regra;-lescolhe a location list. Em scripts e chamadas Lua, use:Grep,:Vimgrep,:Makeou seus equivalentes com prefixoLpara esse fluxo. O Telescope no modo completo e a navegação do LSP mantêm seus comportamentos. -
Formatação Lua: o Conform usa StyLua, declarado em
packages.txt.<leader>fformata manualmente e:FormatTogglealterna a formatação ao salvar. -
btop: ele reescreve o
btop.confao sair quando você muda alguma opção, e como o arquivo é um symlink, isso suja o repositório. Rodegit statusdepois de mexer nas configurações dele. -
mimeapps: o "abrir sempre com" de um app GTK reescreve o
~/.config/mimeapps.listtrocando o arquivo inteiro, e o symlink vira um arquivo comum. A mudança não aparece nogit status, e o próximodots linkrecusa o arquivo; traga o que quiser manter comdots adopt mimeapps. -
rbw: o
~/.config/rbw/config.jsonfica fora do repositório porque leva o e-mail da conta, e o JSON não tem include. Numa máquina nova:rbw config set email <e-mail>erbw config set pinentry ~/.local/bin/pinentry-wayland. -
Clipboard (
SUPER+Y, ou Setup → Clipboard):Entercopia,alt+pfixa ou solta,alt+dapaga a entrada,alt+wlimpa o histórico. Os fixados vão para~/.local/share/clipboard-pins, um arquivo por entrada, e sobrevivem aoalt+w— o cliphist não tem pin, isso é dorofi-script. Fixar e apagar atualizam a lista na mesma janela, preservando a busca. A confirmação de limpeza também aparece na mesma janela; copiar ou cancelar encerram o menu. Imagens, inclusive fixadas, aparecem num painel de preview à direita que acompanha a seleção, com rótulos de formato e dimensões. O ImageMagick ajusta os previews ao painel sem recortar a imagem. As miniaturas e seus metadados ficam em${XDG_CACHE_HOME:-$HOME/.cache}/rofi/clipboard/440x440-v1, identificados pelo hash do conteúdo, e são reutilizados entre aberturas. Ao fechar o menu, são removidos os itens do cache sem referência na última listagem do histórico ou dos fixados. As imagens originais decodificadas ficam apenas em um diretório temporário por abertura, removido ao fechar. O diretório de cache e os arquivos novos são privados ao usuário. Imagens novas ainda precisam da primeira geração; a decodificação e o cálculo do hash continuam necessários para validar o conteúdo nas aberturas seguintes. Entradas de texto mostram um ícone de documento e “Conteúdo de texto”; outros conteúdos sem prévia e imagens que não carregaram têm mensagens próprias. Os placeholders usam a corsubtlee são reutilizados durante a abertura do menu. -
Git: o pacote
gitversiona~/.config/git/config. Sua identidade fica fora do repositório, em~/.config/git/config.local(o include é ignorado se o arquivo não existir). Atenção: o git lê~/.gitconfigdepois do arquivo XDG, então um~/.gitconfigantigo sobrescreve o que está aqui — mova o que quiser manter para oconfig.locale apague o resto.