개요
Omarchy — Arch Linux 기반 데스크톱 OS — 를 새로 설치한 사용자를 위한 5단계 설정 가이드. 저장소는 yelixir-dev/omarchy-starter이며, 각 장마다 초보자용 설명, 직접 실행할 명령어, AI 코딩 에이전트에 그대로 붙여넣을 수 있는 프롬프트를 함께 제공한다. 한국어 입력기만 필수이고 나머지는 자신의 환경(Intel Mac, VPN 필요 여부 등)에 맞을 때만 진행하면 된다.
5개 장 구성
1. OMO 코딩 에이전트 (선택)
터미널에서 자연어로 명령을 대신 실행해주는 AI 에이전트. 이후 장들의 설치를 이 에이전트에게 맡길 수 있도록 가장 먼저 배치되어 있다.
npm i -g omo-ai@beta
omo
/login이미 쓰는 AI 도구가 있다면 그대로 사용해도 된다고 명시한다.
2. 한국어 입력기 — Fcitx5 + 한글 엔진 (필수)
Arch Linux 계열(Omarchy는 omarchy 패키지 명령, 그 외는 pacman)을 대상으로
한다. 저장소의 install-fcitx5-hangul.sh를 실행하면:
git clone https://github.com/yelixir-dev/omarchy-starter.git
cd omarchy-starter
chmod +x install-fcitx5-hangul.sh
./install-fcitx5-hangul.sh- fcitx5·GTK/Qt 연동 모듈·한글 엔진 설치, 2) 기존 프로필을
profile.bak.<날짜-시간>.<임의문자>로 백업, 3) 세션에서 fcitx5 시작, 4) 영문/한글 입력기를 기본 그룹에 등록, 5) X11이면 입력기 환경변수를 별도 파일에 저장, 6)hangul등록 여부 확인까지 자동 수행한다. 전환키는 기본Ctrl+Space.
3. 팜 리젝션 (2019년형 이하 Intel Mac, 선택)
T2 칩이 내장 트랙패드를 “외장 장치”로 오인식해 타이핑 중 커서가 튀는 문제를
install-intel-mac-palm-rejection.sh --dry-run → 실행으로 해결하고,
libinput list-devices의 Disable-w-typing: enabled로 검증한다.
4. VPN — Tailscale + NordVPN 조합 (선택)
- Tailscale: 기기 간 사설 메시 네트워크(100.x.x.x 대역) 구성.
omarchy pkg add tailscale→tailscaled서비스 활성화 →tailscale up --accept-routes=false. - NordVPN: 자체 앱 대신 NetworkManager의 OpenVPN 프로필로만 연결
(
nmcli connection import). 2023년 6월 이후 계정 자격증명이 아닌 별도 “서비스 자격증명”이 필요. - 충돌 경고: NordVPN 자체 앱과 Tailscale 동시 사용 금지, Tailscale exit node·Nord Meshnet 금지(100.64.0.0/10 대역 겹침). 안전한 조합은 Tailscale(mesh 전용) + NetworkManager OpenVPN 뿐이라고 명시한다.
- 상태바 VPN 토글 아이콘은
install-vpn-bar-toggles.sh로 추가하며, 암호 없이 토글하려면sudo tailscale set --operator=$USER가 필요하다.
5. 카카오톡 & 스크린샷 (선택)
- 카카오톡:
install-kakaotalk-bottles.sh로 Bottles(Wine) 위에 Windows판을 실행,Super+Shift+K단축키 자동 등록. 한글 입력 문제 시patch-kakaotalk-korean-input.sh로 별도 패치. - 스크린샷:
install-screenshot-shortcuts.sh로 macOS 스타일 단축키 (Super+Shift+9영역 캡처,Super+Shift+0전체 화면)를 등록, 결과는~/Pictures에 저장되고 클립보드에도 복사된다.
평가
문서 구조 자체가 “필수 1개 + 선택 4개, 각 항목마다 설치→검증→제거” 패턴을
일관되게 반복하며, VPN 조합처럼 실수하면 네트워크가 먹통이 될 수 있는 조합에
대해 명시적으로 경고를 넣은 점이 실용적이다. 모든 스크립트는 저장소
yelixir-dev/omarchy-starter에 있으며 페이지 자체에는 출처/버전 정보가 거의
없어(단일 작성자 기준) 스크립트의 최신성은 저장소를 직접 확인해야 한다.