Hammerspoon API 문서 한글판

Hammerspoon 핵심 기능 (설정 리로드, 콘솔, 경로, 버전 등 최상위 API)

Lua 변수(특히 테이블)를 사람이 읽기 좋은 문자열로 출력

디버깅용 간단한 로거

JSON 인코딩 / 디코딩

Base64 인코딩 / 디코딩

Hammerspoon 안에서 쓸 수 있는 다양한 해시 알고리즘

유용한 수학 함수 모음

함수형 프로그래밍 유틸리티 (map, filter, reduce 등)

UTF-8 인코딩 기본 지원 함수

2차원 평면의 점·크기·사각형(rect)을 표현하는 유틸리티 객체

간단한 Lua 변수를 Hammerspoon 재시작 후에도 유지되도록 저장

Lua용 최소 기능의 키-값 옵저버(Key-Value-Observer) 프레임워크

Property List(plist) 파일 읽기 / 쓰기

SQLite 데이터베이스 다루기

실행 중인 애플리케이션 조작

앱 실행 / 종료 이벤트 감시

hs.application, hs.window 객체를 쉽게 찾기

창(window) 조회 / 조작 (이동, 크기 조절, 포커스 등)

앱·제목·화면 위치 등으로 창을 필터링하고, 해당 창들의 이벤트를 쉽게 구독

현재 포커스된 창을 강조 표시

창 단위로 동작하는 cmd-tab 대체 도구

창 레이아웃 매니저 (앱별 창 위치를 규칙으로 배치)

창을 격자(grid) 단위로 이동 / 크기 조절

키보드 기반의 Exposé(미션 컨트롤) 대체 / 확장

앱마다 임시 단축키를 띄워 빠르게 포커스 전환

한 앱의 여러 창을 타이틀바에 그린 탭으로 묶기

tmuxomatic 스타일의 창 관리

macOS 스페이스(Spaces) 제어용 기본 함수

현재 스페이스가 바뀌는 것을 감시

전역 키보드 단축키 생성 / 관리

모달(modal) 방식 단축키 환경 생성 / 관리 (특정 키를 누른 뒤에만 유효한 단축키 등)

입력 이벤트(마우스, 키보드, 트랙패드)를 가로채 관찰하거나 필요하면 덮어쓰기

hs.eventtap에서 쓰는 이벤트를 생성 / 수정 / 조회

키 문자열 ↔ 키코드 변환, 키보드 레이아웃 조회 / 변경

마우스 포인터 위치 조회 / 조작

HID 인터페이스. Caps Lock 상태 제어 / 조회

HID LED 인터페이스. 키보드 LED 상태 제어

입으로 내는 소리(휘파람, 혀 차는 소리 등)를 인식하는 저지연 오디오 인식기 2종. 스크롤·클릭 같은 동작 트리거에 사용

화면(모니터) 조작

화면 배치 변경 감시

디스플레이 밝기 조회 / 조절

밤에 보기 편하도록 일정에 맞춰 화면 색상을 반전하거나 색온도를 낮춤

Hammerspoon에서 그림을 그리는 또 다른 방식 (hs.drawing의 후속)

hs.canvas의 변형(transform) 속성 값으로 쓸 수 있는 기본 행렬 연산 지원

시스템 색상 목록 접근 및 다양한 색상 표현 방식 제공

다른 모듈에서 가져온 이미지 객체를 캡처 / 조작 (hs.drawing과 함께 사용)

텍스트 스타일(굵기, 색, 폰트 등) 제어 지원

화면에 간단한 알림 메시지 표시

화면 오른쪽 알림 센터(User Notification Center)에 알림 생성

사용자 상호작용용 대화상자·알림·패널 모음

사용자가 색상을 고르는 패널

데이터를 선택 / 검색하는 그래픽 상호작용 도구 (Spotlight·Alfred 같은 검색창)

메뉴바 아이콘 생성 / 관리

Hammerspoon의 Dock 아이콘 제어

Hammerspoon 콘솔 조작 함수 모음

Hammerspoon에서 웹 콘텐츠를 창으로 표시

hs.webview로 방문한 웹사이트가 남긴 각종 데이터를 목록 조회 / 삭제

Hammerspoon 콘솔이나 hs.webview 객체에 붙일 수 있는 툴바 생성 / 조작

웹뷰에 사용자 정의 JavaScript를 주입하고, JavaScript에서 Hammerspoon으로 메시지를 보낼 수 있게 지원

시스템 오디오 장치 조작 (볼륨, 음소거, 기본 장치 등)

오디오 장치의 데이터 소스 조회 / 조작

시스템 수준 오디오 하드웨어 이벤트 감시

사운드 파일 로드 / 재생 / 조작

Spotify 음악 플레이어 제어

iTunes 음악 플레이어 제어

Deezer 음악 플레이어 제어

VOX 음악 플레이어 제어

OS X 음성 합성(Speech Synthesizer) 컴포넌트 접근 (텍스트 읽어주기)

OS X 음성 인식(Speech Recognizer) 컴포넌트 접근

시스템 카메라 장치 조회

배터리 / 전원 정보

배터리 / 전원 상태 변화 감시

시스템 전원 상태 제어 (절전, 절전 방지, 화면 잠금 등)

디스플레이 / 시스템 절전·깨움·전원 이벤트 감시

Hammerspoon이 실행 중인 기기의 정보 조회

사용자의 언어 및 지역 설정 조회

USB 장치 조회

USB 장치 연결 / 해제 이벤트 감시

기기의 위치와 그 위치에 관한 유용한 정보 확인

GPS 좌표 ↔ 주소·관심 지점 같은 사용자 친화적 표현 간 변환

Hammerspoon용 MIDI 확장

시리얼 포트(주로 RS-232)로 외부 장치와 통신

Elgato Stream Deck 설정 / 제어

Razer 장치 지원

Tangent 컨트롤 서피스 확장

MiLight LED WiFi 브리지(LimitlessLED, EasyBulb로도 불림)의 간단한 제어

파일 시스템 접근 / 조회

OS X 파일 시스템 볼륨 다루기

파일과 디렉터리의 확장 속성(extended attributes) 조회 / 조작

경로를 재귀적으로 감시해 변경 감지 (설정 파일 자동 리로드에 자주 사용)

Spotlight 메타데이터 쿼리 수행

페이스트보드(클립보드) 조회 / 조작. 시스템 기본 클립보드와 이름 붙인 커스텀 클립보드 모두 사용 가능

클립보드 변경 감시

네트워크 상태 조회 및 변경 감시

호스트 이름, 주소, 도달 가능성 등 호스트 정보 확인

호스트 가용성을 확인하는 기본 ping 함수. 대상까지의 경로가 있는지, 응답하는지 확인

대상 호스트의 도달 가능성 확인. 패킷이 로컬 기기를 떠날 수 있으면 도달 가능으로 간주하며, 실제 수신까지 보장하지는 않음

WiFi 네트워크 조회

연결된 WiFi 네트워크 변경 감시

멀티캐스트 DNS(Bonjour)로 알려지는 네트워크 서비스를 찾거나 게시

hs.bonjour가 발견했거나 게시한 서비스 레코드를 표현하는 객체

HTTP 요청 수행

간단한 HTTP 서버

Hammerspoon용 최소 기능 웹 서버

비동기 TCP 소켓 또는 UNIX 파일 소켓으로 사용자 정의 프로토콜과 통신

비동기 UDP 소켓으로 사용자 정의 프로토콜과 통신

간단한 웹소켓 클라이언트

프로세스 간 통신(IPC)을 위한 로컬 / 원격 메시지 포트 생성 (hs 커맨드라인 도구가 사용)

프로세스를 백그라운드로 실행하고 출력 캡처 (셸 명령 실행)

다양한 타이밍 규칙으로 함수 실행 (주기 실행, 지연 실행 등)

예측 불가능한 비동기 이벤트를 하나의 콜백으로 묶어 처리하는 특수 타이머 (디바운스 용도)

AppleScript 코드 실행

OSA(Open Scripting Architecture) 코드 실행 — AppleScript와 JavaScript

JavaScript 코드 실행

Hammerspoon이 URL(hammerspoon://...)에 반응하도록 함

단축어(Shortcuts) 앱의 단축어 목록 조회 및 실행

Spoon(플러그인) 유틸리티 및 관리 함수

iMessage와 SMS 릴레이로 메시지 전송 (SMS 릴레이는 OS X 10.10 이상, Mac과 iOS 8 iPhone 간 SMS 릴레이 페어링 필요)

Hammerspoon에서 macOS 공유 서비스(Sharing Services)로 항목 공유

OS X UI 요소를 다루기 위한 범용 프레임워크

특정 UI 요소(창과 앱 포함)의 이벤트 감시

실행 중인 앱, 창, 메뉴 및 OS X 접근성 API를 지원하는 UI 요소의 접근성 객체에 접근

Hammerspoon 안의 대화형 도움말용 문서 객체 생성

내부 문서 웹 서버 관리