omarchy-omakase

Um overlay pessoal sobre o Omarchy (Arch + Hyprland), aplicado por um script idempotente: terminal, editor, config do gerenciador de janelas, uma barra Quickshell com painéis e helpers de uso de agentes.

Shell · QMLpersonalpessoalBase Omarchy (Arch, Hyprland)Ponto de entrada setup.shShell Quickshell (QML)Linguagem de config Hyprland Luagithub.com/javabetatester/omarchy-omakase

Visão geral

O omarchy-omakase é um overlay sobre o Omarchy. Ele não reinstala o gerenciador de janelas: copia um rice pessoal para os diretórios de configuração do usuário e nunca edita /usr/share/omarchy.

Tudo é aplicado por um único script, setup.sh, dividido em módulos. Cada módulo faz backup do que sobrescreve e qualquer módulo pode ser rodado de novo. Um script anterior que reescrevia o hyprland.conf inteiro e remendava QML com sed foi abandonado em favor deste modelo de overlay.

PeçaO que traz
TerminalKitty, com o tema do Omarchy incluído e Ctrl+Shift+Q desvinculado para não fechar a janela
EditorNeovim com LazyVim: explorador, terminal inferior, painel de problemas
Gerenciador de janelasConfig de usuário do Hyprland em ~/.config/hypr (Lua), carregada depois dos padrões do Omarchy
BarraUma barra e painéis Quickshell, rodando ao lado do shell do omarchy
PromptStarship

Rodar

backuppkgsnvimhypr$HOMEpass 1: installpkgsnvimhyprpass 2: already there, skip
Cada módulo é instalado uma vez e os arquivos sobrescritos têm backup; uma segunda execução encontra tudo já no lugar.

Pré-requisito: Omarchy no Arch. Sem ele o overlay ainda copia arquivos, mas algumas chamadas IPC do Hyprland precisam do Omarchy; o setup.sh avisa quando não o detecta.

sh
git clone https://github.com/javabetatester/archin-coding.git
cd archin-coding
chmod +x setup.sh
./setup.sh all

Sem argumentos o setup.sh abre um menu. Você também pode nomear módulos, ou listá-los:

sh
./setup.sh              # interactive menu
./setup.sh nvim
./setup.sh kitty nvim
./setup.sh hypr
./setup.sh --list

Depois de uma execução, hyprctl reload costuma bastar para binds antigos. Abra o nvim uma vez para o Lazy terminar a sincronização de plugins.

MóduloEm allO que faz
packagessimnvim, kitty, thunar, ripgrep, fd, lazygit, grim, slurp, wl-clipboard, playerctl, pavucontrol, python-pywal e mais
kittysimInstala ~/.config/kitty/kitty.conf
nvimsimOverlay do LazyVim; clona o starter se não existir config; adiciona o extra neo-tree; sync do Lazy em headless
hyprsimBinds, visual, input, regras de janela, KEYBINDS.md em ~/.config/hypr
scriptssimScripts auxiliares em ~/.config/scripts, launcher da barra em ~/.local/bin
starshipsim~/.config/starship.toml
barsimRice do Quickshell em ~/.config/quickshell e helpers de contas em ~/.local/bin
extrassimThunar, KDE Connect, mpd-mpris, Vesktop do AUR quando há um helper
shellsimalias cls='clear' adicionado ao .bashrc (e ao .zshrc se existir)
hypr-monitorsnãomonitors.lua para uma máquina específica; pule em outro hardware

O que muda

Os arquivos ficam só sob o diretório home. Antes de cada sobrescrita, o arquivo anterior é copiado para um diretório de backup.

CaminhoEscrito por
~/.config/hypr/*.lua, KEYBINDS.mdhypr
~/.config/hypr/monitors.luahypr-monitors
~/.config/kitty/kitty.confkitty
~/.config/nvim/ (overlay, lazyvim.json)nvim
~/.config/quickshell/bar
~/.config/scripts/scripts
~/.local/bin/ (launcher da barra, helpers de contas, chaves)scripts, bar
~/.config/starship.tomlstarship
~/.dotfiles-backup-archin-<timestamp>/Backups de todo arquivo sobrescrito

As cópias nunca apagam arquivos extras no destino: archin_install_tree faz backup dos arquivos que colidem e copia por cima, deixando todo o resto no lugar.

Arquitetura

Omarchy basehyprkittynvimstarship + scriptsbaroverlay
O Omarchy é a base; cada módulo do overlay é uma camada copiada por cima.

setup.sh faz source de lib/common.sh e de cada modules/*.sh. Cada módulo se registra com archin_register e expõe uma função archin_install_<name>; o runner mapeia um nome de módulo para essa função e a chama.

text
setup.sh
  |-- lib/common.sh   archin_pkg, archin_aur, archin_backup,
  |                   archin_install_file, archin_install_tree, archin_ensure_line
  |-- modules/*.sh    archin_register <name> <desc>; archin_install_<name>
  `-- overlay/        files copied as-is into $HOME
        hypr/  kitty/  nvim/  quickshell/  scripts/  local-bin/
        starship.toml  hypr-monitors/
  • archin_pkg roda pacman -S --needed --noconfirm; archin_aur usa yay ou paru e avisa quando nenhum existe.
  • archin_install_file faz backup do destino e depois copia um arquivo do overlay.
  • archin_install_tree percorre um diretório do overlay com find, fazendo backup e copiando cada arquivo.
  • archin_ensure_line adiciona uma linha a um arquivo só quando ela ainda não está lá, o que torna o módulo shell idempotente.

Início da sessão

Como as peças ganham vida no login, pela config de usuário do Hyprland.

  1. 1Os padrões do Omarchy carregamhyprland.lua faz o bootstrap do Omarchy, requer seus padrões e depois os arquivos do usuário: monitors, input, bindings, looknfeel, autostart.
  2. 2O autostart rodaautostart.lua lança kdeconnect-indicator e mpd-mpris quando presentes, inicia a barra por start-archin-bar.sh e depois roda agent-usage-refresh.sh.
  3. 3A barra sobe sozinhastart-archin-bar.sh roda qs -n -d -p ~/.config/quickshell. Nunca faz pkill do quickshell pelo nome, porque isso mataria o shell do omarchy.
  4. 4Os binds alternam painéisOs bindings chamam o shell por IPC (por exemplo launcher toggle, dashboard toggle, music toggle); shell.qml guarda as flags de visibilidade de cada overlay.

Teclas do Hyprland

Super é a tecla Windows. Super+K abre o tutorial. Fonte: overlay/hypr/KEYBINDS.md.

TeclasAção
Super + EnterTerminal (Kitty)
Super + Shift + EnterTerminal flutuante
Super + DLauncher
Super + EThunar
Super + ADashboard (agentes)
Super + MPainel de música
Super + XBloquear tela (hyprlock)
Super + Shift + KChaves: copiar uma senha (rbw)
Super + Ctrl + Shift + KChaves: copiar um código 2FA
MenuDefine (dicionário)
TeclasAção
Super + Shift + Q, Super + WFechar janela
Super + Shift + Space, Super + Shift + VAlternar flutuante
Super + FTela cheia
Super + P, Super + JPseudo, alternar split
Super + setasMover o foco
Super + Shift + setasMover a janela
Super + Ctrl + setasRedimensionar a janela
Super + Tab, Super + Shift + TabPróxima, anterior janela
Super + 1 a 5Ir para o workspace 1-5
Super + Shift + 1 a 5Mover a janela para o workspace
Super + scrollTrocar de workspace
Super + S, Super + Shift + SWorkspace especial, mover para ele
Super + N, Super + Shift + NAbrir, fechar notificações
TeclasAção
F1, F2, F3Mudo, diminuir volume, aumentar volume
Print, Shift + PrintCaptura de tela, captura de área
Super + R, Super + Shift + RIniciar, parar gravação
Super + SpaceLauncher de apps (wofi)
Super + C, Super + VCopiar, colar
Super + Ctrl + VHistórico da área de transferência
Super + EscapeMenu de saída (wlogout)
Super + Alt + SpaceMenu do Omarchy

Quando uma tecla é reutilizada, bindings.lua chama hl.unbind primeiro e depois o.bind, para o padrão do Omarchy não conflitar. As regras de janela na mesma pasta definem a opacidade por classe de app e fazem mpv, floatingterm e scratchterm flutuarem; as regras de camada aplicam blur em todo namespace que começa com archin-.

Neovim e Kitty

O leader é Space. Fonte: overlay/nvim/KEYBINDS.md, também copiado para ~/.config/nvim/KEYBINDS.md.

TeclasAção
Ctrl+EExplorador
Ctrl+'Terminal inferior, abrir ou ocultar
Ctrl+Shift+'Novo terminal
2 e depois Ctrl+'Terminal 2
Ctrl+H/J/K/LTrocar de split, também de dentro do terminal
Space tk, Ctrl+Shift+QEncerrar o painel de terminal
Esc Esc e depois QEncerrar o terminal em foco
Space xxProblemas (lint)
]d, [dPróximo, anterior diagnóstico
Space SpaceBuscar arquivo
gd, KIr para a definição, hover

Rode o módulo kitty junto com o nvim. Sem map ctrl+shift+q no_op no kitty.conf, Ctrl+Shift+Q fecha o emulador inteiro em vez do painel de terminal.

Barra e painéis

musicagentswifivault
A barra Quickshell é uma faixa; cada painel abre como uma gaveta embaixo dela.

A barra é uma config do Quickshell (shell.qml e components/*.qml). Seu namespace de camada começa com archin-, que é o que as regras de camada do Hyprland usam para o blur. Ela consulta o sistema com pequenos blocos Process: cava para o visualizador, playerctl e wpctl para mídia e volume, nmcli para Wi-Fi, o arquivo de capacidade da bateria e hyprctl clients -j para as janelas abertas.

ComponentePapel
Bar.qmlA barra em si: mídia, volume, Wi-Fi, bateria, janelas abertas
Dashboard.qmlOverlay aberto com Super+A; as seções incluem agentes e o vault
AgentsPanel.qmlUso de agentes: lê os registros JSON e atualiza a cada 15 e 30 segundos
AccountTokenUsage.qml, ClaudeAccounts.qmlUso por conta e troca de conta do Claude
VaultPanel.qmlLogins do Bitwarden e chaves do Infisical com busca; os segredos vão da CLI direto para a área de transferência
LauncherPanel.qmlLauncher de apps com resultados ordenados por uso
MusicPanel.qmlControles de reprodução
WifiPanel.qml, BluetoothPanel.qmlPainéis de rede e dispositivos
AudioMixerPanel.qmlVolume padrão, sinks e streams por app, alimentado por audio-mixer-status
DisplayPanel.qmlControles de tela

Uso de agentes

O painel de agentes só lê arquivos JSON de $XDG_STATE_HOME/omarchy/agents/usage (padrão ~/.local/state/omarchy/agents/usage). Os coletores escrevem um registro por provider, então o painel nunca fala com a API de um provider.

ScriptFonte dos dados
agent-usage-codexSessões nativas da CLI do Codex, sessões pi/omp que passaram pelo openai-codex, sessões do opencode num provider OpenAI; limites e plano pelo RPC app-server do Codex. Flags: --force, --limits-only
agent-usage-cursorO state.vscdb local do Cursor mais os endpoints de plano e uso do dashboard do Cursor
agent-usage-grokEndpoints de cobrança e de usuário do Grok mais sessões locais em ~/.grok, com renovação de token
agent-usage-refresh.shRoda omarchy-agent-usage-update --limits-only para os outros providers e depois escreve codex.json de forma atômica a partir de um arquivo temporário só se o jq aceitar
Helper em ~/.local/binPapel
claude-accounts, codex-accountsGuardam e trocam várias contas por CLI
agent-account-limits, agent-account-tokensLimites e uso de tokens por conta guardada
desktop-vaultPonte só de metadados entre o painel do vault e as CLIs bw e infisical; limpa a área de transferência após um timeout só se o hash não mudou
chavesSeletor rbw que copia uma senha, usuário ou código TOTP; a área de transferência é limpa após 30 segundos

Outros scripts em ~/.config/scripts: audio-mixer-status despeja volume, sinks e streams como JSON; define.sh busca a palavra selecionada numa API pública de dicionário e mostra uma notificação; Music.sh abre o rmpc no Kitty, ou o Spotify pelo Omarchy, ou manda você instalar o rmpc.

Decisões

DecisãoEscolhidoRejeitadoPor quê
Relação com o OmarchyOverlay na config de usuário, nunca tocando /usr/share/omarchyUma reescrita completa do hyprland.confAs atualizações do Omarchy continuam melhorando os padrões sem sobrescrever os arquivos pessoais
ReexecuçãoMódulos idempotentes com backupsInstalador de uma vez sóSeguro de rodar de novo depois de qualquer mudança
Processo da barraSegunda instância do Quickshell com seu próprio caminho de configpkill quickshell e substituir o shellMatar o quickshell pelo nome mataria o shell do omarchy
Config específica da máquinahypr-monitors fora do allMonitores no conjunto padrãoO layout de telas só serve a uma máquina
Segredos nos painéisCLI para a área de transferência, ponte só de metadados, limpeza temporizadaGuardar ou exibir segredosOs segredos nunca ficam no estado do painel

Limites: o vault e o Chaves precisam de rbw, bitwarden-cli e infisical-bin instalados à mão. A URL do Infisical vem de ~/.config/quickshell/state/vault.json (infisical.apiUrl) ou de INFISICAL_API_URL. As instalações de pacotes assumem pacman; a etapa do AUR é pulada sem yay ou paru. Continua manual: fazer login em cada CLI de agente e no vault, editar monitors.lua para outro hardware e instalar o rmpc para o script de música.

Arquivos principais