나만의 테마 제작 가이드

~/.config/omarchy/themes 디렉터리에 자신만의 테마를 추가할 수 있습니다. 기존 내장 테마(/usr/share/omarchy/themes 참고) 중 하나를 복사한 후 취향에 맞게 수정하세요. 폴더에 넣기만 하면 테마 선택 메뉴에 자동으로 포함됩니다.

가장 핵심이 되는 파일은 colors.toml입니다. 이 파일에 정의된 색상 팔레트를 기반으로 터미널(Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian 및 Omarchy Shell 전체(상단 바, 메뉴, 알림, OSD, 잠금 화면)의 설정이 자동 파생 생성됩니다.

GUI 환경에서 색상을 조합하고 배경화면을 탐색하며 테마를 만들고 싶다면 내장된 Aether 앱(Super + Alt + Space 앱 메뉴)을 활용하세요.

라이트 모드 (Light mode)

라이트 모드 테마를 제작할 때는 colors.toml 최상단에 mode = "light"를 선언합니다. 모든 지원 앱의 라이트 모드와 자동 매칭됩니다.

파일 관리자 아이콘 색상 연동

파일 관리자 폴더 아이콘 색상을 맞추려면 테마 폴더에 icons.theme 파일을 만들고 원하는 아이콘 세트 이름을 적으세요(기본 옵션: Yaru, Yaru-blue, Yaru-dark, Yaru-magenta, Yaru-purple, Yaru-yellow 등).

잠금 해제 화면 이미지

unlock.png와 preview-unlock.png를 포함한 테마는 Style > Unlock에 표시됩니다(unlock.png는 투명 배경 PNG 권장, omarchy plymouth preview로 미리보기 생성 가능).

기타 앱 테마 템플릿 연동

공식 미지원 앱도 템플릿을 통해 테마 연동을 구현할 수 있습니다. ~/.config/omarchy/themed/ 아래에 대상 설정 파일명에 .tpl을 붙여 템플릿을 만들고, {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }} ~ {{ color15 }} 등의 플레이스홀더를 사용해 작성하면 테마 변경 시마다 자동 재생성됩니다.

폴더 내의 alacritty.toml.tpl.sample 파일에 자세한 변수 사용법이 주석으로 설명되어 있습니다.

테마 배포 및 공유

제작한 테마를 전 세계 사용자와 공유하려면 GitHub 등 공개 Git 리포지토리에 올리세요. 다른 사용자들이 Omarchy 메뉴의 Install > Style > Theme에서 URL로 즉시 설치할 수 있습니다(리포지토리 명명 규칙은 omarchy-[테마명]-theme 권장).

공식 추가 테마 페이지에 등재하려면 omarchy-site 리포지토리에 Pull Request를 보내주세요.