자동화 문서
명령줄 참조
Dock 대체 앱이나 다른 Mac 도구에 popCalendar를 연동하세요. CLI로 달력을 열고, 날짜를 선택하고, 계획을 관리하고, 이미지를 내보낼 수 있습니다.
이 가이드는 popCalendar 1.3 이상을 다룹니다. 일부 동작에는 아래에 명시된 더 최신 시스템 버전이 필요합니다.
내 도구에 완전한 달력 경험 더하기
Dock 대체 앱, 런처, 메뉴 막대 유틸리티 등 어떤 Mac 도구에도 popCalendar를 연동할 수 있습니다. CLI로 네이티브 달력 윈도우, 기준 위치에 연결된 팝업, 날짜 선택 기능을 활용하여 달력을 직접 구현하지 않고도 풍부한 달력 경험을 제공하세요.
개발자는 연동 기능을 만드는 동안 무료 popCalendar 프로모션 코드와 실질적인 구현 지원을 받기 위해 문의할 수 있습니다.
popCalendar 연동을 구현하는 모든 도구에는 공식 지원 연동으로서 popcalendar.app에 전용 소개 섹션이 제공됩니다. 연동 기능이 준비되면 알려 주세요.
목차로 돌아가기앱 번들에서 실행
popCalendar가 설치되어 있으면 별도의 CLI 패키지는 필요하지 않습니다. 기본 실행 파일을 전체 경로로 실행하세요. 모든 명령은 --로 시작합니다. 명령 없이 실행하면 일반 앱이 열립니다.
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --help원한다면 현재 터미널 세션의 PATH에 실행 파일 디렉터리를 추가하세요. 같은 줄을 셸 설정에 직접 추가할 수도 있습니다. 앱을 옮기거나 이름을 바꿨다면 실제 위치를 사용하세요. Setapp 실행 파일 이름도 popCalendar입니다. 두 버전이 모두 설치되어 있다면 전체 경로로 사용할 버전을 선택하세요.
export PATH="${PATH:+$PATH:}"'/Applications/popCalendar.app/Contents/MacOS'
popCalendar --help 목차로 돌아가기 터미널에 캘린더 표시하기
--terminal을 사용하면 캘린더 창을 열지 않고 캘린더를 출력합니다. 먼저 설정 > 자동화 및 개인정보 보호에서 터미널 캘린더를 켜세요. 미리보기는 복사할 수 있는 명령어가 담긴 예시 시트를 엽니다. 기본 캘린더는 로컬에서 실행됩니다. 요청한 개인 데이터는 앱을 통해 백그라운드에서 읽습니다.
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal --interactive
"/Applications/popCalendar.app/Contents/MacOS/popCalendar" --terminal --year 2027레이아웃을 지정하지 않으면 공간이 충분할 때 한 해를, 그렇지 않으면 한 달을 표시합니다. 대화형 모드는 레이아웃을 선택하거나 범위를 지정하기 전까지 창 크기 변경에 맞춰 조정됩니다. 파이프, JSON, 일정 목록만 출력하는 경우에는 기본적으로 한 달을 사용합니다.
목차로 돌아가기이벤트, 계획, 근무일
--events로 이벤트를 포함하고, --agenda로 이벤트 목록을 표시하며, --plans로 저장한 계획을 표시하고, --working-days로 근무 일정을 표시합니다. 캘린더 세트 필터는 해당 명령에만 적용되며 활성 세트를 바꾸지 않습니다. --search는 제목과 장소를 검색합니다. 이벤트를 요청하기 전에 앱에서 캘린더 접근 권한을 허용하세요.
popCalendar --terminal --events today --agenda
popCalendar --terminal --events week --calendar-set current
popCalendar --terminal --months 3 --plans all --working-days
popCalendar --terminal --events month --search meeting --limit 20
popCalendar --terminal --start 2027-03-01 --end 2027-03-14 --events rangeweek 옵션은 --date 또는 오늘부터 7일간을 뜻합니다. 범위에는 양 끝 날짜가 포함됩니다. 범위를 따로 선택하지 않으면 range의 이벤트는 표시된 월을 기준으로 합니다. 날짜와 제목에는 그레고리력을 사용합니다.
목차로 돌아가기대화형 모드에서 탐색하기
화살표 또는 h/j/k/l로 날짜를 이동하고, n/p로 기간을 바꾸고, m/y로 월 또는 연도를 선택하고, t로 오늘로 이동합니다. v로 범위의 시작과 끝을 지정하고, c로 지우고, g로 날짜로 이동하고, /로 검색하고, ?로 도움말을 엽니다. q 또는 Escape로 종료합니다.
e로 이벤트, a로 일정 목록, b로 계획, d로 근무일, w로 주 번호를 전환합니다. s로 다음 캘린더 세트를 선택하고, r로 새로 고치고, PageUp/PageDown 또는 Space로 스크롤합니다.
전체 단어 명령어도 사용할 수 있으며 대소문자를 구분하지 않습니다. 키가 즉시 반응하는 모드에서는 먼저 콜론 키를 누른 뒤 명령어를 입력하고 Enter를 누르세요. 하단에 Enter 안내가 나오면 명령어를 바로 입력하고 Enter를 누르세요. 입력 프롬프트가 열려 있으면 Escape는 종료하기 전에 해당 입력을 취소합니다.
month year next previous today
left right up down range clear
events agenda plans working-days sets week-numbers
goto 2027-03-01
search meeting
refresh page-up page-down home end
help quit exit 목차로 돌아가기 터미널 출력 옵션
날짜, 월, 연도, 모드 또는 1개월에서 24개월을 선택하세요. --start와 --end는 함께 사용하고 다른 날짜나 모드 옵션과 조합하지 마세요. --time-zone, --first-weekday, --week-numbers로 캘린더를 설정합니다. --width는 32에서 240열, --limit는 1에서 500개 이벤트, --color는 auto, always 또는 never를 허용합니다.
popCalendar --terminal --mode two-years --date 2027-01-01 --week-numbers
popCalendar --terminal --month 2027-03 --time-zone Europe/Kyiv --first-weekday monday
popCalendar --terminal --year 2027 --width 120 --color never > calendar.txt
popCalendar --terminal --events today --json > agenda.json리디렉션된 출력은 일반 텍스트입니다. --json은 ANSI 서식 없는 구조화된 데이터를 반환하며 --interactive 또는 --color always와 함께 사용할 수 없습니다. 터미널 명령어는 읽기 전용이며 이벤트, 계획, 캘린더 세트를 변경하지 않습니다.
목차로 돌아가기캘린더 열기 및 제어
옵션은 --option value 또는 --option=value 형식을 지원합니다. 기본 세션 이름은 cli입니다. 세션을 재사용하면 같은 윈도우가 갱신됩니다. 독립적인 윈도우에는 서로 다른 이름을 사용하세요. 여섯 가지 모드를 모두 지원합니다.
popCalendar --open --session work --mode two-years --date 2027-01-01
popCalendar --popup --session picker --mode month --anchor 400,850,40,24 --size 520x720
popCalendar --update --session picker --date 2027-03-01
popCalendar --move --session picker --anchor 600,850,40,24
popCalendar --close --session picker전체 화면 오버레이에는 --presentation fullscreen과 --display current, main 또는 디스플레이 UUID를 사용하세요. macOS 스페이스를 만들지 않고 한 디스플레이를 채웁니다. Escape 또는 같은 세션을 다시 전환하면 닫힙니다. 전체 화면 세션에서는 크기, 위치, 앵커, 화살표 및 좌표 옵션을 거부합니다. 표시 방식을 바꾸기 전에 세션을 닫으세요.
popCalendar --toggle --session overview --presentation fullscreen --mode two-years --display current 목차로 돌아가기 확인된 날짜 선택 반환
--select는 선택기를 열고 확인을 기다립니다. 기본 제한 시간은 300초입니다. --timeout은 1부터 86400까지 설정할 수 있습니다. Escape, 선택기 닫기 또는 Control-C로 취소합니다. 마지막으로 사용한 캘린더 영역에서 최대 128개의 개별 범위를 반환합니다. --json이 없으면 각 줄에 START END가 표시됩니다. 양 끝 날짜를 모두 포함합니다.
popCalendar --select --session picker --mode month --date 2027-03-01 --json --timeout 300{"version":1,"status":"selected","session":"picker","timeZone":"America/Los_Angeles","ranges":[{"start":"2027-03-01","end":"2027-03-07"}]} 목차로 돌아가기 계획, 근무일 및 이미지
SET_UUID와 PLAN_UUID를 --sets와 --plans가 반환하는 ID로 바꾸세요. REQUEST_UUID와 NEW_REQUEST_UUID에는 서로 다른 UUID를 사용하세요. 필요한 권한은 자동화 개요에 설명되어 있습니다.
| 명령 또는 옵션 | 기능 |
|---|---|
--help | 전체 명령 및 옵션 참조를 출력합니다. |
--version | 앱 버전과 빌드를 출력합니다. |
--capabilities [--json] | 앱을 열지 않고 지원 명령과 한도를 반환합니다. |
--doctor [--json] [--timeout SECONDS] | 앱 신원, 권한 설정 및 앱과의 통신을 확인합니다. |
--sets [--json] | 저장된 캘린더 세트의 이름과 ID를 반환합니다. |
--sessions [--json] | Mac에서 열린 연동 세션 ID를 반환합니다. |
--plans [--name SEARCH] [--id UUID] [--json] | 저장된 계획, 날짜 범위 및 반복 정보를 반환합니다. 이름 또는 ID로 필터링합니다. |
--create-plan --name NAME --start YYYY-MM-DD --end YYYY-MM-DD [--request-id UUID] | 양 끝 날짜를 포함하는 이름 있는 범위를 저장하고 계획 ID를 반환합니다. |
--duplicate-plan --id UUID --name NAME [--request-id UUID] | 저장된 계획을 새 이름으로 복제하고 ID를 반환합니다. |
--open-plan --id UUID | 현재 범위와 반복 설정으로 저장된 계획을 엽니다. |
--activate-set --calendar-set UUID | 현재 날짜와 레이아웃을 유지하면서 활성 캘린더 세트를 변경합니다. |
--working-days --start YYYY-MM-DD --end YYYY-MM-DD | 활성 근무 일정과 종일 휴무 캘린더를 사용해 근무일을 계산합니다. 양 끝 날짜를 포함합니다. |
--shift-working-days --start YYYY-MM-DD --count INTEGER | 근무일 단위로 앞이나 뒤로 이동합니다. 시작일은 세지 않습니다. |
--pause-chimes --minutes INTEGER | 지정한 분 수만큼 차임을 일시 정지합니다. 최대 7일입니다. |
--resume-chimes | 설정된 차임 일정과 활성 상태를 유지하면서 일시 정지를 끝냅니다. |
--export --start YYYY-MM-DD --end YYYY-MM-DD [--calendar-set UUID] [--plans UUID,UUID] [--events] | 최대 두 달력 연도의 PNG를 내보냅니다. 요청한 저장 계획만 포함합니다. 이벤트 원은 요청한 경우에만 포함합니다. |
API 날짜는 앱 시간대의 그레고리력 YYYY-MM-DD를 사용합니다. 근무일 계산에는 활성 근무 일정이 필요합니다. 날짜 조회는 10년, 이동은 2,600근무일로 제한됩니다. 이벤트 읽기에 실패하면 휴무일을 0으로 처리하지 않고 오류를 반환합니다.
계획 생성이나 복제를 재시도할 때 같은 요청 UUID와 동일한 내용을 사용하세요. 재시도는 기존 ID를 반환합니다. 내용이 다르면 실패합니다. 결과를 편집하거나 삭제한 뒤에는 UUID를 재사용하지 마세요. 시간 초과나 취소는 이미 적용된 변경을 되돌리지 않습니다.
popCalendar --sets --json
popCalendar --plans --name Holiday --json
popCalendar --create-plan --name Holiday --start 2027-08-02 --end 2027-08-13 --request-id REQUEST_UUID
popCalendar --duplicate-plan --id PLAN_UUID --name Variation --request-id NEW_REQUEST_UUID--export는 PNG 바이트를 표준 출력에 씁니다. 파일로 리디렉션하세요. 요청한 범위가 강조 표시되며 일반 윈도우와 저장된 설정은 바뀌지 않습니다. CLI 내보내기는 PDF가 아닌 PNG를 생성합니다.
popCalendar --export --start 2027-01-01 --end 2027-12-31 --calendar-set SET_UUID --plans PLAN_UUID --events > calendar.png 목차로 돌아가기 결과와 오류
제어 명령은 기본적으로 수락을 최대 60초 기다립니다. --wait는 선택 사항입니다. --no-wait는 전달만 확인하며 --timeout과 함께 쓰거나 선택, 데이터, 진단에 사용할 수 없습니다. 수락이 이벤트 로딩 완료를 의미하지는 않습니다.
데이터 명령은 JSON을 반환합니다. --json을 쓰면 성공이나 실패가 표준 출력의 JSON 객체 하나로 반환됩니다. 오류에는 errorCode, message, exitCode가 포함됩니다. --json이 없으면 표준 오류 출력을 사용합니다. --export는 이미지 바이트를 반환하며 --json을 사용할 수 없습니다.
{"version":1,"status":"error","errorCode":"invalid_arguments","message":"Unknown option --example.","exitCode":64,"command":"open"}| 종료 코드 | 기능 |
|---|---|
0 | 성공 |
2 | 선택 취소됨 |
3 | 시간 초과 |
4 | 앱 실행 또는 연결 실패 |
5 | 앱이 요청을 거부함 |
64 | 잘못된 명령 또는 인수 |
70 | 내부 오류 또는 응답 채널 오류 |
128 + signal | 신호에 의해 중단됨. Control-C는 130 |
연결 진단
--doctor는 필요하면 앱을 백그라운드에서 실행합니다. 기본 제한 시간은 10초입니다. 권한을 바꾸거나 캘린더 내용을 반환하지 않습니다. 성공한 JSON 진단은 result.diagnostics에 있으며 connection은 connected, permissionSource는 app입니다. 실패한 검사는 최상위 diagnostics 객체에 로컬 권한 값을 포함합니다. 이 값은 응답하지 않는 앱의 저장되지 않은 상태와 다를 수 있습니다.
popCalendar --doctor --json 목차로 돌아가기 내용과 배치
| 명령 또는 옵션 | 기능 |
|---|---|
--presentation | 기본값은 window이며 popup 또는 fullscreen을 사용할 수 있습니다. 표시 방식을 바꾸기 전에 열린 세션을 닫으세요. |
--mode | month, two-months, year, two-years, month-year 또는 month-two-years. 기본값은 year입니다. |
--date | 앱 시간대의 그레고리력 YYYY-MM-DD입니다. 기본값은 범위의 첫 날짜 또는 오늘입니다. |
--start, --end | 양 끝을 포함하는 YYYY-MM-DD 범위입니다. 둘 다 지정하며 start는 end보다 늦을 수 없습니다. |
--clear-selection | 날짜 선택을 해제합니다. --start 및 --end와 함께 사용할 수 없습니다. |
--calendar-set | 저장된 세트 UUID 또는 현재 필터를 복사하는 current입니다. CLI나 단축어에서 ID를 얻으세요. 알 수 없는 ID는 거부됩니다. |
--display | 전체 화면 전용입니다. current는 포인터가 있는 디스플레이, main은 기본 디스플레이를 사용합니다. 디스플레이 UUID도 지정할 수 있습니다. 연결되지 않은 디스플레이는 사용 가능한 화면으로 대체됩니다. |
--width, --height | 콘텐츠 크기를 논리 포인트로 지정하며 각 값은 240부터 8192까지입니다. 두 값을 모두 제공하세요. 팝업은 처음 표시되는 순간부터 요청한 크기를 유지합니다. 일반적인 크기 조절 가능 윈도우는 읽기 쉬운 최소 크기까지 커질 수 있습니다. 화면 경계가 우선합니다. CLI는 --size WIDTHxHEIGHT도 지원합니다. |
--anchor | 전역 화면 좌표의 x,y,width,height로 팝업 앵커 사각형을 지정합니다. x 및 y와 함께 쓸 수 없습니다. |
--x, --y | 앵커 대신 명시적 위치를 지정합니다. 둘 다 필요합니다. 위치를 명시한 팝업에는 화살표가 없습니다. |
--coordinates | appkit은 기본 화면의 왼쪽 아래를 원점으로 사용합니다. top-left는 왼쪽 위에서 아래로 측정합니다. 보조 디스플레이에는 음수 좌표가 있을 수 있습니다. 단위는 픽셀이 아닌 포인트입니다. |
--arrow | auto, top, bottom, left, right 또는 none입니다. 화살표가 있는 팝업 가장자리를 지정합니다. 패널을 보이게 유지하려고 배치가 반전될 수 있습니다. |
--callback | 명시적으로 확인한 날짜를 반환할 등록된 사용자 지정 URL 스킴입니다. |
CLI는 같은 이름에 -- 접두사를 붙입니다. 단, selection=clear는 --clear-selection이 됩니다. 전체 화면은 display 외의 모든 배치 옵션을 거부합니다. 알 수 없거나 중복된 매개변수, 잘못된 날짜 및 16 KiB가 넘는 URL은 전체가 거부됩니다.
목차로 돌아가기