Mouse Gesture v0.61

Mouse Gesture 0.6.1 사용설명서

이 프로그램은 Windows에서 실행되는 마우스 제스처 프로그램입니다. 창을 계속 띄우지 않고, 작업 표시줄 오른쪽 아래의 시스템 트레이 아이콘으로 실행됩니다.

1. 실행 방법

1. mouse-gesture.exe와 config.json을 같은 폴더에 둡니다.
2. mouse-gesture.exe를 더블클릭합니다.
3. 화면에 창이 바로 뜨지 않아도 정상입니다.
4. 작업 표시줄 오른쪽 아래에서 숨겨진 아이콘 표시(^)를 눌러 Mouse Gesture 아이콘을 확인합니다.

같은 Windows 로그인 세션에서는 한 번만 실행됩니다. 다시 더블클릭하거나 다른 폴더에 복사한 실행 파일을 실행하면 기존 프로그램은 그대로 두고 새 실행만 종료합니다. 트레이로 실행 중인 구버전도 감지합니다. 정상 종료나 강제 종료 후에는 다시 실행할 수 있습니다.

다른 PC에서도 설치 프로그램을 실행할 필요가 없습니다. MouseGesture-0.6.1-Windows-x64.zip을 받은 경우 압축을 풀고 그 폴더 안의 mouse-gesture.exe를 실행하면 됩니다.

배포 ZIP에는 다음 실행·설정·안내 파일과 검증용 목록이 들어 있습니다.

• mouse-gesture.exe
• config.json
• 사용설명서.txt

0.6.1의 작은 설정 창

• 제스처: 적용 대상을 고르고 방향과 동작을 편집합니다. 연습과 단축키 기록도 여기에 있습니다.
• 앱 프로필: 앱 검색, 이름과 실행 파일 수정, 추가·삭제·복제를 합니다.
• 일반 설정: 감도, 제외 앱, 빠른 일시 정지, 로그인 시작, 진단을 설정합니다.
• 백업·복구: 설정 파일 위치 확인, 가져오기·내보내기·최신 읽기·백업 복원을 합니다.
• 탭을 바꿔도 작성 중인 내용은 유지됩니다. 하단 저장 및 적용은 제스처, 프로필, 감도 변경을 함께 저장합니다. 로그인 시작과 진단 수집 선택은 즉시 적용됩니다.

0.6.0에서 추가된 사용법

• 설정이 없거나 잘못된 경우 제스처가 비활성화됩니다. 설정 창에서 가져오기 또는 백업 복원으로 정상 설정을 준비하고 저장한 뒤 Enable로 재개하세요.
• 정상 설정을 저장하면 이전의 유효한 설정을 config.json.last-good에 보관합니다.
• 외부 수정 충돌이 나면 편집 내용은 유지됩니다. 내보내기로 초안을 보관한 뒤 최신 내용을 불러오거나, 내용을 확인하고 덮어쓰세요.
• 앱 프로필 검색과 복제를 사용할 수 있습니다. 앱의 특정 방향을 막으려면 동작을 '실행 안 함'으로 지정하세요. Global 실행은 차단되지만 우클릭 메뉴가 복원되지는 않습니다.
• 연습에서 방향을 확인하고, 단축키 기록에서 키 조합을 입력하세요. 이 도구에서는 등록한 프로그램이나 단축키를 실행하지 않습니다. Esc로 취소할 수 있습니다.
• Ctrl+Alt+G는 일시 정지/재개 단축키입니다. 설정에서 끌 수 있습니다. 다른 앱이 이미 사용 중이면 등록 실패 상태가 표시됩니다.
• '로그인할 때 시작'을 직접 켜면 현재 실행 파일을 로그인 시 시작합니다. 프로그램 폴더를 옮겼다면 새 위치에서 다시 설정하세요.
• 진단은 최근 방향, 대상 앱, 매핑 출처와 실행·취소 결과를 보여 줍니다. 최근 기록 수집은 선택 사항입니다. 오류 로그는 트레이에서 열 수 있습니다.

같은 설정으로 사용하려면 mouse-gesture.exe와 config.json을 함께 복사하세요. 사용설명서.txt는 안내용 파일입니다.

Rust, Cargo 같은 개발 도구는 다른 PC에 설치하지 않아도 됩니다. 별도 DLL 파일도 같이 복사할 필요가 없습니다. 현재 배포 파일은 Windows 10 1703 이상(x64) 또는 Windows 11(x64)용입니다. 32비트 Windows용 실행 파일은 아닙니다. 다른 PC에서의 실제 실행은 아직 직접 검증하지 않았습니다.

주의: 다른 PC에서 Chrome, Windows Terminal, VS Code 같은 프로그램이 설치되어 있지 않거나 실행 파일 이름이 다르면 해당 제스처가 실행되지 않을 수 있습니다. 이 경우 설정 창에서 실행 대상을 그 PC에 맞게 바꾸세요.

1. 실행 방법2. 기본 사용법

먼저 사용할 창을 왼쪽 클릭해 선택한 다음 제스처를 해보세요. 오른쪽 마우스 버튼을 누른 상태로 움직인 다음 버튼을 떼면 됩니다. 제스처 시작 거리 이상 움직이면 커서를 따라 파란 선이 그려집니다. 버튼을 떼거나 제스처가 취소되면 선이 사라집니다. 제외 앱이나 Disable 상태에서는 선이 표시되지 않습니다. 프로그램은 파란 바탕에 흰색 커서와 이동 궤적이 있는 전용 아이콘을 사용합니다. 트레이에서 Disable을 선택하면 아이콘이 회색으로 바뀝니다.

예:

• 오른쪽 버튼 누르기
• 아래로 조금 드래그
• 오른쪽 버튼 떼기

이 동작은 D 제스처입니다. Global 기본 설정에서는 메모장을 실행하며, 앱 전용 D가 있으면 그 동작을 실행합니다.

마우스를 거의 움직이지 않고 그냥 우클릭하면 원래 Windows 우클릭 메뉴가 나와야 합니다. 제스처로 인식하려면 기본 설정 기준 약 20픽셀 이상 움직여야 합니다.

3. 제스처 방향

제스처는 U, D, L, R 글자로 표시합니다.

• U = Up = 위
• D = Down = 아래
• L = Left = 왼쪽
• R = Right = 오른쪽

예:

• R : 오른쪽으로 드래그
• RD : 오른쪽으로 드래그한 뒤 아래로 드래그
• LU : 왼쪽으로 드래그한 뒤 위로 드래그

같은 방향으로 계속 움직인 것은 한 번으로 처리됩니다. 예를 들어 오른쪽으로 길게 움직이면 R 하나로 인식됩니다.

4. 기본 제스처

현재 배포 config.json의 Global은 다음과 같은 제스처를 예로 제공합니다.

• R : Chrome 실행(chrome.exe)
• L : 파일 탐색기 실행(explorer.exe)
• U : Windows Terminal 실행(wt.exe)
• D : 메모장 실행(notepad.exe)
• RD : VS Code 실행(code.exe)
• RU : Rust 홈페이지 열기
• LD : 현재 폴더 열기(.)

LD의 대상 값이 "."이면 프로그램을 실행한 작업 폴더를 뜻합니다. 항상 같은 폴더를 열고 싶으면 설정 창에서 절대경로를 지정하는 편이 좋습니다.

배포 설정에는 Chrome, VS Code, HWP의 앱별 제스처도 포함되어 있습니다(7-2절). 기존 config.json을 복사해서 사용하면 기존 매핑을 유지하며 앱 프로필을 자동으로 추가하지 않습니다.

5. 설정 창 열기

1. 작업 표시줄 오른쪽 아래의 Mouse Gesture 아이콘을 우클릭합니다.
2. Settings (설정)... 을 누릅니다.
3. 설정 창에서 제스처를 추가, 수정, 삭제합니다.
4. 마지막에 저장 및 적용을 누릅니다.

저장 및 적용을 누르면 config.json에 저장되고 실행 중인 프로그램에도 바로 적용됩니다. 따로 Reload Config를 누를 필요가 없습니다.

6. 기존 제스처 수정하기

예: R 제스처의 실행 대상을 바꾸는 방법

1. 제스처 탭의 적용 대상에서 Global 또는 수정할 앱을 고른 뒤 왼쪽 목록에서 R을 선택합니다.
2. 대상 칸을 원하는 프로그램 경로로 바꿉니다.
3. 파일을 직접 고르려면 찾아보기 버튼을 누릅니다.
4. 수정 버튼을 누릅니다.
5. 저장 및 적용 버튼을 누릅니다.

수정 버튼만 누르면 창 안의 목록만 바뀝니다. 실제 config.json과 실행 중 설정까지 바꾸려면 저장 및 적용을 눌러야 합니다.

7. 새 제스처 추가하기

1. 제스처 칸에 U, D, L, R 조합을 입력합니다. 예: R, L, U, D, RD, LU
2. 작업 종류를 선택합니다.
3. 대상을 입력합니다.
4. 프로그램이나 폴더는 찾아보기 버튼으로 고를 수 있습니다.
5. 추가 버튼을 누릅니다.
6. 저장 및 적용 버튼을 누릅니다.

현재 설정 창에서는 프로그램 실행, 웹사이트 열기, 폴더 열기, 키보드 단축키, 실행 안 함을 사용할 수 있습니다.

• 프로그램 실행
• URL 열기
• 폴더 열기
• 키보드 단축키 실행

아직 구현되지 않은 기능:

• 창 제어
• 클립보드 작업
• PowerShell/스크립트 전용 실행
• 제스처 편집기
• 여러 마우스 버튼 지원

7-1. 제스처로 키보드 단축키 실행하기

예: 아래→위(DU) 제스처에 Ctrl+Shift+T 연결하기

1. 트레이 아이콘을 우클릭하고 Settings (설정)... 을 엽니다.
2. 제스처 칸에 DU를 입력합니다.
3. 동작에서 키보드 단축키를 선택합니다.
4. 대상 칸에 Ctrl+Shift+T를 입력합니다.
5. 추가를 누르고 저장 및 적용을 누릅니다.
6. 사용할 앱을 선택한 뒤 오른쪽 버튼을 누른 채 아래→위로 움직이고 놓습니다.

기존 제스처를 바꿀 때는 왼쪽 목록에서 선택하고 추가 대신 수정을 누르세요. 단축키 모드에서는 인수와 찾아보기를 사용하지 않습니다.

입력 예:

• Alt+Left : 브라우저에서 뒤로 가기
• Ctrl+T : 브라우저에서 새 탭
• Ctrl+Shift+T : 브라우저에서 닫은 탭 다시 열기
• F5 : 새로고침

단축키의 기능은 현재 앱마다 다릅니다. 상단 적용 대상에서 앱을 선택하면 앱별로 다른 제스처를 등록할 수 있습니다. 위 예시는 자동 등록되지 않으므로 필요한 조합만 직접 추가하세요.

사용 가능한 키: Ctrl, Alt, Shift, Win과 AZ, 09, F1~F24, Tab, Enter, Esc, Space, Backspace, Delete, Insert, Home, End, PageUp, PageDown, Up, Down, Left, Right.

대소문자는 상관없습니다. Ctrl 같은 보조 키와 일반 키 한 개를 +로 연결하세요. F5처럼 한 키만 입력해도 됩니다. Ctrl만 입력하거나 A+B, Ctrl+Ctrl+T, Ctrl+처럼 잘못된 조합을 입력하면 저장하지 않습니다. 연속 키 매크로나 문장 입력은 지원하지 않습니다.

사용 중 다른 키를 누르고 있으면 충돌을 피하기 위해 단축키 전송을 건너뜁니다. 키보드에서 손을 뗀 뒤 제스처를 사용하세요. 제스처 도중 창이 바뀌거나 Disable하면 취소됩니다. 관리자 권한으로 실행된 앱과 일부 게임에서는 동작이 제한될 수 있습니다.

7-2. 앱별 제스처 설정하기

제스처를 시작한 활성 창의 실행 파일 이름으로 적용 대상을 고릅니다. 찾는 순서는 해당 방향의 앱 매핑 → Global 매핑 → 실행 없음입니다. 앱 매핑이 있지만 실행에 실패한 경우에는 Global 동작을 추가로 실행하지 않습니다.

배포 프로필:

• Chrome (chrome.exe): L=Alt+Left, R=Alt+Right, U=Ctrl+T, D=Ctrl+W
• VS Code (code.exe): L=Ctrl+PageUp, R=Ctrl+PageDown, D=Ctrl+F4
• HWP (hwp.exe): L=Alt+Shift+N, R=Alt+Shift+W, U=Alt+Shift+E, D=Alt+Shift+R

VS Code의 U는 앱에 등록하지 않았으므로 Global U인 Windows Terminal을 실행합니다. HWP 조합은 현재 설계에서 지정한 값입니다. 설치된 앱의 실제 실행 파일명과 사용자 단축키에 맞춰 수정할 수 있습니다.

1. 앱 프로필 탭의 적용 대상에서 Global 또는 앱을 선택합니다.
2. 앱 추가로 표시명과 실행 파일명을 등록합니다. 예: Chrome / chrome.exe. 전체 경로나 와일드카드 대신 .exe 파일명을 사용합니다. 대소문자는 구분하지 않습니다.
3. 제스처 탭으로 이동해 앱 전용 매핑을 추가하거나 수정합니다. [Global] 항목은 상속된 매핑입니다. 이 앱에 재정의를 누르면 앱 전용 매핑이 됩니다.
4. 저장 및 적용을 누르면 Global과 모든 앱의 편집 내용을 함께 저장합니다.

앱 매핑을 삭제하면 그 방향의 Global을 다시 사용합니다. 앱 자체를 삭제하면 모든 방향이 Global을 사용합니다. Global은 삭제할 수 없습니다. 감도와 제외 앱은 전체에 공통으로 적용됩니다. 제외 목록에 있는 앱은 프로필이 있어도 제스처를 실행하지 않습니다.

프로필을 바꾸기 전에 현재 입력이 유효해야 하며, 새로 입력한 제스처는 추가하거나 입력을 지워야 합니다. 앱 선택을 바꿔도 미저장 편집 내용은 유지됩니다. 설정 창의 편집 대상은 다른 창을 선택해도 자동으로 바뀌지 않습니다. 드래그 중 저장하거나 Reload해도 해당 드래그는 시작 시점의 설정을 사용합니다. 창을 바꾸면 제스처가 취소됩니다.

8. 제스처 삭제하기

1. 설정 창 왼쪽 목록에서 삭제할 제스처를 선택합니다.
2. 삭제 버튼을 누릅니다.
3. 저장 및 적용 버튼을 누릅니다.

저장 및 적용 전에는 파일에 반영되지 않습니다.

9. 실행 대상 입력 방법

프로그램 실행:

• 대상: 실행할 exe 파일 또는 실행 파일 이름
• 예: notepad.exe
• 예: C:\Program Files\Google\Chrome\Application\chrome.exe

URL 열기:

• 대상: 열 인터넷 주소
• 예: https://www.rust-lang.org

폴더 열기:

• 대상: 열 폴더 경로
• 예: C:\Users
• 예: .

프로그램 실행에서 인수가 필요하면 인수 칸에 입력합니다. Windows 명령줄 규칙처럼 공백이 있는 값은 큰따옴표로 감싸세요.

예:

--profile-directory "Default"

빈 인수가 필요한 특수한 경우에는 ""처럼 적습니다.

10. 감도 설정

일반 설정 탭에서 다음 값을 바꿀 수 있습니다.

• 제스처 시작 거리 우클릭을 누른 시작점에서 이 거리 이상 움직이면 제스처로 보기 시작합니다. 너무 낮으면 일반 우클릭이 제스처로 오인될 수 있습니다.

• 방향 인식 거리 한 방향으로 이 거리 이상 움직였을 때 U, D, L, R 방향으로 인정합니다. 너무 낮으면 손떨림이 방향으로 잡힐 수 있습니다.

• 최소 제스처 거리 오른쪽 버튼을 뗄 때 전체 이동거리가 이 값보다 작으면 제스처를 무시합니다. 이 값은 제스처 시작 거리보다 작게 저장할 수 없습니다.

잘 모르겠으면 기본값을 유지하세요.

11. 제외 앱 설정

특정 프로그램에서는 제스처를 쓰지 않게 할 수 있습니다. 일반 설정 탭의 제외 앱 칸에 실행 파일 이름을 한 줄에 하나씩 적습니다.

예:

game.exe WindowsTerminal.exe

경로 전체를 쓰지 말고 exe 파일 이름만 적으세요. 와일드카드는 지원하지 않습니다. 제외 앱 안에서는 입력이 일반 우클릭처럼 전달됩니다.

12. 저장 오류와 외부 수정

설정 값이 잘못되면 저장하지 않고 기존 설정을 유지합니다. 예를 들어 제스처 시작 거리를 0으로 입력하면 오류가 납니다.

설정 창이 열린 상태에서 다른 프로그램이 config.json을 바꾸면 덮어쓰기를 거부할 수 있습니다. 편집 내용은 유지됩니다. 내보내기로 초안을 보관하고 최신 설정을 불러오거나, 내용을 확인하고 명시적으로 덮어쓰세요.

기존 config.json이 잘못된 JSON이면 복구 안내와 안전한 편집 초안이 표시됩니다. 가져오기나 정상 백업 복원으로 설정을 준비하거나 Open Config File에서 직접 고칠 수 있습니다. 설정을 정상화한 뒤 저장하고 Enable로 제스처를 다시 켜세요.

미저장 변경이 있는 상태에서 설정 창을 닫으면 버릴지 확인합니다.

13. 트레이 메뉴

Mouse Gesture 아이콘을 우클릭하면 메뉴가 열립니다.

• Enable 제스처 기능을 켭니다.

• Disable 제스처 기능을 끕니다. 이 상태에서는 우클릭이 일반 Windows 우클릭처럼 전달됩니다.

• Settings (설정)... 설정 창을 엽니다.

• Reload Config config.json을 다시 읽습니다. 설정 파일을 직접 수정한 뒤 프로그램을 재시작하지 않고 적용할 때 사용하는 고급 기능입니다.

• Open Config File 현재 사용 중인 config.json을 메모장으로 엽니다. JSON을 직접 고쳐야 할 때만 사용하세요.

• Exit 프로그램을 종료합니다.

14. 다른 제스처 프로그램과 같이 쓰지 않기

StrokesPlus, AutoHotkey, 다른 마우스 제스처 프로그램이 같은 오른쪽 버튼을 처리하면 입력이 충돌할 수 있습니다. Mouse Gesture를 테스트하거나 사용할 때는 그런 프로그램을 종료하는 것이 좋습니다.

15. 관리자 권한 앱과 우클릭 제한

이 프로그램을 일반 권한으로 실행하면 관리자 권한으로 실행 중인 앱 안에서는 제스처가 동작하지 않을 수 있습니다. 그 경우 입력은 원래 우클릭처럼 전달됩니다.

게임, 보안 프로그램, Raw Input을 쓰는 앱에서는 우클릭 동작이 앱마다 다를 수 있습니다. 문제가 있으면 해당 앱을 제외하거나 트레이 메뉴에서 Disable을 사용하세요.

일부 앱에서는 우클릭을 누르는 순간 자체 메뉴를 먼저 띄우기도 합니다. 이런 앱의 우클릭 동작은 완전히 똑같이 보존되지 않을 수 있습니다.

16. 오류 로그 위치

오류가 나면 다음 파일에 기록됩니다.

%LOCALAPPDATA%\MouseGesture\error.log

파일 탐색기의 주소창에 위 경로를 붙여 넣으면 됩니다. 오류가 없으면 파일이 없을 수 있습니다.

로그가 커지면 이전 로그는 다음 이름으로 보관됩니다.

%LOCALAPPDATA%\MouseGesture\error.previous.log

17. 업데이트할 때

1. 트레이 아이콘 우클릭
2. Exit 선택
3. 기존 config.json은 보존
4. 새 mouse-gesture.exe만 교체
5. 다시 mouse-gesture.exe 실행

config.json을 덮어쓰면 사용자가 바꾼 제스처 설정이 사라질 수 있습니다.

18. 자동 시작

설정 창의 '로그인할 때 시작'을 켜면 현재 사용자로 로그인할 때 실행합니다. 설치하거나 실행하는 것만으로 자동 등록되지는 않습니다. 같은 항목을 끄면 자동 시작을 해제합니다. 현재 실행 파일 위치를 등록하므로 폴더를 옮겼다면 새 위치에서 다시 켜세요. Ctrl+Alt+G 일시 정지 단축키는 설정에서 별도로 켜고 끌 수 있습니다.