Saltar para o conteúdo
Chapters
  1. Bem-vindo ao Omarchy!
  2. Primeiros Passos
  3. Vindo do Mac ou do Windows
  4. Navegação
  5. A Barra Superior
  6. Temas
  7. Atalhos de teclado
  8. Área de Transferência Unificada e Histórico
  9. Lembretes
  10. Avisos
  11. Extração de texto e ditado
  12. Capturas de ecrã e gravação
  13. Alternâncias, Inatividade e a Proteção de Ecrã
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. IA
  18. Ferramentas de Desenvolvimento
  19. Ferramentas de shell
  20. Funções de shell
  21. TUIs
  22. GUIs
  23. Navegadores
  24. Aplicações/serviços comerciais
  25. Aplicações Web
  26. Jogos
  27. Preencher PDF
  28. VM Windows
  29. Outros pacotes
  30. Atualizações
  31. Dotfiles
  32. Plugins da shell
  33. Monitores
  34. Teclado, Rato, Trackpad
  35. Rede
  36. Suspensão do sistema
  37. Autenticação por hardware
  38. Tipos de Letra
  39. Fundos
  40. Linha de comandos
  41. Branding
  42. Ajustes comuns
  43. Criar o seu próprio tema
  44. Suporte para Mac
  45. Resolução de problemas
  46. Perguntas frequentes
  47. Instantâneos do sistema
  48. Segurança
  49. Omarchy em...
  50. Instalação em Arranque Duplo
  51. Instalações não assistidas

Manual

Criar o seu próprio tema

Pode adicionar os seus próprios temas a ~/.config/omarchy/themes. Basta copiar um dos existentes como base (veja em /usr/share/omarchy/themes), depois ajuste ao seu gosto. Desde que o seu tema esteja dentro dessa pasta, será incluído no menu de seleção de temas.

O ficheiro principal que tem de ajustar é colors.toml. Este define o conjunto de cores que é depois utilizado para gerar configurações para o terminal (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian e toda a shell do Omarchy (barra superior, menu, notificações, OSD e ecrã de bloqueio).

Pode também utilizar a aplicação Aether incluída para criar um novo tema usando uma agradável interface GUI para brincar com as cores e procurar fundos. Basta iniciá-la a partir da grelha de aplicações em Super + Alt + Space.

O que um tema instalado pode conter

Um tema que escreve você mesmo em ~/.config/omarchy/themes pode conter o que quiser - a máquina é sua e o ficheiro é seu, e o Omarchy aplica tudo.

Um tema que instala a partir do repositório de outra pessoa com omarchy theme install mantém tudo o que é cor, e perde o punhado de ficheiros que executariam código na sua máquina: qualquer ficheiro .lua, as configurações do terminal (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) e vscode.json. O hyprland.lua de um tema é Lua que o seu compositor executa ao iniciar sessão, uma configuração do terminal indica o programa que o seu terminal inicia, e vscode.json indica uma extensão do VSCode a instalar. Instalar o tema de alguém deve mudar o aspeto do seu ambiente de trabalho, nunca o que ele executa.

Tudo o resto continua a funcionar exatamente como o autor do tema escreveu - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, os fundos e as pré-visualizações são todos mantidos. Apenas o que foi removido é regenerado a partir de colors.toml na sua máquina.

O Omarchy distingue os dois pela existência de um repositório git próprio dentro do tema, que é o que omarchy theme install deixa para trás quando clona. Assim, um tema que escreveu continua a ser seu, e um que descarregou da internet fica-se pelas cores.

Modo claro

Se estiver a criar um tema de modo claro, defina mode = "light" no topo do seu colors.toml. Depois, ele será automaticamente emparelhado com o modo claro para todas as aplicações. (A forma antiga de deixar um ficheiro vazio chamado light.mode na raiz do seu tema também continua a funcionar.)

Cores dos ícones

Se quiser combinar as cores dos ícones do gestor de ficheiros com o seu tema, adicione um ficheiro chamado icons.theme com o nome do conjunto de ícones que pretende utilizar. Por predefinição, as opções são: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

Imagem de desbloqueio

Os temas fornecidos com imagens unlock.png e preview-unlock.png serão listados em Aparência > Desbloqueio. O seu unlock.png deve ser, de preferência, um png transparente. E pode criar a imagem de pré-visualização utilizando omarchy plymouth preview.

Aplicar temas a aplicações que o Omarchy não abrange

Se utilizar uma aplicação que não está nessa lista, pode ensinar o Omarchy a aplicar-lhe um tema você mesmo com um modelo. Deixe um ficheiro em ~/.config/omarchy/themed/ com o nome da configuração que gera mais a extensão .tpl, e escreva a configuração com {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} até {{ color15 }}, e o resto da paleta como marcadores. Sempre que mudar de tema, o ficheiro é regenerado com as cores desse tema.

Existe um alacritty.toml.tpl.sample totalmente comentado nessa pasta para copiar - lista todas as variáveis que pode utilizar, mais os modificadores _strip e _rgb para aplicações que querem as suas cores sem o # ou como RGB decimal. Os seus modelos têm prioridade sobre os do próprio Omarchy, por isso também pode utilizar isto para substituir a forma como um tema é aplicado a uma aplicação integrada.

Distribuir o seu tema

Se quiser distribuir o seu tema para que outros possam utilizá-lo, precisa de o colocar num servidor git público, como o GitHub. Depois, as pessoas podem instalá-lo utilizando Instalar > Estilo > Tema no menu do Omarchy, usando esse URL. Recomenda-se que siga a convenção de nomenclatura omarchy-[themename]-theme, pois o tema será apresentado corretamente apenas como [themename] no menu de seleção de temas após a instalação.

Esse [themename] restante torna-se o nome do diretório do tema, por isso tem de ser um que o Omarchy consiga passar de um lado para o outro em segurança: tem de começar com uma letra, um dígito ou um sublinhado, e o resto pode conter letras, dígitos, ., _, + e -. As maiúsculas são convertidas para minúsculas por si, mas qualquer outra coisa - um espaço, uma aspa, um caráter não inglês - é recusada no momento da instalação, em vez de ser transformada num nome de diretório. Por isso, omarchy-tokyo-night-theme, omarchy-flexoki_light-theme e omarchy-c++-theme instalam todos sem problemas.

Lembre-se de que, depois de instalado a partir de um repositório, qualquer .lua, configuração de terminal ou vscode.json que ele traga é removido, por isso não construa o tema em torno desses ficheiros.

Pode fazer com que o seu tema seja adicionado à página de temas extra enviando um pull request para o repositório omarchy-site.