동작 라이브러리#
사전 설정 동작은 탭 닫기나 창 가운데 배치처럼 하려는 작업을 나타냅니다. Mousetroke는 사전 설정 ID와 매개변수를 저장하고 실행할 때 Windows 또는 Mac 구현을 선택합니다. 브라우저와 편집기 단축키는 입력을 받는 앱에서도 지원해야 합니다.
동작 선택하기#
제스처를 만들거나 선택한 다음 동작 선택을 클릭하세요. 기존 동작에서는 변경을 클릭합니다.
이름, 설명, 별칭 또는 단축키 표기로 검색하세요. 예를 들어 Windows에서는
ctrl+w, Mac에서는cmd+w/⌘w를 쓸 수 있습니다. 검색은 모든 범주를 대상으로 합니다. 검색어가 없으면 자주 사용, 브라우저, 편집, 문자, 창, 데스크톱 및 시스템, 미디어, 열기, Mousetroke를 둘러볼 수 있습니다.결과를 선택하세요. 매개변수가 있는 동작은 입력 양식을 엽니다. 텍스트를 입력하거나 날짜 형식과 검색 서비스를 고르고, URL을 입력하거나 파일, 폴더, 앱을 선택한 다음 이 동작 사용을 클릭해 확인하세요. 사용할 수 없는 동작은 비활성화되며 플랫폼 제한이나 2단계 구현 예정이라는 이유가 표시됩니다.
설정 밖에서 제스처를 시험하세요. 제스처 이름이 비어 있으면 선택한 동작 이름을 따릅니다. 메뉴 항목도 같은 선택기를 사용합니다.
선택기가 열리면 검색창에 초점이 놓입니다. 위아래 화살표로 사용할 수 있는 결과 사이를 이동하고 Enter로 선택하세요. Esc는 매개변수 양식을 먼저 닫고 다음에 선택기를 닫습니다. 여러 줄 텍스트 입력란에서는 Ctrl+Enter 또는 Command+Enter로 양식을 확인합니다.
고급 동작으로 변환은 사전 설정을 현재 플랫폼에서 편집할 수 있는 키, 창 작업, URL, 앱, 명령 또는 시스템 키로 바꿉니다. 확인 창에서 안내하듯 이 변환은 되돌릴 수 없으며, 결과는 사전 설정의 플랫폼별 또는 언어별 기본값을 더 이상 따르지 않습니다. 기본 창 배치, 전원, 텍스트 그대로 입력, 날짜와 시간, 일반 텍스트 복사, 일시 정지, 설정 동작은 사전 설정 형태를 유지하고 카드에 변환할 수 없는 이유를 표시합니다. 목록 끝의 고급 범주에서 키 보내기, 명령, Lua, 메뉴를 사용할 수 있습니다. 기존 편집기는 고급 동작 설명에서도 다룹니다.
텍스트, 창과 전원#
텍스트 입력은 공백, 줄바꿈, 중국어, 이모지와
^+#{ENTER}같은 문자를 포함해 텍스트를 그대로 출력합니다. 기본 방법인 붙여넣은 후 클립보드 복원은 클립보드를 잠시 사용하고 짧게 기다린 뒤 이전 텍스트를 복원합니다. 이미지, HTML, 파일 목록 등 텍스트가 아닌 데이터가 있거나 내용을 확인할 수 없으면 클립보드를 변경하지 않고 직접 입력합니다.paste_delay_ms는paste일 때만 표시되며 UI에서 50–5000 ms를 설정할 수 있고 기본값은 150 ms입니다. 문자 입력은 클립보드를 사용하지 않고 Unicode 입력을 보냅니다. 두 방법 모두 키보드 입력을 받는 앱에 출력합니다.날짜와 시간 입력은 시스템의 현지 시각과 선택한 출력 방법을 사용합니다. ISO 날짜, 중국식 날짜, 미국식 날짜, 시간, 날짜와 시간을 선택할 수 있습니다. 사용자 지정 패턴은 대소문자를 구분하는
YYYY,MM,DD,HH,mm,ss를 지원합니다. 다른 문자는 그대로 출력하며 작은따옴표로 감싼 텍스트는 문자 그대로 처리하고''는 작은따옴표 하나를 출력합니다. 예를 들어YYYY-MM-DD HH:mm:ss는 날짜와 시간을 출력합니다. 닫히지 않은 따옴표는 거부합니다.선택한 내용을 일반 텍스트로 복사는 Ctrl+C / Command+C를 보내고 최대 500 ms 동안 클립보드 버전 변경을 기다린 다음 복사한 내용을 텍스트만 남기도록 바꿉니다. 복사가 끝나지 않거나 텍스트가 없으면 실패를 알리고 클립보드 내용을 유지합니다. 사용하기 전에 텍스트를 선택하고 해당 앱에 초점을 유지하세요.
배치 동작은 다른 창 동작과 같은 제스처 대상을 사용하며 기본 설정 → 제스처가 작용할 대상을 따릅니다. Windows는 기본 창 위치 기능을, Mac은 손쉬운 사용과 화면의 사용 가능한 영역을 사용합니다. 창의 최소 크기나 앱 제한으로 인해 정확히 화면 절반에 맞추지 못할 수 있습니다. Mac에서는 먼저 기본 전체 화면에서 나가세요. 다음 모니터로 이동은 일정한 순서로 화면을 순환하며 상대 위치와 최대화 상태를 유지합니다. 화면이 하나면 이동하지 않습니다.
디스플레이 끄기로 화면을 끈 뒤에는 입력으로 다시 켤 수 있습니다. 절전 모드는 일반 시스템 절전을 요청하며 계정이나 시스템 정책에 따라 거부될 수 있습니다. 기본 동작에 실패하면 로그 한 줄을 기록하고 짧은 화면 메시지를 표시합니다. 제스처 일시 중지 / 재개는 트레이와 단축키와 같은 일시 정지 상태를 사용합니다. 일시 정지 중에는 트레이나 단축키로 재개하세요. 설정 열기는 평소의 설정 창을 엽니다.
전체 목록#
아래 표는 레지스트리에서 생성되며 전체 87개 항목을 포함합니다. ✓는 해당 플랫폼에 구현되어 있다는 뜻이며, 실제 사용 가능 여부는 앱, 하드웨어와 필요한 권한에도 달려 있습니다. 제스처 요약표는 2단계에서 제공할 예정입니다.
<!-- action-library:generated:start -->
브라우저#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
뒤로<br>browser.back | 웹 브라우저에서 사용. | — | ✓ | ✓ |
앞으로<br>browser.forward | 웹 브라우저에서 사용. | — | ✓ | ✓ |
새로 고침<br>browser.reload | 웹 브라우저에서 사용. | — | ✓ | ✓ |
캐시 없이 새로고침<br>browser.hard_reload | 웹 브라우저에서 사용. | — | ✓ | ✓ |
새 탭<br>browser.new_tab | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
탭 닫기<br>browser.close_tab | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
닫은 탭 다시 열기<br>browser.reopen_tab | 웹 브라우저에서 사용. | — | ✓ | ✓ |
이전 탭<br>browser.prev_tab | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
다음 탭<br>browser.next_tab | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
새 창<br>browser.new_window | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
새 시크릿 창<br>browser.private_window | Chrome, Edge, Safari용. Firefox는 다른 단축키 사용. | — | ✓ | ✓ |
주소 표시줄로 이동<br>browser.address_bar | 웹 브라우저에서 사용. | — | ✓ | ✓ |
페이지에서 찾기<br>browser.find | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
이 페이지 북마크<br>browser.bookmark | 웹 브라우저에서 사용. | — | ✓ | ✓ |
확대<br>view.zoom_in | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
축소<br>view.zoom_out | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
확대/축소 초기화<br>view.zoom_reset | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
편집#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
맨 위로<br>view.top | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
맨 아래로<br>view.bottom | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
한 페이지 위로<br>view.page_up | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
한 페이지 아래로<br>view.page_down | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
복사<br>edit.copy | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
잘라내기<br>edit.cut | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
붙여넣기<br>edit.paste | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
붙여넣고 Enter<br>edit.paste_enter | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
일반 텍스트로 붙여넣기<br>edit.paste_plain | 일반 텍스트 붙여넣기를 지원하는 앱. 앱마다 단축키가 다를 수 있음. | — | ✓ | ✓ |
모두 선택<br>edit.select_all | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
실행 취소<br>edit.undo | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
다시 실행<br>edit.redo | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
저장<br>edit.save | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
Enter<br>key.enter | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
Backspace<br>key.backspace | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
Delete<br>key.delete | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
취소(Esc)<br>key.escape | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
전체 화면<br>view.fullscreen | 이 단축키를 지원하는 브라우저, 편집기 등. | — | ✓ | ✓ |
문자#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
텍스트 입력<br>text.type | 텍스트 입력란용. 기본적으로 붙여넣은 후 클립보드를 복원. | 텍스트 (text): 필수<br>입력 방식 (method): 붙여넣은 후 클립보드 복원 (paste) / 문자 입력 (type); 기본값: 붙여넣은 후 클립보드 복원<br>붙여넣기 후 대기 시간(ms) (paste_delay_ms): 기본값: 150; 입력 방식 항목이 붙여넣은 후 클립보드 복원일 때만 표시 | ✓ | ✓ |
날짜와 시간 입력<br>text.datetime | 텍스트 입력란용. 로컬 날짜와 시간을 사용. | 날짜 및 시간 형식 (format): 2026-10-24 (date_iso) / 2026年10月24日 (date_local) / 10/24/2026 (date_us) / 14:30 (time) / 2026-10-24 14:30 (datetime) / 사용자 지정 (custom); 기본값: 2026-10-24<br>사용자 지정 형식 (custom_format): 기본값: YYYY-MM-DD; 날짜 및 시간 형식 항목이 사용자 지정일 때만 표시<br>입력 방식 (method): 붙여넣은 후 클립보드 복원 (paste) / 문자 입력 (type); 기본값: 붙여넣은 후 클립보드 복원<br>붙여넣기 후 대기 시간(ms) (paste_delay_ms): 기본값: 150; 입력 방식 항목이 붙여넣은 후 클립보드 복원일 때만 표시 | ✓ | ✓ |
선택한 텍스트 검색<br>text.search | 기본 브라우저 사용. 먼저 현재 앱에서 텍스트를 선택. | 검색 엔진 (engine): Bing (bing) / Google (google) / Baidu (baidu) / DuckDuckGo (duckduckgo) / 사용자 지정 (custom); 중국어 간체 UI는 Baidu, 나머지 언어는 Google이 기본값<br>사용자 지정 URL (url): 기본값: https://www.google.com/search?q=%MS_SELECTED_TEXT%; 검색 엔진 항목이 사용자 지정일 때만 표시 | ✓ | ✓ |
선택한 텍스트 번역<br>text.translate | 기본 브라우저 사용. 먼저 현재 앱에서 텍스트를 선택. | 번역 서비스 (service): Google 번역 (google) / DeepL (deepl) / Bing 번역 (bing); 기본값: Google 번역<br>대상 언어 (target_language): 인터페이스 언어 따르기 (ui) / 简体中文 (zh-CN) / English (en-US) / español (es-ES) / Français (fr-FR) / Deutsch (de-DE) / 日本語 (ja-JP) / Português (Brasil) (pt-BR) / Русский (ru-RU) / Italiano (it-IT) / 한국어 (ko-KR); 기본값: 인터페이스 언어 따르기 | ✓ | ✓ |
선택한 URL 열기<br>text.open_selected_url | 기본 브라우저 사용. 먼저 현재 앱에서 텍스트를 선택. | — | ✓ | ✓ |
선택한 내용을 일반 텍스트로 복사<br>text.copy_plain | 텍스트 복사가 가능한 앱. 클립보드의 서식을 제거. | — | ✓ | ✓ |
창#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
최소화<br>window.minimize | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
최대화 / 복원<br>window.toggle_maximize | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
창 닫기<br>window.close | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
앱 종료<br>app.quit | 제스처 대상 창에 적용합니다. | — | ✓ | ✓ |
프로세스 강제 종료<br>app.kill | 대상 앱 강제 종료. 저장하지 않은 내용은 손실됨. | — | ✓ | ✓ |
항상 위<br>window.toggle_topmost | 대상 창의 항상 위 표시를 전환합니다. | — | ✓ | 이 동작은 Windows에서만 지원됩니다. |
화면 왼쪽 절반에 배치<br>window.snap_left | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
화면 오른쪽 절반에 배치<br>window.snap_right | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
창을 가운데로<br>window.center | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
다음 모니터로 이동<br>window.next_monitor | 제스처 대상 창에 적용합니다. | — | ✓ | ✓<br>손쉬운 사용 권한이 필요합니다. |
현재 앱 숨기기<br>app.hide | 현재 앱을 숨깁니다. | — | 이 동작은 macOS에서만 지원됩니다. | ✓ |
데스크톱 및 시스템#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
앱 전환<br>desktop.switch_app | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
작업 보기 / Mission Control<br>desktop.task_view | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
바탕 화면 표시<br>desktop.show | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
이전 가상 바탕 화면<br>desktop.prev | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
다음 가상 바탕 화면<br>desktop.next | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
시작 메뉴 / Spotlight<br>desktop.launcher | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
파일 관리자 열기<br>desktop.files | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
캡처<br>capture.region | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
전체 화면 캡처 후 저장<br>capture.screen | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
스크린샷 및 녹화 도구<br>capture.tool | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
클립보드 기록<br>desktop.clipboard_history | 클립보드 기록을 엽니다. | — | ✓ | 이 동작은 Windows에서만 지원됩니다. |
이모티콘 및 기호<br>desktop.emoji | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
알림 센터<br>desktop.notifications | 알림 센터를 엽니다. | — | ✓ | 이 동작은 Windows에서만 지원됩니다. |
화면 잠금<br>system.lock | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
작업 관리자 / 활성 상태 보기<br>system.task_manager | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
강제 종료 대화상자<br>system.force_quit_dialog | 앱 강제 종료 대화상자를 엽니다. | — | 이 동작은 macOS에서만 지원됩니다. | ✓ |
시스템 설정<br>system.settings | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
계산기<br>system.calculator | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
디스플레이 끄기<br>system.display_off | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
절전 모드<br>system.sleep | 시스템 기능. 일부 동작은 시스템 단축키 설정에 따름. | — | ✓ | ✓ |
미디어#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
재생 / 일시 정지<br>media.play_pause | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
이전 트랙<br>media.previous | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
다음 트랙<br>media.next | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
볼륨 높이기<br>media.volume_up | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
볼륨 낮추기<br>media.volume_down | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
음소거<br>media.mute | 시스템 미디어 키. 플레이어 지원 필요. | — | ✓ | ✓ |
밝게<br>display.brightness_up | 시스템 밝기 조절. 디스플레이와 드라이버 지원에 따름. | — | ✓ | ✓ |
어둡게<br>display.brightness_down | 시스템 밝기 조절. 디스플레이와 드라이버 지원에 따름. | — | ✓ | ✓ |
열기#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
웹사이트 열기<br>open.website | 지정한 URL을 기본 브라우저로 열기. | URL (url): 기본값: https://mousetroke.com/ | ✓ | ✓ |
폴더 열기<br>open.folder | 지정한 경로를 시스템 기본 앱으로 열기. | 경로 (path): 필수 | ✓ | ✓ |
파일 열기<br>open.file | 지정한 경로를 시스템 기본 앱으로 열기. | 경로 (path): 필수 | ✓ | ✓ |
앱 열기 또는 전환<br>open.app | 앱을 열거나 기존 창으로 전환. | 앱 (app): 필수 | ✓ | ✓ |
Mousetroke#
| 동작 / ID | 기능과 사용 범위 | 매개변수 | Windows | Mac |
|---|---|---|---|---|
제스처 일시 중지 / 재개<br>mousetroke.toggle_pause | Mousetroke 제스처 인식을 일시 중지하거나 재개. | — | ✓ | ✓ |
설정 열기<br>mousetroke.settings | Mousetroke 설정 열기. | — | ✓ | ✓ |
제스처 목록 표시<br>mousetroke.cheatsheet | 현재 앱에서 사용할 수 있는 제스처 목록. 2단계 제공 예정. | — | 이 동작은 2단계에서 제공될 예정입니다. | 이 동작은 2단계에서 제공될 예정입니다. |
<!-- action-library:generated:end -->
레지스트리나 번역을 바꾼 뒤 UPDATE_ACTION_DOCS=1을 설정하고 cargo test -p mousetroke-core --test action_docs를 실행하면 열 가지 언어의 목록이 모두 갱신됩니다. 이 변수 없이 같은 명령을 실행하면 저장소에 반영된 표가 최신인지 확인합니다.