RealMacro 사용설명서

주의사항!   RealAgent 가 실행되있어야 작동됩니다. 

RealAgent 실행하면 다운받아 보실수 있습니다. 

 

RealMacro는 키보드·마우스 동작을 “녹화하고, 편집하고, 재생”해 반복 작업을 깔끔하게 자동화해 드리는 윈도우용 매크로 도구입니다. 복잡한 설정 없이도 버튼 몇 번으로 업무 루틴, 테스트 절차, 단순 반복 클릭 등을 빠르게 처리할 수 있도록 설계했습니다.

다음과 같은 분들께 특히 유용합니다

• 같은 클릭/입력을 여러 번 반복하시는 분
• 테스트용 시나리오를 자주 재현해야 하는 분
• 정확한 좌표로 클릭·더블클릭·이동·휠 동작을 재생해야 하는 분

주요 특징

• 직관적인 타임라인: 한눈에 보이는 스텝 목록(유형, 키/버튼, 좌표, 지연)
• 원클릭 녹화: 실제 사용처럼 키보드/마우스를 녹화하여 그대로 재생
• 수동 추가(빠른 추가): 클릭·누름·뗌(▲/▼ 아이콘), 이동, 휠(Δ)·더블클릭 등을 좌표와 함께 즉시 삽입
• 좌표 찍기: “현재좌표” 버튼으로 커서 위치를 바로 반영(클립보드 복사 포함)
• 지연(Delay) 지원: 100ms, 1.5s, 01:20.250 등 다양한 표기
• 반복 옵션: 고정 횟수, 시간 동안, 키를 누르는 동안 등 재생 방식 선택
• 전역 단축키: 자주 쓰는 기능을 단축키로 등록해 언제든 호출
• 저장/불러오기: 만든 매크로를 파일로 보관하고 재사용

시작 방법 (아주 간단합니다)

1. 새 매크로를 만듭니다.
2. 녹화 버튼을 눌러 평소처럼 작업을 수행한 뒤 종료합니다.
3. 필요한 경우 타임라인에서 스텝을 선택해 좌표·지연 등을 손쉽게 수정하거나, “빠른 추가”로 클릭/더블클릭/휠/이동을 보탭니다.
4. 재생 버튼을 눌러 결과를 확인합니다.
5. 만족스러운 시나리오는 저장해 두었다가 언제든 불러와 재사용하세요

 

 

RealMacro 사용설명서

0) 한눈에 보기 (3분 퀵 스타트)

1. 프로그램 실행 → “새 매크로” 버튼을 눌러 빈 매크로를 하나 만듭니다.
2. 오른쪽 “빠른 추가(수작업) > 마우스” 영역에서
   • 동작을 클릭으로,
   • 버튼을 Left(왼쪽) 으로,
   • X,Y 좌표를 입력한 뒤 추가를 누르세요.
     (※ “추가”하면 해당 좌표로 먼저 이동 후 클릭이 자동으로 들어갑니다.)
3. 위쪽 툴바에서 ▶ 재생을 누르면, 마우스가 그 좌표로 이동해 클릭합니다.
4. 잘 되면 💾 저장으로 파일을 저장해 두세요. 닫았다 켜도 자동복구가 됩니다.

---

1) 화면 구성

• 위쪽 툴바: 새 매크로, 녹화 시작/일시정지/종료, 재생/정지, 저장/불러오기, 설정 등이 있습니다.
  상태줄 오른쪽에는 “Ctrl+Alt+Esc : 녹화 종료” 안내가 보입니다.
• 왼쪽 패널(매크로 목록): 매크로 이름/단축키 입력, 목록 선택/삭제.
• 가운데(타임라인): 현재 매크로의 스텝(step) 목록이 순서대로 보입니다.
  예) 1 Delay 50ms, 2 MouseMove 100,200, 3 MouseClick Left …
• 오른쪽(속성 & 빠른 추가)
  • 선택한 스텝 편집: 선택된 항목의 세부값(키, 좌표, 지연, 반복 등)을 수정.
  • 빠른 추가(수작업): 키보드/마우스/지연 스텝을 즉시 삽입합니다.
  • “현재좌표” 버튼을 누르면 마우스 현재 위치(띵- 소리)로 좌표를 받아오고, 좌표가 클립보드에도 복사됩니다.

---

2) 기본 개념

• 매크로(Macro): 여러 개의 스텝(step) 을 순서대로 실행하는 묶음입니다.
• 스텝 종류(예시)
  • Delay: 잠깐 쉬기(밀리초).
  • KeyPress/Down/Up: 키보드 입력.
  • MouseMove / MouseClick / MouseDown / MouseUp / MouseWheel
  • (수작업의 더블클릭은 내부적으로 “클릭 → 짧은 지연 → 클릭”으로 들어갑니다. 시스템의 더블클릭 속도에 맞춰 자동 조절됩니다.)
• 재생(Play): 타임라인의 1번부터 끝까지 실행합니다.

---

3) 매크로 만들기 – 두 가지 방법

A. 녹화해서 만들기

1. 위쪽 툴바에서 녹화 범위를 선택(키보드/마우스/둘 다).
2. ⏺ 녹화 → 실제로 키보드를 치거나 마우스를 클릭/이동하세요.
   (필요하면 중간에 ⏸ 일시정지 사용)
3. 끝났으면 ⏹ 종료. 타임라인에 자동으로 스텝이 쌓여 있습니다.
   • 참고: 녹화 중 누른 키/버튼이 풀리지 않고 끝나면, 종료 시 자동으로 보정(Up) 스텝을 넣어줍니다.

B. 수작업(빠른 추가)으로 만들기

오른쪽 “빠른 추가(수작업)” 영역을 사용합니다.

• 키보드
  1. 동작: Press/Down/Up 선택
  2. 입력 박스를 클릭 후 원하는 키를 눌러 등록(읽기 전용)
  3. 추가
• 마우스
  1. 동작 선택: 클릭 / 더블클릭 / 누름(Down) / 뗌(Up) / 이동 / 휠↑ / 휠↓
  2. 버튼(Left/Right/Middle 등)과 X,Y 좌표 입력
  3. 추가
  • 중요: “클릭/누름/뗌”을 넣으면 해당 좌표로 먼저 이동하는 스텝이 자동으로 같이 들어갑니다.
  • 더블클릭도 “이동 → 클릭 → 짧은 지연 → 클릭”으로 자동 구성됩니다.
  • 휠 Δ(델타): 기본값 0입니다. 휠 동작을 넣을 때만 숫자 입력이 의미가 있습니다.
    • 보통 한 칸(틱) = ±120 입니다. (위로 굴리면 +120, 아래로 굴리면 -120)
• 지연(Delay)
  • 예시: 100ms, 1.5s, 1m20s, 01:20.250 같은 형식 지원
  • “삽입”을 누르면 현재 선택 스텝 다음에 들어갑니다.

---

4) 타임라인 편집

• 선택 후 오른쪽에서 값을 바꾸면 즉시 반영됩니다.
• 아래 버튼으로 삭제/▲위로/▼아래로 정렬을 바꿀 수 있습니다.
• 현재좌표(선택/수작업) 버튼 → 좌표를 바로 가져와 편하게 맞출 수 있습니다.

---

5) 재생/정지

• 툴바의 ▶ 재생 버튼을 누르면 현재 선택된 매크로가 실행됩니다.
• ■ 정지로 중단할 수 있습니다.
• 재생 중 문제가 생겨 키가 계속 눌린 느낌이면 정지를 누르세요. 내부적으로 “모두 놓기” 처리를 합니다.

---

6) 저장/불러오기/자동복구

• 저장: 툴바의 💾 저장 버튼 → 파일 형식은 .rmacro / .json (사람이 읽을 수 있는 JSON)
• 불러오기: 📂 불러오기 → 현재 선택된 매크로를 새 내용으로 교체합니다.
• 자동저장/자동복구
  • 작업 내용은 자동으로 저장됩니다.
  • 위치: %AppData%\RealMacro\autosave.json
  • 프로그램을 다시 켜면 “이전 작업 자동 복구됨” 상태로 돌아옵니다.
  • 만약 자동복구 파일이 손상되어 이상하면, 프로그램을 종료한 상태에서 위 파일을 삭제한 뒤 다시 실행하세요.

---

7) 좌표/휠 값 이해하기

• 좌표(X,Y): 모니터 왼쪽 위가 (0,0)이고, 오른쪽/아래로 갈수록 숫자가 커집니다.
  “현재좌표” 버튼으로 실시간 커서 위치를 가져오면 편합니다.
• 휠 Δ(델타): “휠↑/휠↓” 동작에서만 용도 있음.
  • 0이면 체감 효과가 없습니다.
  • 일반적으로 한 칸 = ±120 (앱/드라이버마다 다를 수 있음).
  • 같은 동작을 여러 번 넣거나, 반복 옵션을 쓰면 연속 스크롤처럼 됩니다.

---

8) 반복(Repeat) 옵션

오른쪽 “선택한 스텝 편집”에서 스텝별로 Repeat(반복) 을 지정할 수 있습니다.

• Once(기본): 한 번만 실행
• WhileKeyHeld: 특정 키를 누르고 있는 동안 반복
  → 아래 “반복 키” 입력 박스에 키를 등록하세요.
• UntilKeyPressed: 특정 키를 한 번 누를 때까지 반복
• FixedCount: 횟수 지정(예: 10회)
• ForDuration: 시간 지정(예: 2000ms 동안)

반복 간격은 간격(ms) 에 입력합니다. (예: 100 → 0.1초마다)

---

9) 단축키(핫키) 설정

• 왼쪽 “매크로 목록”에서 특정 매크로에 단축키를 줄 수 있습니다.
  “단축키” 박스를 클릭하고 원하는 조합(Ctrl/Alt/Shift+키 등)을 누르면 됩니다.
• 툴바 전체 기능(녹화/재생/저장 등)의 단축키는 ⚙ 설정에서 지정합니다.
  지정 후에는 프로그램이 자동으로 재바인딩합니다.

---

10) 자주 묻는 질문(문제 해결)

Q. 재생을 눌렀는데 마우스가 그 위치로 안 가요.
A. 수작업으로 클릭/누름/뗌을 추가하면, 프로그램이 자동으로 이동(Move) 을 먼저 넣어줍니다.
타임라인에 MouseMove → MouseClick 순서가 있는지 확인해 주세요.
그래도 이상하면 좌표가 맞는지, 다중 모니터 환경인지 확인하시고 현재좌표 버튼으로 다시 찍어 보세요.

Q. 더블클릭이 한 번만 클릭된 것처럼 인식돼요.
A. 더블클릭은 시스템 더블클릭 시간을 기준으로 “클릭 → 지연 → 클릭”으로 들어갑니다.
대상 프로그램이 더 느리게 반응한다면, 타임라인에서 중간의 Delay(ms) 를 살짝 늘려 보세요. (예: 200→300)

Q. 휠 스텝을 넣었는데도 스크롤이 안 움직입니다.
A. 휠 Δ 기본값은 0이라 효과가 없습니다.
휠↑/휠↓에는 보통 120(또는 240 등)을 넣어 보세요. 반복 옵션과 함께 쓰면 연속 스크롤처럼 됩니다.

Q. 저장하고 다시 켰더니 아무 것도 없어요.
A. 우선 자동복구 파일(%AppData%\RealMacro\autosave.json)이 손상됐을 수 있습니다.
프로그램을 종료한 뒤 해당 파일을 삭제하고 다시 실행해 보세요.
그리고 수동 저장 시에는 읽기/쓰기 권한이 있는 위치에 저장했는지, 파일이 0KB는 아닌지 확인해 주세요.

Q. 녹화가 멈춘 것 같아요.
A. 상태줄에 보이는 Ctrl+Alt+Esc 조합으로 녹화 종료할 수 있습니다.

---

11) 실전 예제

예: 화면 (100, 200) 위치를 더블클릭한 뒤, 0.5초 쉬고, (300, 400)에서 왼쪽 클릭하기

1. “마우스” 동작을 더블클릭, 좌표를 100, 200 → 추가
   (자동으로 Move → Click → Delay(짧게) → Click)
2. “지연(Delay)”에 500ms → 삽입
3. “마우스” 동작을 클릭, 좌표를 300, 400 → 추가
4. ▶ 재생으로 테스트 → 💾 저장으로 보관