Saltar al contenido
Chapters
  1. ¡Bienvenido a Omarchy!
  2. Primeros pasos
  3. Si vienes de Mac o Windows
  4. Navegación
  5. La barra superior
  6. Temas
  7. Atajos de teclado
  8. Portapapeles e historial unificados
  9. Recordatorios
  10. Avisos
  11. Extracción de texto y dictado
  12. Capturas de pantalla y grabación
  13. Interruptores, inactividad y el protector de pantalla
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. IA
  18. Herramientas de desarrollo
  19. Herramientas de shell
  20. Funciones de shell
  21. TUIs
  22. Interfaces gráficas
  23. Navegadores
  24. Aplicaciones/servicios comerciales
  25. Aplicaciones web
  26. Videojuegos
  27. Llenar PDF
  28. Máquina virtual de Windows
  29. Otros paquetes
  30. Actualizaciones
  31. Dotfiles
  32. Plugins del shell
  33. Monitores
  34. Teclado, mouse y trackpad
  35. Redes
  36. Suspensión del sistema
  37. Autenticación por hardware
  38. Fuentes
  39. Fondos
  40. Prompt
  41. Imagen de marca
  42. Ajustes comunes
  43. Crea tu propio tema
  44. Soporte para Mac
  45. Solución de problemas
  46. Preguntas frecuentes
  47. Instantáneas del sistema
  48. Seguridad
  49. Omarchy en...
  50. Instalación con arranque dual
  51. Instalaciones desatendidas

Manual

Crea tu propio tema

Puedes añadir tus propios temas a ~/.config/omarchy/themes. Solo copia uno de los existentes como base (busca en /usr/share/omarchy/themes) y luego ajústalo a tu gusto. Mientras tu tema esté dentro de esa carpeta, se incluirá en el menú de selección de temas.

El archivo principal que tienes que ajustar es colors.toml. Ese define el conjunto de colores que luego se usa para generar las configuraciones de la terminal (Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian y todo el shell de Omarchy (barra superior, menú, notificaciones, OSD y pantalla de bloqueo).

También puedes usar la aplicación incluida Aether para crear un nuevo tema usando una encantadora interfaz GUI para jugar con los colores y buscar fondos. Solo iníciala desde la cuadrícula de apps con Super + Alt + Space.

Qué puede contener un tema instalado

Un tema que escribas tú mismo en ~/.config/omarchy/themes puede contener lo que quieras: es tu máquina y tu archivo, y Omarchy aplica todo.

Un tema que instales desde el repo de otra persona con omarchy theme install conserva todo lo que es color y pierde el puñado de archivos que ejecutarían código en tu máquina: cualquier archivo .lua, las configuraciones de terminal (alacritty.toml, foot.ini, ghostty.conf, kitty.conf) y vscode.json. El hyprland.lua de un tema es Lua que tu compositor ejecuta al iniciar sesión, una configuración de terminal nombra el programa que inicia tu terminal, y vscode.json nombra una extensión de VSCode que se debe instalar. Instalar el tema de alguien debería cambiar cómo se ve tu escritorio, nunca qué ejecuta.

Todo lo demás sigue funcionando exactamente como lo escribió el autor del tema: btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, los fondos y las vistas previas se conservan. Solo lo que se descartó se regenera a partir de colors.toml en tu máquina.

Omarchy distingue ambos casos según si el tema tiene su propio repo de git dentro de él, que es lo que omarchy theme install deja cuando clona. Así que un tema que escribiste sigue siendo tuyo, y uno que bajaste de internet se limita a los colores.

Modo claro

Si estás creando un tema en modo claro, establece mode = "light" al inicio de tu colors.toml. Entonces se emparejará automáticamente con el modo claro para todas las apps. (La forma antigua de dejar un archivo vacío llamado light.mode en la raíz de tu tema también sigue funcionando.)

Colores de iconos

Si quieres que los iconos del gestor de archivos combinen en color con tu tema, añade un archivo llamado icons.theme con el nombre del conjunto de iconos que quieres usar. Por defecto, las opciones son: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

Imagen de desbloqueo

Los temas que incluyan imágenes unlock.png y preview-unlock.png aparecerán en Apariencia > Desbloqueo. Tu unlock.png debería ser preferiblemente un png transparente. Y puedes crear la imagen de vista previa usando omarchy plymouth preview.

Aplicar temas a apps que Omarchy no cubre

Si usas una app que no está en esa lista, puedes enseñarle a Omarchy a aplicarle un tema tú mismo con una plantilla. Deja un archivo en ~/.config/omarchy/themed/ con el nombre de la configuración que genera más una extensión .tpl, y escribe la configuración con {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} hasta {{ color15 }}, y el resto de la paleta como marcadores. Cada vez que cambies de tema, el archivo se regenera con los colores de ese tema.

Hay un alacritty.toml.tpl.sample totalmente comentado en esa carpeta para que lo copies: enumera todas las variables que puedes usar, además de los modificadores _strip y _rgb para las apps que quieren sus colores sin el # o como RGB decimal. Tus plantillas tienen prioridad sobre las propias de Omarchy, así que también puedes usar esto para sobrescribir cómo se aplica el tema a una app integrada.

Distribuir tu tema

Si quieres distribuir tu tema para que otros puedan usarlo, tienes que ponerlo en un servidor git público, como GitHub. Luego la gente puede instalarlo usando Instalar > Estilo > Tema en el menú de Omarchy usando esa URL. Se recomienda que sigas la convención de nombres de omarchy-[themename]-theme, ya que el tema se mostrará correctamente como solo [themename] en el menú de selección de temas después de la instalación.

Ese [themename] restante se convierte en el nombre del directorio del tema, así que tiene que ser uno que Omarchy pueda manejar con seguridad: debe empezar con una letra, un dígito o un guion bajo, y el resto puede contener letras, dígitos, ., _, + y -. Las mayúsculas se convierten a minúsculas por ti, pero cualquier otra cosa - un espacio, una comilla, un carácter no inglés - se rechaza al momento de la instalación en lugar de convertirse en un nombre de directorio. Así que omarchy-tokyo-night-theme, omarchy-flexoki_light-theme y omarchy-c++-theme se instalan sin problemas.

Recuerda que una vez instalado desde un repo, cualquier .lua, configuración de terminal o vscode.json que incluya se descarta, así que no construyas el tema en torno a esos archivos.

Puedes hacer que tu tema se añada a la página de temas extra enviando una pull request al repo omarchy-site.