상단 바 (The Top Bar)

화면 상단에 위치한 바 형태의 영역은 Omarchy 바(The Top Bar)입니다. 단순한 외부 상태 표시줄이 아니라 메뉴, 알림, OSD 팝업, 잠금 화면까지 함께 그리는 단일 상주 Quickshell 프로세스의 핵심 구성 요소입니다. 그렇기 때문에 다른 모든 요소와 테마가 완벽하게 일치하며, 제어 패널을 열 때도 새 앱을 띄우지 않고 즉각적으로 반응합니다.

또한 데스크톱에서 상시 화면에 표시되는 유일한 UI이므로, 각 아이콘의 역할을 알아두면 매우 유용합니다.

기본 구성 요소

상단 바는 세 개의 영역으로 나뉩니다. 왼쪽에는 Omarchy 로고(메뉴 런처)와 워크스페이스 표시기가 자리합니다. 중앙에는 상태 표시기, 시계, 키보드 배열, 날씨 및 Omarchy 업데이트 배지가 있습니다. 오른쪽에는 시스템 트레이(System Tray), Agent 상태, 블루투스, 네트워크, 오디오, 디스플레이, 전원 관리가 배치됩니다.

이들 중 일부는 알릴 내용이 있을 때만 나타납니다. 키보드 배열은 둘 이상의 배열을 구성했을 때만 표시됩니다. 업데이트 배지는 대기 중인 Omarchy 업데이트가 있을 때만 나타납니다. Agent 아이콘은 머신에서 AI 코딩 도구 사용이 처음 감지되었을 때 나타납니다(AI 도구 참조).

마우스 클릭 인터랙션

거의 모든 위젯이 마우스 좌클릭, 우클릭, 휠(중간) 클릭에 반응하며, 일부는 마우스 휠 스크롤도 지원합니다. 많은 분들이 놓치기 쉬운 부분이지만, 마우스 우클릭과 중간 클릭에 다양하고 유용한 기능들이 숨어 있습니다.

위 표의 모든 위젯이 초기 설치 시 바로 표시되는 것은 아닙니다. 미디어 위젯(재생 중인 트랙과 아티스트명이 스크롤되는 MPRIS 표시)과 마이크 위젯은 내장되어 있으나 기본적으로 꺼져 있습니다. 필요 시 아래 설명에 따라 추가할 수 있습니다.

제어 패널 (Panels)

바 아이콘을 클릭하면 슬라이더, 목록, 키보드 탐색을 완벽히 지원하는 정식 팝업 제어 패널이 열립니다. 각 패널은 전용 단축키를 지원하므로 16픽셀 크기의 작은 아이콘을 마우스로 조준할 필요가 없습니다:

이 패널들은 단순한 상태 표시기가 아니라 실제 설정 작업을 수행하는 곳입니다:

• 오디오: 마스터 볼륨 슬라이더, 출력 장치 선택기, 앱별 믹서를 갖추고 있어 다른 소리에 영향을 주지 않고 특정 브라우저 탭의 볼륨만 줄일 수 있습니다.
• 네트워크: Wi-Fi를 검색하고, 신호 강도를 표시하며, 연결 및 DNS 제공자 설정을 지원합니다.
• 블루투스: 장치 목록 표시, 연결/해제 및 배터리 잔량을 확인할 수 있습니다.
• 전원: 배터리 통계를 확인하고, 전원 프로필을 전환하며(배터리 사용 시와 AC 전원 연결 시의 설정을 각각 기억), 시스템 정보를 출력합니다.
• 디스플레이: 밝기 슬라이더, 텍스트 크기, 모니터 배율 프리셋을 제공하며, 다중 모니터 사용 시 모니터별 개별 제어를 지원합니다. 자세한 내용은 모니터 설정을 참조하세요.
• 시계: ISO 주차 번호와 월 이동 기능을 갖춘 월간 달력 그리드를 엽니다.

모든 패널은 키보드와 마우스 모두로 조작할 수 있습니다: 방향키로 이동, 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 패널은 로그인 관리, 사용 용량 표시 및 최근 동기화된 파일 목록을 보여줍니다.

두 서비스 모두 삭제하면 상단 바에서 위젯도 함께 제거됩니다.

상태 표시기 (Indicators)

상단 바 중앙의 작은 아이콘 묶음은 상태 표시기 위젯입니다. 방해 금지(DND), 야간 조명, 대기 중인 미리 알림, 화면 녹화 중, 화면 켜짐 유지(Stay Awake), 음성 받아쓰기 등 활성화된 모드의 상태를 표시합니다. 해당 모드가 켜져 있을 때 불이 들어오고 평소에는 숨겨져 있습니다(상단 바 중앙에 마우스를 올리면 비활성 항목을 미리 볼 수 있습니다). 표시기를 클릭하면 해당 모드가 토글됩니다.

항상 표시하고 싶다면 위젯 설정에서 alwaysShow를 true로 지정하세요. 일부만 표시하려면 items에 원하는 항목을 나열하면 됩니다: ["Dnd", "Reminder", "NightLight"]. 표시기 위젯을 여러 개 배치하여 영역별로 다른 하위 집합을 보여줄 수도 있습니다.

상단 바 레이아웃 재배치

상단 바는 스스로 레이아웃을 구성합니다. 위치를 바꾸기 위해 설정 파일을 직접 열 필요가 없습니다.

상단 바 중앙 부근의 빈 공간을 마우스로 잡고 다른 화면 가장자리로 드래그하면 상단 바가 해당 위치(왼쪽, 오른쪽, 위, 아래)로 이동하며, 모든 위젯이 자동으로 적응합니다(수직 바의 경우 컴팩트한 아이콘 전용 모드로 전환). 길게 클릭한 채 드래그해도 동일하게 이동할 수 있습니다. 빈 공간을 마우스 좌클릭으로 더블 클릭하면 투명도가 토글됩니다. 위젯을 직접 드래그하여 순서를 바꾸거나 다른 영역으로 옮길 수도 있습니다.

메뉴에서 설정하려면 Style → Menu Bar에서 위치와 투명도를 모두 조정할 수 있습니다.

도트파일(Dotfiles) 관리를 위한 CLI 명령어 역시 완벽히 제공됩니다:

omarchy bar position bottom
omarchy bar transparent toggle
omarchy bar move omarchy.clock --section center --index 0
omarchy bar set omarchy.clock format "HH:mm"
omarchy bar defaults          # 출하 시 기본 레이아웃으로 복원

위젯을 완전히 추가하거나 제거하려면 플러그인 명령을 사용합니다. omarchy plugin list는 셸이 인식하는 모든 위젯과 해당 ID를 출력하며, 다음과 같이 사용할 수 있습니다:

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

상단 바 숨기기

Super + Shift + Space를 누르면 셸 프로세스를 종료하지 않고도 상단 바를 숨기거나 다시 표시할 수 있습니다. 패널과 단축키는 정상 작동하며 온전히 전체 화면 픽셀을 확보할 수 있습니다. 메뉴의 Trigger → Toggle → Menu Bar에서도 실행할 수 있습니다.

설정 파일

모든 구성은 ~/.config/omarchy/shell.json의 bar 키 아래에 저장됩니다. 간략한 예시는 다음과 같습니다:

{
  "version": 1,
  "bar": {
    "position": "top",
    "transparent": false,
    "centerAnchor": "omarchy.clock",
    "layout": {
      "left": [{ "id": "omarchy.menu" }, { "id": "omarchy.workspaces" }],
      "center": [{ "id": "omarchy.clock", "format": "HH:mm" }],
      "right": [{ "id": "omarchy.audio" }, { "id": "omarchy.power" }]
    }
  }
}

각 위젯은 세 가지 레이아웃 배열 중 하나의 항목에 해당하며, 해당 항목 내에 설정이 인라인으로 포함됩니다(별도의 설정 파일이나 config 하위 객체는 없습니다). 시계의 format, formatAlt(우클릭 시 순환할 형식), verticalFormat은 모두 { "id": "omarchy.clock" } 객체에 직접 작성됩니다.

centerAnchor는 화면 정중앙에 고정될 단 하나의 중앙 위젯을 지정하며, 다른 위젯들은 그 양옆에 배치됩니다. 이를 통해 날씨나 업데이트 배지가 나타나거나 사라져도 시계는 항상 화면 정중앙을 유지할 수 있습니다. 빈 문자열로 설정하면 중앙 위젯 목록이 그룹 전체로서 중앙 정렬됩니다.

반드시 기억해야 할 원칙: 본인만의 shell.json이 생성되면, 그것이 절대적인 기준(Canonical)이 됩니다. 설정을 변경하기 전까지는 Omarchy의 기본 파일을 읽어오지만, 위젯을 드래그하거나 omarchy bar를 실행하거나 직접 파일을 편집하는 순간 사용자의 파일이 완전히 제어권을 가집니다(딥 머지를 수행하지 않으므로 향후 Omarchy 릴리스에 추가되는 새 기본 위젯이 자동으로 표시되지 않습니다). 원할 때 언제든 omarchy bar defaults를 실행하면 초기 레이아웃으로 되돌릴 수 있습니다.

같은 파일의 최상위(bar 키 외부)에는 유휴 시간 관련 설정도 저장됩니다: idle.screensaver(화면 보호기 시작 시간) 및 idle.lock(화면 잠금 시간), 단위는 유휴 상태 진입 후 초(second) 단위입니다. 기본적으로 150초에 화면 보호기가 시작되고 300초에 화면이 잠깁니다.