본문으로 건너뛰기
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. 무인 설치

매뉴얼

상단 바

화면 상단을 따라 있는 띠가 Omarchy 바다. 나중에 붙인 상태 표시줄이 아니라 Omarchy 셸의 일부다. 셸은 메뉴, 알림, OSD 팝업, 잠금 화면까지 그리는 단일 장기 실행 Quickshell 프로세스다. 그래서 다른 모든 것과 완벽하게 테마가 맞고, 패널도 새 앱을 실행할 필요 없이 즉시 열린다.

화면에 항상 떠 있는 유일한 데스크톱 요소이기도 하니, 그 작은 글리프들이 각각 무슨 일을 하는지 알아둘 가치가 있다.

기본 구성

바는 세 개의 섹션으로 이루어져 있다. 왼쪽에는 Omarchy 로고(메뉴 런처)와 워크스페이스 표시기가 있다. 가운데에는 상태 표시기, 시계, Elsewhen(세계 시계), 날씨, Omarchy 업데이트 배지가 있다. 오른쪽에는 시스템 트레이, 키보드 레이아웃(두 개 이상 설정했을 때만), agents, bluetooth, network, audio, display, power가 있다.

이 중 몇몇은 할 말이 있을 때만 나타난다. 키보드 레이아웃은 레이아웃을 두 개 이상 설정했을 때만 나타난다. 업데이트 배지는 Omarchy 업데이트가 대기 중일 때만 나타난다. 그리고 agents 아이콘은 Omarchy가 이 기기에서 AI 코딩 사용량을 처음 발견했을 때 나타난다(AI 참조).

클릭해 보기

거의 모든 위젯이 왼쪽, 오른쪽, 가운데 클릭에 각각 반응하고, 몇몇은 스크롤에도 반응한다. 사람들이 놓치는 부분이 바로 여기다 - 오른쪽 버튼과 가운데 버튼에 좋은 것들이 많이 숨어 있다.

위젯 왼쪽 오른쪽 가운데 / 스크롤
메뉴 Omarchy 메뉴 새 터미널 -
워크스페이스 이 모니터에서 해당 워크스페이스로 포커스 - 스크롤: 다음/이전 워크스페이스
시계 캘린더 팝업 레이블 형식 순환 가운데: 시간대 선택기
날씨 일기예보 팝업 전체 날씨를 알림으로 표시 가운데: 새로고침
오디오 오디오 패널 음소거 가운데: 패널 · 스크롤: 볼륨
마이크 마이크 음소거 - 가운데: 오디오 패널 · 스크롤: 입력 볼륨
네트워크 네트워크 패널 - -
Bluetooth Bluetooth 패널 라디오 켜기/끄기 -
디스플레이 디스플레이 패널 - 스크롤: 밝기
전원 전원 패널 배터리 퍼센트 켜기/끄기 -
미디어 재생/일시정지 커버 아트 팝업 가운데: 다음 · 스크롤: 이전/다음
Agents Agents 패널 에이전트 실행 가운데: 다음 구독
트레이 마우스를 올려 서랍 펼치기 셰브론에서 오른쪽 클릭해 관리 -
Omarchy 업데이트 업데이트 실행 - -

그 표에 있는 모든 것이 처음부터 바에 있는 것은 아니다. 미디어 위젯(MPRIS 현재 재생 중, 스크롤되는 트랙과 아티스트 표시)과 마이크 위젯은 둘 다 내장되어 있지만 기본값은 꺼짐이다 - 원하면 아래 설명대로 추가하면 된다.

패널

바 아이콘을 클릭하면 패널이 열린다. 패널은 툴팁이 아니라 슬라이더, 목록, 키보드 탐색을 갖춘 제대로 된 팝업이다. 각각 단축키도 있으니 16픽셀짜리 글리프를 조준할 필요가 전혀 없다:

단축키 패널
Super + Ctrl + A 오디오
Super + Ctrl + N 네트워크
Super + Ctrl + B Bluetooth
Super + Ctrl + D 디스플레이
Super + Ctrl + P 전원
Super + Ctrl + Alt + D 캘린더
Super + Ctrl + Alt + E 세계 시계
Super + Ctrl + 1-9 오른쪽 섹션의 n번째 패널 켜기/끄기

패널은 읽기 전용 표시판이 아니다. 실제로 일을 처리하는 곳이다:

  • 오디오에는 마스터 볼륨 슬라이더, 출력 장치 선택기, 앱별 믹서가 있어서 다른 것들은 건드리지 않고 그 브라우저 탭 하나의 소리만 줄일 수 있다.
  • 네트워크는 Wi-Fi를 스캔하고, 신호 강도를 보여주고, 연결하고, DNS 제공업체를 고르게 해준다.
  • Bluetooth는 기기를 연결/연결 해제와 배터리 잔량과 함께 나열한다.
  • 전원은 배터리 통계를 보여주고, 전원 프로필을 전환하며(배터리용과 AC용 선택을 따로 기억한다), 시스템 정보도 일부 출력한다.
  • 디스플레이에는 밝기 슬라이더, 텍스트 크기, 모니터 스케일링 프리셋이 있고 - 화면이 두 개 이상이면 - 모니터별 컨트롤도 있다. 더 깊은 이야기는 모니터를 보라.
  • 시계는 ISO 주차 번호와 월 이동이 있는 월간 그리드를 연다.
  • 세계 시계는 도시마다 한 줄씩 유지하며, 그곳의 날씨와 하루가 어떻게 흘러가고 있는지 보여준다. 검색은 시간대뿐 아니라 마을도 찾으니, Fort Lauderdale는 New York이 아니라 Fort Lauderdale다. 맨 위 줄이 엉뚱한 도시를 가리키고 있으면, 그걸 클릭해서 지금 어디에 있는지 알려주면 된다. 다른 시간대에 있는 곳을 고르면 시스템 시계도 그리로 이동하는데, 여행할 때 편리하다. 도시에 마우스를 올리고 사람 버튼을 클릭하면 거기 사는 사람을 알려줄 수 있다 - 평범한 이름도 되고, 얼굴까지 불러오려면 @ GitHub 핸들도 된다.

모든 패널은 마우스뿐 아니라 키보드도 받는다: 화살표로 이동하고, Return으로 활성화하고, Tab으로 이웃 패널로 이동하고, Escape로 닫는다.

Super + Ctrl + 1-9는 오른쪽 섹션의 패널을 왼쪽에서 오른쪽으로 세며, 자체 패널이 없는 트레이는 건너뛴다. 그래서 숫자가 가리킬 아이콘과 일치한다.

Tailscale과 Dropbox

Install → Service에서 해당 서비스를 설치해야만 바에 나타나는 위젯이 두 개 더 있는데, 둘 다 상태만 보고하는 수준을 넘어서니 알아둘 가치가 있다.

Tailscale 패널은 tailnet을 연결하고 끊고, 계정을 전환하고, exit node를 고른다(내 기기와 Mullvad 지역이 모두 그 목록에 나타난다). 내 기기들을 탐색할 수도 있는데 - 하나를 선택한 상태에서 s를 누르면 Taildrop으로 그 기기에 파일을 보내며, 이게 휴대폰이나 다른 노트북으로 파일을 옮기는 가장 빠른 방법이다. c는 기기의 IP를, n은 이름을, d는 전체 DNS 이름을 복사한다. 클릭하는 편이 좋다면 각 기기 행에 보내기 버튼도 있다. 터미널에서 같은 일을 하려면 omarchy tailscale send <machine> [file...]다.

Dropbox 패널은 로그인을 처리하고, 저장 공간을 얼마나 썼는지 보여주고, 최근 동기화된 파일을 나열한다.

두 서비스 중 어느 하나를 제거하면 그 위젯도 바에서 사라진다.

표시기

가운데의 작은 무리가 표시기 위젯이다. 켜둔 모드들을 위한 상태 글리프다: 방해 금지, 야간 조명, 대기 중인 리마인더, 진행 중인 화면 녹화, 깨어 있기, 받아쓰기. 모드가 활성일 때 켜지고 평소에는 방해가 되지 않게 물러나 있다 - 바 어디에든 마우스를 올리면 비활성 항목들을 엿볼 수 있다. 표시기를 클릭하면 그 모드가 켜졌다 꺼졌다 한다. 상태 전용인 것이 하나 더 있다: gliff를 통해 누군가 이 기기에 연결되어 있는 동안 원격 세션이 빨간색으로 켜진다.

항상 보이게 하고 싶다면 위젯에 alwaysShow를 true로 설정하라. 그리고 일부만 신경 쓰인다면 원하는 것들을 items에 나열하라: ["Dnd", "Reminder", "NightLight"]. 표시기 위젯은 두 개 이상 가질 수 있으니, 섹션마다 다른 부분집합을 보여줄 수 있다.

바 재배열하기

바는 스스로 설정한다. 뭔가를 옮기려고 설정 파일을 열 필요가 없다.

가운데 근처의 빈 공간을 잡고 다른 화면 가장자리를 향해 드래그하면 바가 그리로 이동한다 - 왼쪽, 오른쪽, 위쪽, 아래쪽 모두 되고, 모든 위젯이 적응한다(세로 바는 컴팩트한 아이콘 전용 형태로 대체된다). 클릭하고 누르고 있어도 같은 드래그가 시작된다. 그 같은 빈 공간을 왼쪽 버튼으로 더블클릭하면 바 배경이 투명에서 유리 질감으로, 불투명으로 순환한다. 그리고 어떤 위젯이든 드래그해서 순서를 바꾸거나 다른 섹션에 던져 넣으면, 다른 위젯들이 착지할 자리를 만들려고 양쪽으로 미끄러져 벌어진다.

바의 가운데는 하나의 상자다: 그 안에 있는 것은 무엇이든 하나의 그룹으로 가운데 정렬된 채 유지되고, 그 양쪽의 위젯들은 그 가장자리에 매달린다. 위젯을 드래그하는 동안 상자는 윤곽선으로 표시되며, 비어 있을 때는 바를 가로지르는 선으로 표시되고, 그 안이나 옆에 떨어뜨릴 수 있다. 떨어뜨릴 자리가 상자 안에 들어가게 되면, 상자가 커져서 위젯을 받아들인다.

주변에 두고 싶지만 항상 보이지는 않았으면 하는 위젯은 트레이의 서랍에 넣을 수 있다: 트레이 위로 드래그하면 서랍이 열려 받아준다. 앱 아이콘 뒤에 자리 잡고, 서랍이 나타날 때마다 나타나며, 자기 패널이 떠 있는 동안에는 서랍을 열린 채로 유지한다. 다시 바 위로 드래그해 빼내면 제자리로 돌아간다.

메뉴에서 고르는 편이 좋다면, Appearance → Menu Bar에 위치가 있고, Bar Background에서 바를 그리는 방식을 고른다: Opaque Bar, Glassy Bar(뒤에 있는 것이 블러 처리되어 비쳐 보이는 방식), Clear Bar.

같은 일들을 하는 명령도 있는데, dotfiles 설정에 원하는 것이 바로 이쪽이다:

omarchy bar position bottom
omarchy bar background glassy  # opaque, glassy, none, or cycle
omarchy bar move omarchy.weather --section centerBegin --index 0
omarchy bar move omarchy.bluetooth --section tray  # into the tray's drawer
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # back to the shipped layout

위젯을 통째로 추가하거나 제거하려면 플러그인 명령을 쓰라. omarchy plugin list는 셸이 아는 모든 위젯을 id와 함께 출력하고, 그다음은 이렇다:

omarchy plugin enable omarchy.media --section centerEnd
omarchy plugin disable omarchy.weather

바 숨기기

Super + Shift + Space는 셸을 죽이지 않고 바를 껐다 켠다 - 패널과 단축키는 계속 동작하고, 픽셀만 되찾을 뿐이다. 메뉴의 Appearance → Menu Bar → Hide Bar에도 있다.

설정 파일

이 모든 것은 ~/.config/omarchy/shell.json에 bar 키 아래 저장된다. 다듬은 버전이 여기 있다:

{
  "version": 1,
  "bar": {
    "position": "top",
    "background": "opaque",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "centerBegin": [{ "id": "omarchy.indicators" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "centerEnd": [{ "id": "omarchy.weather" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

모든 위젯은 다섯 개의 레이아웃 배열 중 하나에 있는 항목 하나이며, 그 설정은 그 항목에 인라인으로 들어 있다 - 별도의 설정 파일도 없고 config 하위 객체도 없다. 시계의 format, formatAlt(오른쪽 클릭으로 순환되는 것), verticalFormat은 모두 { "id": "omarchy.clock" } 바로 거기에 산다.

center는 바 가운데의 상자다: 그 안에 있는 모든 것은 하나의 그룹으로 화면 중앙에 정렬된다. centerBegin과 centerEnd는 상자 양쪽에 매달리는데, 날씨와 업데이트 배지가 오가는데도 시계가 정확히 중앙에 머무는 비결이 바로 이것이다. center에 위젯을 두 개 이상 넣으면 함께 가운데 정렬되고, 비워 두면 centerBegin과 centerEnd가 바 가운데에서 만난다.

내면화해둘 가치가 있는 규칙이 하나 있다: 자기만의 shell.json이 생긴 순간부터, 그게 정본이다. 아무것도 맞춤 설정하지 않는 한 셸은 Omarchy의 기본 파일을 읽는다. 위젯을 드래그하거나, omarchy bar를 실행하거나, 파일을 직접 편집하는 순간, 그 파일은 내 소유가 된다 - 깊은 병합 같은 건 없으니, 향후 Omarchy 릴리스의 새 기본 위젯이 자동으로 바에 나타나지는 않는다. 깨끗한 상태에서 다시 시작하고 싶을 때는 언제든 omarchy bar defaults가 출고 시 레이아웃을 되돌려준다.

같은 파일은 bar 키 바깥의 최상위 수준에 유휴 타이밍도 담고 있다: idle.screensaver와 idle.lock, 둘 다 유휴 상태가 된 뒤의 초 단위다. 그래서 기본 화면 보호기는 150초에 작동하고 잠금은 300초에 작동한다.