본문으로 건너뛰기
Chapters
  1. Omarchy에 오신 것을 환영합니다!
  2. 시작하기
  3. Mac이나 Windows에서 오신 분들
  4. 탐색
  5. 상단 바
  6. 테마
  7. 단축키
  8. 통합 클립보드 및 기록
  9. 리마인더
  10. 알림
  11. 텍스트 추출 및 받아쓰기
  12. 스크린샷 및 녹화
  13. 토글, 유휴 상태 & 화면 보호기
  14. Omarchy CLI
  15. 터미널
  16. Neovim
  17. AI
  18. 개발 도구
  19. 셸 도구
  20. 셸 함수
  21. TUIs
  22. GUI
  23. 브라우저
  24. 상용 앱/서비스
  25. 웹 앱
  26. 게이밍
  27. PDF 작성하기
  28. Windows VM
  29. 기타 패키지
  30. 업데이트
  31. Dotfiles
  32. 셸 플러그인
  33. 모니터
  34. 키보드, 마우스, 트랙패드
  35. 네트워킹
  36. 시스템 절전
  37. 하드웨어 인증
  38. 글꼴
  39. 배경
  40. 프롬프트
  41. 브랜딩
  42. 흔한 조정
  43. 나만의 테마 만들기
  44. Mac 지원
  45. 문제 해결
  46. 자주 묻는 질문
  47. 시스템 스냅샷
  48. 보안
  49. Omarchy를 ...에서
  50. 듀얼 부팅 설치
  51. 무인 설치

매뉴얼

나만의 테마 만들기

~/.config/omarchy/themes에 직접 테마를 추가할 수 있다. 기존 테마 중 하나를 복사해 베이스로 삼은 뒤(/usr/share/omarchy/themes를 보라), 마음껏 손보면 된다. 테마가 그 폴더 안에 있기만 하면 테마 선택 메뉴에 포함된다.

주로 손봐야 할 파일은 colors.toml이다. 이 파일이 색상 세트를 정의하고, 그 색상 세트를 이용해 터미널(Foot/Alacritty/Ghostty/Kitty), btop, Chromium, Hyprland, Neovim, Helix, VSCode, Obsidian, 그리고 Omarchy 셸 전체(상단 바, 메뉴, 알림, OSD, 잠금 화면)의 설정이 생성된다.

포함된 Aether 애플리케이션을 이용해 색상을 가지고 놀고 배경을 찾을 수 있는 멋진 GUI 인터페이스로 새 테마를 만들 수도 있다. Super + Alt + Space의 앱 그리드에서 실행하면 된다.

설치된 테마에 들어갈 수 있는 것

~/.config/omarchy/themes에 직접 쓰는 테마에는 무엇이든 넣을 수 있다 - 내 컴퓨터, 내 파일이니 Omarchy가 전부 적용한다.

omarchy theme install로 다른 사람의 repo에서 설치한 테마는 색상에 관한 것은 모두 유지하지만, 내 컴퓨터에서 코드를 실행하게 되는 소수의 파일은 잃는다: 모든 .lua 파일, 터미널 설정(alacritty.toml, foot.ini, ghostty.conf, kitty.conf), 그리고 vscode.json이다. 테마의 hyprland.lua는 컴포지터가 로그인 때 실행하는 Lua이고, 터미널 설정은 터미널이 시작할 프로그램을 지정하며, vscode.json은 설치할 VSCode 확장을 지정한다. 다른 사람의 테마를 설치하면 데스크톱의 모습이 바뀌어야지, 데스크톱이 실행하는 것이 바뀌어서는 안 된다.

그 외의 모든 것은 테마 작성자가 작성한 그대로 동작한다 - btop.theme, chromium.theme, helix.toml, icons.theme, shell.toml, 배경과 미리보기는 모두 유지된다. 버려진 것만 내 컴퓨터에서 colors.toml을 이용해 다시 생성된다.

Omarchy는 테마 안에 자체 git repo가 있는지로 둘을 구분하는데, 이는 omarchy theme install이 clone할 때 남기는 것이다. 그래서 직접 쓴 테마는 내 것으로 남고, 인터넷에서 가져온 테마는 색상으로만 남는다.

라이트 모드

라이트 모드 테마를 만든다면 colors.toml 맨 위에 mode = "light"라고 설정하라. 그러면 모든 앱에서 자동으로 라이트 모드와 짝을 이룬다. (테마 루트에 light.mode라는 빈 파일을 넣는 옛 방식도 여전히 동작한다.)

아이콘 색상

파일 관리자 아이콘의 색상을 테마에 맞추고 싶다면, 사용하고 싶은 아이콘 세트의 이름을 담은 icons.theme라는 파일을 추가하라. 기본적으로 옵션은 다음과 같다: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow.

잠금 해제 이미지

unlock.png와 preview-unlock.png 이미지가 함께 제공되는 테마는 모양 > 잠금 해제 아래에 나열된다. unlock.png는 투명한 png인 것이 바람직하다. 그리고 omarchy plymouth preview를 이용해 미리보기 이미지를 만들 수 있다.

Omarchy가 다루지 않는 앱 테마 적용하기

그 목록에 없는 앱을 사용한다면, 템플릿으로 Omarchy가 그 앱에 테마를 적용하도록 가르칠 수 있다. ~/.config/omarchy/themed/에 생성할 설정 파일의 이름에 .tpl 확장자를 붙인 이름으로 파일을 넣고, {{ background }}, {{ foreground }}, {{ accent }}, {{ red }}, {{ color0 }}부터 {{ color15 }}까지, 그리고 나머지 팔레트를 플레이스홀더로 사용해 설정을 작성하라. 테마를 바꿀 때마다 그 테마의 색상으로 파일이 다시 생성된다.

그 폴더에는 복사해 쓸 수 있는, 주석이 충실히 달린 alacritty.toml.tpl.sample이 있다 - 사용할 수 있는 모든 변수가 나열되어 있고, # 없는 색상이나 십진 RGB 색상을 원하는 앱을 위한 _strip와 _rgb 수정자도 들어 있다. 내 템플릿이 Omarchy 자체 템플릿보다 우선하므로, 기본 앱에 테마가 적용되는 방식을 재정의하는 데도 이를 사용할 수 있다.

테마 배포하기

다른 사람들도 쓸 수 있도록 테마를 배포하고 싶다면 GitHub 같은 공개 git 서버에 올려야 한다. 그러면 사람들이 그 URL을 이용해 Omarchy 메뉴의 _설치 > 스타일 > 테마_에서 설치할 수 있다. 테마 이름은 omarchy-[themename]-theme라는 명명 규칙을 따르는 것이 좋다. 그래야 설치 후 테마 선택 메뉴에 테마가 올바르게 [themename]으로만 표시된다.

남은 [themename]이 테마의 디렉터리 이름이 되므로, Omarchy가 안전하게 주고받을 수 있는 이름이어야 한다: 문자, 숫자, 또는 밑줄로 시작해야 하고, 나머지에는 문자, 숫자, ., _, +, -가 들어갈 수 있다. 대문자는 소문자로 변환해 주지만, 그 외의 것 - 공백, 따옴표, 영어가 아닌 문자 - 은 디렉터리 이름으로 바뀌는 대신 설치 시점에 거부된다. 그래서 omarchy-tokyo-night-theme, omarchy-flexoki_light-theme, omarchy-c++-theme은 모두 문제없이 설치된다.

repo에서 설치된 뒤에는 테마가 함께 제공하는 모든 .lua, 터미널 설정, vscode.json이 버려진다는 점을 기억하라. 그러니 테마를 그런 것들을 중심으로 만들지 마라.

omarchy-site repo에 pull request를 보내면 내 테마를 추가 테마 페이지에 추가할 수 있다.