이 페이지는 편의를 위해 영어에서 번역되었습니다. 영어 원문이 가장 정확한 버전이며, 둘이 다를 경우 영어 원문이 우선합니다.

Myna Recorder 사용자 설명서

Recorder가 하는 모든 일. 모든 명령의 정확한 구문은 앱 안, 편집기 옆에 있습니다.

2026년 9월 15일 업데이트.

시작하기

Myna Recorder — 이 설명서에서는 “Recorder”, 디스크에서는 Recorder.exe — 는 Windows 10과 11(64비트)용 매크로 레코더입니다. 키보드와 마우스를 녹화하고, 그 결과를 읽을 수 있는 스크립트로 편집하게 해 주며, 어떤 애플리케이션에든 재생합니다. 여기서 다운로드하세요.

활성화

  1. 계정을 만들고 이메일을 인증하세요.
  2. Recorder에서 화면 오른쪽 위에서 이메일과 비밀번호로 로그인하세요. 그러면 상단 표시줄에 내 요금제와 AI 크레딧 잔액이 나타납니다.

Recorder는 로그인 상태를 유지하며 연결이 끊겨도 계속 작동합니다. 로그아웃하면 이 컴퓨터의 사용 권한을 다른 기기로 넘겨줍니다.

첫 매크로

녹화 시작(F2)을 누르고 작업을 직접 수행한 다음, 녹화 중지(F3)를 누르고, 재생 시작(F4)으로 재생하고, 실행을 일찍 끝내려면 재생 중지(F6)를 누르세요. 전체 단축키 표는 재생 항목에 있습니다.

이 설명서에서 어떤 키를 말할 때는 기본값을 뜻합니다. 키는 설정 → 단축키에서 바꿀 수 있습니다.

매크로는 그 순간 맨 앞에 있는 프로그램에 실제 입력을 보냅니다. 시작하기 전에 재생 중지 키를 알아 두세요. Recorder가 활성 창이 아니어도 이 키는 작동합니다.

창

여섯 개의 화면입니다. 네 개는 하나의 프로젝트를 편집하고, 에이전트는 대신 작업을 수행하며, 클리커는 대신 클릭합니다.

화면용도
Recorder단계 목록: 동작마다 한 행씩 표시되며, 레이블과 섹션, 묶인 마우스 이동 구간이 함께 나옵니다. 순서 바꾸기, 삭제, 타이밍 재조정에 가장 좋습니다.
스크립트같은 매크로를 텍스트로 보여 줍니다. 루프, 조건, 정밀한 편집에 가장 좋습니다. 명령을 더블클릭하면 설정 폼이 열립니다. 편집기 아래에서 설명은 코드 옆에 평범한 말로 풀어 쓴 열을 추가하고, 자동 완성은 입력하는 대로 이름을 제안하며, 구문 검사는 입력하는 대로 문제를 나열합니다.
클리커자동 클리커: 클릭 하나, 키 하나, 또는 지정한 속도로 지점 순서를 계속 반복합니다 — 자동 클리커를 참고하세요.
에이전트원하는 일을 말하면 AI가 실제 마우스와 키보드로 한 단계씩 수행합니다 — 에이전트를 참고하세요.
감시재생과 함께, 또는 혼자서도 실행되는 감시 행입니다 — 감시를 참고하세요.
이미지이 매크로가 쓰는, 이름 붙은 화면 크롭입니다. 여기서 캡처하고, 다시 캡처하고, 이름을 바꿀 수 있습니다. 크롭은 이 컴퓨터의 모든 매크로가 함께 씁니다.

나란히 보기는 단계 목록과 스크립트를 한 번에 보여 줍니다. 변수 버튼을 누르면 실행 중 모든 변수를 실시간으로 보여 주는 창이 열립니다.

파일

  • .recproj — 프로젝트입니다: 매크로와 크롭, 설정이 한 파일에 들어 있습니다. 보통 저장하는 파일입니다.
  • .recscript — 스크립트만 텍스트로 저장한 파일입니다.

작업 중인 매크로는 적용하지 않은 스크립트 탭 텍스트까지 포함해 자동 저장됩니다.

녹화

녹화 시작으로 시작하고 녹화 중지로 끝냅니다(기본값 F2와 F3). 녹화는 전역으로 동작하며, 어떤 애플리케이션에서 하는 일이든 원래 타이밍 그대로 캡처합니다.

설정 → 녹화에서 무엇을 녹화할지 정합니다: 키보드, 마우스 클릭, 마우스 이동, 마우스 휠. 마우스 이동을 빼면 매크로가 훨씬 짧아지고 각 대상을 바로 클릭합니다. 그리기나 호버가 필요할 때만 이동을 녹화하세요.

녹화된 좌표는 화면의 절대 픽셀 위치입니다. 창을 옮기거나, 해상도를 바꾸거나, 다른 컴퓨터에서 재생하면 녹화된 클릭이 엉뚱한 곳을 누릅니다. 해결책은 이미지 앵커입니다.

모든 모니터 사용은 캡처 범위를 모든 디스플레이로 넓힙니다. 화면이 하나뿐이면 꺼 두세요.

재생

동작기본 키
녹화를 시작하세요F2
녹화 중지F3
재생 시작F4
재생 일시 중지 / 재개F5
재생 중지F6
자동 클리커 시작F7
자동 클리커 중지F8

일곱 개 모두 전역 단축키이며, Recorder가 쥔 키는 소비됩니다: 다른 애플리케이션은 그 키를 전혀 보지 못합니다. 설정 → 단축키에서 바꾸거나 끌 수 있습니다.

재생 중지는 실행 중인 매크로를 멈출 수 있는 유일한 전역 방법입니다. 반드시 키를 지정해 두세요. 실행 중 숨기기와 에이전트는 이 키가 없으면 시작을 거부합니다.

속도와 반복

재생은 0.25배에서 10배 사이로 실행됩니다. 속도는 녹화된 대기 시간을 조정할 뿐, 직접 작성한 sleep() 호출은 조정하지 않으며, 애플리케이션이 더 빨리 응답하게 만들 수도 없습니다. 매크로가 4배에서는 실패하고 1배에서는 동작한다면, 그 타이밍을 wait_for()로 바꾸세요.

반복은 매크로를 정해진 횟수만큼 실행합니다. 0은 “중지할 때까지”를 뜻합니다. 한 번의 실행 안에서 반복하려면 루프 블록을 쓰세요.

테스트 실행

'레코더' 탭의 테스트는 선택한 행만 재생합니다. '스크립트' 탭의 선택 영역 테스트는 선택한 텍스트를 컴파일해 재생하며, 적용하지 않은 편집 내용도 포함됩니다. 매크로 자체는 절대 건드리지 않습니다.

  • 테스트는 반복과 속도 설정과 관계없이 한 번, 1배 속도로 실행됩니다.
  • 루프가 절반만 선택되면 블록 전체로 넓혀지며, 섹션 제목을 선택하면 그 안의 모든 내용을 선택한 것으로 취급됩니다.
  • 먼저 카운트다운이 실행됩니다(설정 → 녹화 → 테스트 시작 전 대기 시간, 0–30초, 기본값 3). 중지를 누르면 취소됩니다.

실행 중 숨기기

설정 → 창 → 녹화하거나 재생하는 동안 이 창 숨기기를 켜면 실행 중(테스트 포함) Recorder가 숨겨집니다. 재생 중지 단축키가 지정되어 있어야 합니다.

매크로 편집

섹션

섹션은 단계 목록의 장 제목과 같습니다. 작업의 실제 단계마다 하나씩 쓰세요.

with section("Log in"):
    click_crop("Username")
    type_text("user")

with section("Export"):
    click_crop("Export")

섹션은 절대 중첩되지 않으며 왼쪽 여백에서 시작합니다. 루프와 조건은 섹션 안에 들어갈 수 있으며, 단계마다 네 칸씩 들여씁니다.

레이블과 점프

어떤 명령에든 label="name"을 붙이면 점프 대상이 됩니다. 단독 행의 label("name")은 점프해 올 수 있는, 아무 동작도 하지 않는 단계입니다. goto("name")은 그곳으로 점프합니다.

with section("Retry"):
    click_crop("Refresh", label="again")
    wait_for("Done", timeout_ms=20000, on_fail="again")
    label("done")

모든 goto("x"), on_no="x", on_fail="x", wait_any의 화살표 -> "x"는 label="x"를 가진 단계가 있어야 합니다. 없으면 재생이 오류로 멈춥니다. 레이블은 고유해야 합니다.

함수: 스크립트 참조를 확인하세요.

이미지와 크롭

크롭은 화면의 무언가를 찍은, 이름이 붙은 그림입니다: 버튼, 아이콘, 제목 같은 것입니다. Recorder는 재생 시점에 그것을 찾아 지금 있는 위치에서 동작하므로, 창이 옮겨지거나 해상도가 바뀌거나 다른 컴퓨터에서 실행해도 매크로가 계속 작동합니다.

이미지 화면에서 하나를 캡처하고 이름을 붙인 다음, 그 이름을 쓰세요:

wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")
인수하는 일
"crop"따옴표로 감싼 이름, 또는 이름들의 조건입니다: "A" or "B", "A" and "B", 묶으려면 괄호를 씁니다. wait_for, click_crop, 그리고 네 가지 if_image/while_image 블록에서 쓸 수 있습니다. click_crop은 맨 먼저 적힌 이름을 클릭합니다. 조건을 참고하세요.
confidence일치 정도가 얼마나 가까워야 하는지, 0–1 범위입니다. 기본값은 0.8입니다. 마우스를 올리면 색이 바뀌는 버튼은 값을 낮추고, 엉뚱한 것이 일치하면 값을 높이세요.
timeout_ms얼마나 오래 찾을지입니다. 기본값은 5000입니다.
abort기본값은 False입니다: 그림을 찾지 못한 것은 실패가 아니라 놓친 것이며, 실행은 계속됩니다. abort=True를 쓰면 대신 멈춥니다.
on_fail그림이 끝내 나타나지 않을 때 점프할 레이블입니다.
region(x, y, w, h): 오직 이 사각형 안에서만 찾습니다. 같은 컨트롤이 두 번 나타날 때 쓰세요. 각 숫자는 변수나 합산식일 수 있습니다.
match"color"(기본값, 더 엄격함) 또는 "shape"(윤곽선만 비교하며 테마가 바뀌어도 유지됨) 중 하나입니다. 예전 표기 grayscale=True도 여전히 match="shape"와 같은 뜻입니다.
x_offset / y_offsetclick_crop에서: 클릭 위치를 일치한 지점의 중심에서 옮깁니다.
pre_click_msclick_crop에서: 누르기 전에 커서가 일치한 지점에 머무는 시간입니다. 기본값은 200입니다. 마우스를 참고하세요.
into일치 결과를 변수에 저장하거나, r = wait_for("crop")처럼 쓰세요. 일치 결과를 참고하세요.

딱 맞게 캡처하세요. 크롭에는 눈에 띄는 부분만 담아야 합니다. 배경까지 담기면 배경이 바뀔 때 일치에 실패합니다.

화면에서 텍스트 읽기

read_text는 화면의 한 영역을 읽어 변수에 담습니다. 결과는 메서드로 정리한 다음 조건, 산술식에 쓰거나, 텍스트 인수 안에서 ${name}처럼 쓸 수 있습니다.

total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")

항상 region을 지정하세요. 데스크톱 전체를 읽으면 그림이 축소되어 일반적인 인터페이스 텍스트를 읽을 수 없게 됩니다.

세 가지 판독기

engine=설명
"builtin"기본값입니다. 내 컴퓨터에서 무료로 실행되며, 내보낸 프로그램 안에도 함께 들어갑니다.
"tesseract"역시 로컬에서 무료로 실행됩니다. 기본 제공 엔진보다 더 잘 읽는 화면도, 더 못 읽는 화면도 있습니다. 이 엔진만 page_mode=를 받는데, 그림을 어떻게 줄 단위로 나눌지 정합니다. 읽은 결과가 비슷한데 틀렸을 때 시도해 보세요.
"ai"서버에 있는 텍스트 판독 모델입니다. 크레딧이 들고 내보내기를 막습니다; 크레딧을 참고하세요. 두 로컬 엔진이 모두 중요한 내용을 잘못 읽을 때 쓰세요.

엔진은 단계마다 고릅니다. engine="ai"는 그대로 옮겨 적고, 화면을 두고 판단하려면 ask_ai를 쓰세요.

돌아온 값 정리하기

total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
    notify("Total looks low: ${total}")

메서드 목록은 읽은 내용 정리하기에 있습니다. 빈 영역은 ""를 저장하고 실행은 계속됩니다. single_line=True는 결과를 한 줄로 합칩니다.

AI에게 묻기

ask_ai는 화면 일부에 대한 질문을 비전 모델에 보내고 답을 저장합니다. “빨간 행이 몇 개인가요?”, “오류 대화 상자가 있나요?”.

n = ask_ai("how many error icons are visible", role="count", region=(0, 0, 800, 600))
if n:
    click(n.1.x, n.1.y)

호출마다 크레딧이 들고 내보내기를 막습니다. 크레딧을 참고하세요. 한 번의 실행에서 AI 호출은 60회로 제한됩니다.

세 가지 역할

role=답변
"count"기본값입니다. 숫자와, 각 대상의 위치를 함께 돌려줍니다. n은 개수이고, n.1.x / n.1.y는 첫 번째 위치, n.2.x는 두 번째 위치입니다. 인덱스는 변수로 쓸 수 있습니다: click(n.${i}.x, n.${i}.y). 예/아니오 역할은 따로 없습니다. if n:은 “있는가”를, if not n:은 “없는가”를 뜻합니다.
"explain"log()나 notify()에 쓸 문장입니다.
"read"고른 모델로 전사합니다 — 고정된 전사 모델을 쓰는 read_text(engine="ai")와는 다릅니다.

모델 선택

model=에는 짧은 이름을 씁니다. 단계가 읽는 영역에 맞춰 가격이 매겨진 실시간 목록은 설정 양식에 있습니다('스크립트' 탭에서 ask_ai 호출을 두 번 클릭하세요). 권장 설정은 기본 모델을 기본 추론 단계로 쓰는 것입니다. 호출에서 model=과 reasoning=을 빼면 서버가 알아서 고르며, 현재는 glm입니다. 표는 다르게 골라야 할 이유가 있을 때를 위한 것입니다. 가장 비싼 모델이 모든 질문에서 가장 정확한 것은 아니며, 가장 저렴한 gemma가 작은 크롭에서 가장 정확하다고 측정되었습니다.

이름모델reasoning= 단계temperature=
gemmaGoogle Gemma 3 12B—0–2
glmGLM 5.3 Flash (기본값)—0–2
qwen-vlQwen3-VL 30B—0–2
gemini-liteGemini 3.1 Flash Lite—0–2
geminiGemini 3.7 Flash낮음, 보통, 높음—
haikuClaude Haiku 4.5—0–1
sonnetClaude Sonnet 5낮음, 보통, 높음, 매우 높음, 최대(기본값 높음)—
gemini-proGemini 3.1 Pro낮음, 보통, 높음0–2
kimiKimi K3낮음, 높음, 최대(항상 추론함; 기본값 최대)—
opusClaude Opus 5낮음, 보통, 높음, 매우 높음, 최대(기본값 높음)—

항상 region=을 지정하세요. 모델은 데스크톱 전체에서 대상을 셀 수는 있어도 그 위치까지 찾아내지는 못할 수 있습니다. 클릭하려는 매크로에는 작은 그림이 필요합니다. read_text와 AI 감시 행도 마찬가지입니다.

스크립트 참조

스크립트는 파이썬과 비슷하며 그중 작은 일부만 씁니다. 변수, 산술 연산, if/else, while과 repeat 루프, 명령 호출과 def 함수, 4칸 들여쓰기, # 주석입니다. 블록은 중첩되며, 섹션만은 왼쪽 여백에 있어야 합니다. 목록도, +로 문자열을 이어 붙이는 것도, import도 없습니다.

완전한 참조 문서 — 모든 명령, 그 명령이 받는 모든 인자, 키 이름, 각각의 예제 — 는 스크립트를 작성하는 편집기 옆, 앱 안에 있습니다. '스크립트' 탭에서 명령 목록을 열고 아무 명령이나 오른쪽 클릭하면 그 설명서 페이지가 나옵니다. 명령을 고르고 삽입을 누르면 커서 위치에 올바른 호출이 놓입니다. 호출을 두 번 클릭하면 그 명령이 받는 모든 옵션이 나열된 설정 양식이 열립니다.

이름 붙은 인자는 이름 없이 순서대로 줄 수도 있습니다. press("a", 0.5)는 press("a", hold=0.5)와 같습니다. 모든 명령은 label="name"도 받습니다.

감시

감시 행은 화면을 지켜보는 장치입니다. 매크로가 실행되는 동안에도, 감시 시작을 누른 뒤 혼자서도, 일어날 수 있는 일을 지켜봅니다. 충돌 대화 상자, 세션 만료 배너, 품절 경고 같은 것입니다. wait_for는 놓인 자리에서만 지켜보지만, 감시 행은 내내 지켜봅니다.

행이 지켜보는 것

감시 방법 칩에서 하나를 고릅니다. 찾을 그림이거나, 물어볼 질문입니다.

종류하는 일
이미지이름 붙인 크롭이며, wait_for와 같은 방식으로 찾습니다. 무료이며, 원하는 만큼 자주 확인할 수 있습니다.
AI에게 묻기비전 모델에 묻는 질문입니다. “오류 대화 상자가 있나요?” 답은 개수이며, 0은 찾지 못했다는 뜻입니다. 크레딧이 들며, 크레딧 항목을 참고하세요.

언제 발동하는지

설정의미
나타남그림이 나타나거나, 개수가 0에서 어떤 수로든 바뀔 때입니다.
사라짐있던 것이 사라진 경우입니다. 행이 먼저 본 적이 있어야 하므로, 아직 열어 보지 않은 것에는 절대 발동하지 않습니다.
분석AI 행에서만 씁니다. 발동 조건이 따로 없습니다 — 모델이 보이는 것을 설명하고, 행은 확인할 때마다 그 문장을 보냅니다.

행의 나머지 항목

열하는 일
찾을 영역화면의 어느 부분을 검색하거나 물어볼지 정합니다. 비워 두면 화면 전체입니다. AI 행에는 작은 영역을 지정하세요. AI에게 묻기 항목을 참고하세요.
일치 기준이미지 행: 색상은 더 엄격하고, 모양은 윤곽만으로 맞춰 보므로 테마가 바뀌어도 유지됩니다. 옆의 톱니바퀴 아이콘에 알림 간격이 있습니다. AI 행은 이 칸에서 모델, 추론, 온도, 영역, 알림 간격을 설정합니다.
확인 간격이 행이 얼마나 자주 확인하는지를 초 단위로 나타냅니다. AI 행은 1초 미만으로 설정할 수 없으며, 기본값은 60초입니다.
시작 지연감시 시작 이후 이 행이 시작되기까지의 지연 시간입니다. 애플리케이션이 다 불러와질 시간을 줍니다. 감시를 시작할 때마다 다시 설정됩니다.
메시지알림에 표시될 내용입니다. ${name}은 실제 값으로 바뀝니다. 비워 두면, 분석 행은 모델이 낸 문장을 그대로 보냅니다.

발동했을 때 하는 일

팝업, Telegram, Discord, 그리고 스크린샷 첨부입니다. 행에 있는 버튼으로 전송 방식을 고르고, 자격 증명은 설정에서 제공합니다. 매크로 중지는 매크로를 멈추는 동시에 감시도 멈춥니다. 분석 행은 확인할 때마다 발동하므로 매크로를 멈출 수 없습니다.

행의 설정에는 확인 간격과는 별도로, 메시지 사이의 알림 간격도 있습니다. 설정 → 알림에서는 감시하는 동안 타이머로 화면 스크린샷을 보낼 수도 있습니다.

내보내기

내보내기 버튼은 켜져 있고 그림이 지정된 모든 감시 행을, 그 크롭과 설정까지 함께 가져갑니다. 내보낸 프로그램은 실행할 때마다 이들을 시작하고 실행이 끝나면 멈춥니다. 여기서 실행이 하는 것과 똑같습니다. AI에게 묻는 행은 내보낼 때 이름이 표시되며 거부됩니다. 먼저 꺼 두세요. Telegram이나 Discord 알림이 도착하는지는 내보낼 때 나오는 자격 증명 질문에 달려 있습니다.

자동 클리커

클리커 탭은 멈출 때까지 클릭하거나 키를 계속 누릅니다. 커서 위치에서, 고정된 한 점에서, 또는 직접 클릭해 기록한 지점 순서를 따라갑니다. 매크로는 아니므로 — 프로젝트에는 아무것도 들어가지 않습니다 — 다만 탭의 모든 설정은 다음에도 기억됩니다.

세 가지 모드

모드하는 일
클릭클릭 하나를 반복합니다. 왼쪽, 오른쪽, 가운데 버튼 중 하나이며 한 번, 두 번, 세 번 클릭 중 하나입니다. 커서 위치(마우스를 따라감), 정지 화면에서 고른 고정된 점, 또는 상자 안을 돌아다니는 위치 중 하나입니다.
키 누르기키 하나를 계속 누릅니다.
지점 순서여러 위치를 순서대로 클릭하며, 각 지점마다 대기 시간, 버튼, 클릭 종류가 따로 있고, 이 과정을 계속 반복합니다.

설정

설정의미
대기 시간클릭과 클릭 사이의 시간을 밀리초 단위로 정하고, 선택적으로 지터를 더할 수 있습니다. 클릭마다 그만큼 이하의 시간이 무작위로 더해지므로 리듬이 정확히 일정하지 않습니다. 옆의 초록색 표시는 누름 시간과 지터까지 포함해 이 설정이 초당 몇 번의 클릭이 되는지 보여 줍니다.
누름 시간클릭마다 버튼이나 키가 눌려 있는 시간이며, 이 값에도 자체적인 지터가 있습니다.
중지 조건중지할 때까지 계속하거나, 클릭 횟수(시퀀스라면 회차 수), 또는 시간으로 정할 수 있습니다.
흩어짐각 클릭이 정해진 지점에서 어느 방향으로든 얼마나 벗어날 수 있는지를 정합니다. 오래 돌려도 매번 같은 픽셀만 누르지 않게 해 줍니다. 0이면 정확히 그 지점입니다. 목표물보다 작게 설정하세요.
상자 안에서 이동상자를 지정하고, 그 안에서 시작할 위치를 고르세요. 각 클릭은 이전 클릭에서 정해진 거리 이내로만 움직이며, 상자를 벗어나지 않습니다.
단축키F7로 시작하고 F8로 멈추며, 어떤 프로그램에서도 작동합니다. 설정 → 단축키에서 바꿀 수 있습니다.

지점 순서 녹화하기

지점 순서 모드에서 점 녹화를 누르고, 프로그램 안에서 각 위치를 차례로 왼쪽 클릭하세요. 클릭할 때마다 보는 앞에서 행이 하나씩 늘어납니다. 중지를 누르는 클릭 — 그리고 Recorder 창에서 하는 다른 모든 클릭 — 은 기록되지 않습니다. 이렇게 만들어진 각 행에는 저마다 대기 시간, 버튼, 클릭 종류가 있고, 선택으로 정지 화면에서 한 지점을 옮길 수 있습니다.

멈추는 방법

  • 중지 버튼, 클리커 중지 키, 재생 중지 키, 또는 Recorder가 앞에 있을 때 Esc입니다.
  • 누르고 있기 모드: 시작 키를 누르고 있는 동안에만 클릭하며, 그 키는 여전히 포인터 아래의 프로그램에도 전달됩니다.
  • 커서가 화면 위쪽 끝에 닿으면 중지: 마우스를 화면 위쪽 끝으로 밀면 어떤 모드에서든 멈춥니다 — 키보드가 필요 없는 탈출 방법입니다.
  • 마우스를 손으로 움직이면 중지: 포인터가 클리커가 두지 않은 곳에 있게 되는 순간입니다.

시작 버튼은 마우스가 창을 벗어날 수 있도록 잠시 기다린 뒤 시작하지만, 단축키는 곧바로 시작합니다.

요금제별 포함 내용

클리커 자체는 모든 요금제에서 쓸 수 있습니다. 커서 위치나 고정된 한 점에서, 정확한 속도로 클릭이나 키 하나를 반복하며, 횟수 제한과 시간 제한, 멈추는 모든 방법을 포함합니다. Basic과 Pro에서는 사람처럼 클릭하기(커서가 매 클릭마다 이동하고 누름 시간이 달라짐), 두 가지 지터, 흩어짐, 지점 순서, 이동 상자가 추가됩니다. Free에서는 이 항목들이 자물쇠 아이콘과 함께 회색으로 비활성화되며, 요금제로 설정해 둔 값은 다시 해당 요금제가 되었을 때를 위해 그대로 남아 있습니다.

사람처럼 움직이는 기능은 일반적인 애플리케이션에서 손으로 마우스를 움직이는 것처럼 동작을 재현하기 위한 것입니다. Recorder는 어떤 프로그램으로부터도 자신을 숨기려 하지 않습니다.

프로그램으로 내보내기

파일 → 프로그램으로 내보내기…는 매크로와 크롭, 그리고 매크로를 조정할 때 사용한 텍스트 판독기를 담은 .exe 파일 하나를 만듭니다. 설치 프로그램도, 런타임도, Recorder 사본도 필요하지 않습니다.

  • 내보내기 대화상자에는 제어 창 옵션이 있습니다. 실행, 일시 중지, 중지와 각각의 단축키, 반복과 속도, 그리고 상태 줄이 나타납니다. 이 옵션이 꺼져 있으면 프로그램은 열리는 즉시 실행되고, 아무것도 보여 주지 않으며, 매크로가 끝나면 닫힙니다 — 스케줄러가 시작하는 프로그램에는 맞지만, 처음 시도해 볼 때는 맞지 않습니다. 직접 실행할 것이라면 제어 창을 켜 두세요. 그러면 문제가 생겼을 때 조용히 지나가지 않고 메시지로 표시됩니다.
  • 실행, 일시 중지, 중지 단축키는 내보내는 시점에 '설정 → 단축키'에 지정된 대로 함께 옮겨지며, 켜져 있는 감시 행과 키보드 반복 설정도 마찬가지입니다.
  • AI를 사용하는 매크로(ask_ai, 또는 read_text에 engine="ai"를 지정한 경우)는 내보내기가 거부되며, 해당 단계를 알려 줍니다. 로컬 판독기 두 가지는 파일 안에 함께 들어갑니다.
  • 매크로나 감시 행이 Telegram이나 Discord로 메시지를 보내도록 설정되어 있으면, Recorder는 그 자격 증명을 포함할지 묻습니다. 파일을 가진 사람은 누구나 자격 증명을 읽을 수 있습니다. 포함하지 않으면 알림 단계와 경고는 아무것도 보내지 않습니다. Telegram과 Discord는 Basic이나 Pro가 필요합니다. Free에서는 이 질문이 나오지 않으며 정보도 함께 옮겨지지 않습니다.

내보낸 프로그램 중지하기

내보낼 당시 지정되어 있던 재생 중지 단축키가 그대로 쓰입니다. 바꾸지 않았다면 F6입니다. 중지 단축키를 꺼 두었다면 F6으로 대신합니다. 중지할 수 없는 매크로는 실행되지 않기 때문입니다.

다른 프로그램이 그 키를 이미 쓰고 있다면, 프로그램은 Ctrl+Shift를, 그다음 Ctrl+Alt를 시도하고, 첫 단계가 시작되기 전에 어느 쪽인지 알려 줍니다. 어느 것도 등록할 수 없으면 매크로는 아예 실행되지 않으며 이유를 알려 줍니다.

내보낸 프로그램에는 입력했던 텍스트를 포함해 매크로의 모든 내용이 들어 있습니다. 다른 사람에게 보내기 전에 비밀번호나 토큰이 들어 있지 않은지 확인하세요. 파일에는 코드 서명이 되어 있지 않으므로, 처음 실행할 때 SmartScreen이 경고할 수 있습니다.

AI 어시스턴트

원하는 매크로를 설명하면 어시스턴트가 스크립트를 작성합니다. 승인하기 전에는 에디터에 아무것도 반영되지 않습니다. 답변을 읽고 '사용' 또는 '바꾸기'를 누르세요. 모든 답변은 컴파일러가 검사하며, 컴파일되지 않으면 어시스턴트가 한 번 자동으로 고쳐 보고, 이때 크레딧이 쓰입니다.

모드는 두 가지입니다. 작성은 매크로를 씁니다. 계획은 작업에 대해 묻기만 하고 매크로 작성을 누르기 전까지는 아무것도 쓰지 않습니다. 몇 단계를 넘어서는 작업이라면 여기서 시작하세요. Ctrl+Enter로 보내고, 새로 시작은 새 대화를 시작하며 저장된 대화 기록을 지웁니다.

모델과 추론: 둘 다 기본으로 두세요. 중간과 최고는 서로 다른 모델일 뿐, 더 나은 모델이 아닙니다. 그리고 추론을 늘리면 한 번의 대화마다 비용이 더 들고 스크립트는 좀처럼 달라지지 않습니다. 복구 사용은 클릭을 놓쳤을 때 매크로가 멈추지 않고 스스로 제 경로를 찾아 돌아오게 합니다. 클릭 후 짧은 sleep 추가는 클릭할 때마다 잠깐 멈춰, 다음 단계가 화면보다 앞서 실행되지 않게 합니다. 둘 다 보통은 켜 둡니다.

좋은 답을 얻으려면

  • 크롭을 먼저 캡처하세요. 어시스턴트는 어떤 크롭 이름이 있는지 전달받습니다. 하나도 없으면 좌표만 쓸 수 있습니다.
  • 목표만이 아니라 화면이 어떻게 보이는지도 말해 주세요. "전체 새로고침을 클릭하고, 상태 표시줄에 완료라고 뜰 때까지 기다려"가 "스프레드시트 새로고침해"보다 낫습니다.
  • 대화하면서 다듬으세요. "그냥 기다리는 대신 저장 대화상자가 뜰 때까지 기다려"는 흔한 후속 요청입니다.

크레딧

크레딧은 서버까지 닿는 모든 것에 쓰입니다. 어시스턴트 대화 한 번(자동 수정 시도 포함), ask_ai 단계, AI 감시 행, read_text에 engine="ai"를 지정한 경우, 그리고 에이전트 실행의 모든 단계입니다. 녹화, 재생, 이미지 앵커, 로컬 판독기 두 가지, 내보내기에는 크레딧이 전혀 들지 않습니다. 잔액은 로그인 상태 옆, 어시스턴트 패널, 계정 페이지에 표시됩니다. AI 단계마다 실행 로그에 사용된 크레딧이 기록됩니다. 요금제와 크레딧 팩은 요금제 페이지에 있습니다.

매크로 안의 AI 단계(ask_ai, read_text의 engine="ai", AI 감시 행)는 모두 크레딧이 들고, 로그인한 계정이 필요하며, 내보내기를 막습니다. 내보낸 프로그램에는 요금을 청구할 계정이 없기 때문입니다.

에이전트

에이전트 탭은 세 번째 화면입니다. 목표를 입력하면 AI가 내 데스크톱에서 한 단계씩 직접 수행하며, 단계마다 화면을 확인합니다. 실제 마우스와 키보드로, 내 데스크톱에서 이루어지는 computer use입니다. 한 화면 안에서 눈으로 볼 수 있는 짧은 작업에 가장 잘 맞습니다 — 페이지 열기, 양식 채우기, 화면 몇 개 클릭해 넘어가기 같은 일입니다. 길거나 특이한 작업은 매크로로 녹화하는 편이 낫습니다. 처음 몇 번은 지켜보세요.

단계마다 AI 호출이 한 번씩 일어나며, ask_ai와 같은 크레딧으로 청구됩니다 — 목표에 이르지 못한 실행의 단계도 마찬가지입니다. 에이전트는 화면만 보며, 그 화면에 있는 텍스트가 에이전트에게 지시로 작용하는 일은 없습니다.

어시스턴트와는 다릅니다. 어시스턴트는 내가 보관하고 다시 재생할 매크로를 쓰고, 에이전트는 지금 당장 그 일을 해내고는 아무것도 남기지 않습니다.

작업 실행하기

  1. 목표를 입력하세요. 예: 다운로드 폴더를 열고 날짜순으로 정렬해. 저장을 누르면 저장됨 목록에 남고, 삭제로 하나씩 지울 수 있습니다.
  2. 시작을 누르거나 Ctrl+Enter를 입력하세요. Recorder는 실행마다 한 번, 에이전트에게 맡길까요?라고 물으며 목표와 사용할 수 있는 권한을 다시 보여 줍니다. 재생 중지 단축키가 없으면 시작하지 않습니다. 재생하기를 참고하세요.
  3. 타임라인을 지켜보세요. 각 단계는 에이전트가 본 것, 이전 단계에 대한 판정(예, 아니오, 불확실), 지금 하고 있는 일, 그리고 든 비용을 보여 줍니다. 하단에는 실행 누적 비용과 남은 크레딧이 표시됩니다.
  4. 언제든 중지를 누르거나 중지 단축키를 쓰세요.

실행은 완료, 막힘, 중지됨 가운데 하나로 끝나며, 든 크레딧과 단계 수, 이유가 함께 표시됩니다. 세 번 연속 실패한 단계, 40단계가 지나도록 끝나지 않음, 크레딧 상한, 또는 중지 단축키입니다.

작업이 질문(이 계정이 어느 요금제인지 알려 줘)이라면, 답은 보고서 형태로 돌아옵니다. 메시지 창, 또는 데스크톱·Telegram·Discord 가운데 설정 → 알림에서 켜 둔 방식으로 옵니다.

옵션

모델기본, 중간 또는 최고. 최고가 권장 설정이며, 새 프로필은 이 설정으로 시작합니다.
크레딧 최적화단계마다 더 작은 스크린샷을 보냅니다. 실행당 비용이 5분의 1가량 줄어듭니다. 에이전트가 작은 글자를 놓치면 꺼 두세요.
매크로로 배우기이 빌드에서는 사용할 수 없어 확인란이 회색으로 표시됩니다. 에이전트는 매크로를 남기지 않습니다.

허용된 작업

확인란 아래 줄에는 에이전트가 사용할 수 있는 권한이 나옵니다. 기본값은 마우스, 키보드, 타이밍, 실행, 메시지입니다. 권한을 누르면 설정 → 에이전트가 열리며, 여기서 각 권한이 허용 아래 확인란으로 나타납니다.

권한기본값
마우스 움직이고 클릭하기켜짐
키보드로 입력하기켜짐
대기켜짐
파일, 폴더, 웹 페이지 열기켜짐
찾은 내용 보고하기켜짐
명령 실행하기꺼짐 — 꺼 둔 채로 두세요. 아직 충분히 검증되지 않았습니다.
컴퓨터 재시작 또는 종료하기꺼짐

마지막 두 항목은 꺼 둔 채로 두세요. 내 권한으로 실행되는 명령줄은 내가 할 수 있는 모든 일을 할 수 있고, 에이전트는 안전한 명령과 파괴적인 명령을 구별하지 못합니다.

다음일 때 중지에서는 한도를 정합니다. 실행당 단계 수, 한 단계의 실패 횟수, 실행당 크레딧(0이면 무제한)입니다. 속도에서는 에이전트가 화면이 안정될 때까지 기다리는 시간, 단계 사이의 간격, 한 단계 안에서 동작들 사이의 간격을 정합니다. 클릭한 뒤 입력을 따라가지 못하는 프로그램이라면 마지막 값을 늘리세요.

설정

메뉴 줄에서 설정을 클릭하세요. 탭은 일곱 개입니다. 단축키, 녹화, 키보드, 창, 알림, 로그, 에이전트입니다. 확인을 누르면 적용되고, 취소를 누르면 버려지며, 기본값으로 복원은 Telegram과 Discord 자격 증명을 뺀 나머지를 모두 초기화합니다.

단축키

전역 단축키 일곱 개는 기본값일 뿐 고정된 것이 아닙니다. 여기서 각각 다시 지정하거나 끌 수 있으며, 현재 설정을 보여 주는 곳은 이 탭뿐입니다. 필드를 클릭하고 조합키를 누르세요. Esc로 지웁니다. 두 동작이 같은 키를 쓸 수는 없으며, 다른 프로그램이 이미 그 키를 쓰고 있으면 Recorder가 알려 줍니다. 기본값은 재생하기에 있습니다.

녹화와 키보드

녹화에는 캡처 켜고 끄기와 테스트 카운트다운이 있습니다. 키보드에서는 키를 누르고 있을 때 실제 키보드처럼 반복 입력될지를 정합니다. 기본값은 꺼짐이며, 지연 시간, 속도, 선택적인 흔들림, 그리고 Windows 설정을 그대로 가져오는 이 PC와 맞추기가 있습니다. 이 설정은 내보낸 프로그램에도 함께 옮겨집니다.

창

실행 중 숨기기, 모든 모니터 사용, 어두운 테마, 85%에서 140%까지의 글자 크기가 있습니다. 마지막 두 가지는 바로 적용됩니다.

알림

기본값은 꺼짐입니다. 켜면 Recorder가 녹화가 끝났을 때, 재생이 끝났을 때, 재생이 중단되었을 때를 데스크톱 알림, Discord, Telegram, 또는 이들의 조합으로 알려 줍니다. 데스크톱 알림은 모든 요금제에서 되고, Telegram과 Discord는 Basic이나 Pro가 필요합니다. Free에서는 두 확인란이 이유와 함께 회색으로 표시되며, 입력해 둔 토큰이나 웹훅은 요금제가 바뀌면 그대로 쓰입니다. 감시도 같은 채널을 쓰며, 행마다 따로 켜고 끌 수 있습니다. 이미지 품질은 첨부되는 스크린샷의 크기를 매우 낮음부터 무손실까지 정합니다.

Discord

필드 하나, 웹훅 URL입니다.

  1. Discord에서 웹훅을 만드세요. 서버 설정 → 연동 → 웹훅을 열고, 새 웹훅을 선택하고, 채널을 고르고, 이름을 붙인 다음 웹훅 URL 복사를 누르세요. 웹훅 관리 권한이 필요합니다.
  2. Recorder에 붙여넣으세요. 설정 → 알림에서 Discord를 켜고 URL을 붙여넣으세요.
  3. 테스트를 보내세요. 몇 초 안에 채널에 메시지가 나타나야 합니다.

웹훅 URL은 비밀번호나 다름없습니다. 가지고 있는 사람은 누구나 그 채널에 메시지를 올릴 수 있습니다. 유출되었다면 Discord에서 그 웹훅을 지우고 새로 만드세요. 이 웹훅을 쓰는 프로그램을 내보낼 때는 먼저 물어봅니다.

Telegram

BotFather에서 받은 봇 토큰과 대화의 숫자 채팅 ID가 필요합니다. 둘 다 설정 → 알림에 입력합니다.

타이머 스크린샷

감시 중 화면 사진 보내기는 고른 영역 또는 전체 화면의 스크린샷을 N초마다 Telegram과 Discord로 보냅니다. 감시 시작이 켜져 있는 동안에만 실행되며, 데스크톱 풍선 알림은 쓰지 않습니다.

무엇이 전송되는가

항상무엇이 끝났는지 알리는 한 줄짜리 텍스트, 또는 감시 행에 직접 정해 둔 메시지입니다.
선택적으로감시 행에서 켜 두었거나 타이머 스크린샷을 켰다면 스크린샷도 함께 갑니다. 그 순간 고른 영역에 무엇이 있었든 그대로 보여 줍니다.
절대 보내지 않는 것내 매크로, 내 스크립트, 내 크롭, 내 계정에 관한 어떤 정보도 보내지 않습니다.

메시지는 저희 서버를 거치지 않고 내 컴퓨터에서 곧바로 Discord나 Telegram으로 갑니다.

진단 로그

보기 → 로그는 실행이 지금 무엇을 하고 있는지 보여 주고, 설정 → 로그는 무엇을 기록할지 정합니다. 매크로가 이상하게 동작하면 먼저 모든 단계를 켜세요. 텍스트 내용은 화면에서 읽어 낸 글자를 그대로 기록하므로, 문제를 찾은 뒤에는 다시 꺼 두세요.

내 라이선스

한 번에 한 대의 컴퓨터

다른 컴퓨터로 옮기려면 기존 컴퓨터에서 로그아웃하고 새 컴퓨터에서 로그인하세요. 기존 컴퓨터를 더 쓸 수 없다면 그냥 새 컴퓨터에서 로그인하세요. 기존 컴퓨터에서 30일 동안 연결이 없으면 새 컴퓨터가 그 자리를 넘겨받습니다.

오프라인에서 작업하기

연결이 끊겨도 실행 중인 작업은 멈추지 않습니다. 상단 줄에 “로그인됨 (오프라인 작업 중)”이 표시되며 Recorder는 계속 동작합니다. 오랫동안 오프라인 상태가 이어질 때만 멈춥니다.

내 요금제에 포함되지 않은 기능

요금제로 나뉘는 기능은 여섯 가지입니다. AI 기능, 화면 텍스트 읽기, 화면 감시, 프로그램으로 내보내기, Telegram과 Discord 알림, 그리고 자동 클리커의 추가 기능(사람처럼 클릭하기, 지터, 흩어짐, 점 시퀀스, 상자 안에서 이동)입니다. 내 요금제에 없는 기능의 버튼은 빨간색으로 표시되며, 클릭하면 이유를 알려 줍니다. 알림 확인란 두 개와 클리커의 추가 컨트롤은 자물쇠 아이콘과 함께 회색으로 표시되며, 옆에 이유가 나와 있습니다.

변경 사항은 대략 30분 안에 적용됩니다. 계정 대화상자에서 요금제와 크레딧 잔액을 볼 수 있습니다.

문제 해결

증상일반적인 원인과 해결
클릭이 엉뚱한 곳에 떨어짐 녹화된 좌표는 절대 위치인데(녹화 참고) 창이 옮겨졌거나 해상도가 바뀌었습니다. click(x, y)를 click_crop("name")으로 바꾸세요.
한 단계씩 실행하면 되는데 전체 속도로는 실패함 대상 프로그램에 시간이 조금 더 필요합니다. 클릭은 이미 pre_click_ms=200만큼 대상 위에 머무릅니다. 실패하는 클릭에서는 400–600을 시도하거나, 더 좋은 방법으로 이제 쓰려는 대상을 wait_for로 기다리세요.
그림이 보이는데도 wait_for가 시간 초과됨 크롭에 바뀐 배경이 함께 담겨 있거나, 컨트롤의 테마가 다릅니다. 더 좁게 다시 캡처하거나, confidence를 낮추거나, match="shape"를 시도하세요. '이미지 검색' 로그 항목에서 점수를 볼 수 있습니다.
read_text가 엉뚱한 결과를 돌려줌 region이 없거나 너무 넓습니다. 텍스트만 남도록 좁히고, 기본 판독기로도 여전히 어렵다면 engine="tesseract"를 시도하세요.
ask_ai 단계나 AI 감시 행이 아무 답도 하지 않음 크레딧이 있는 로그인 계정이 필요하며, 내용을 읽을 수 있을 만큼 작은 region=이 필요합니다.
에이전트가 시작되지 않음 재생 중지 단축키가 지정되어 있지 않습니다(대화상자에 에이전트에는 중지 키가 필요합니다라고 표시됩니다). 설정 → 단축키에서 지정하세요. 크레딧이 있는 로그인 계정도 필요합니다.
에이전트가 중지됨 또는 막힘으로 끝남 한도에 도달했거나(한 단계가 세 번 실패, 40단계 도달, 크레딧 상한) 모델이 포기한 것입니다. 마지막 줄에 어느 쪽인지 나와 있습니다. 목표를 더 작은 작업으로 나누거나, 크레딧 최적화를 끄거나, 설정 → 에이전트에서 한도를 늘려 보세요.
실행 뒤 키보드가 눌린 채로 남음 key_down은 있는데 key_up이 없는 경우입니다. 손으로 직접 그 키를 눌렀다 떼고, 매크로를 고치세요.
알 수 없는 레이블 오류로 재생이 중지됨 goto, on_no, on_fail, 또는 wait_any의 화살표가 어떤 단계에도 레이블이 붙어 있지 않고 어떤 섹션 이름과도 맞지 않는 이름을 가리킵니다. 철자를 확인하세요. 레이블과 섹션 이름은 대소문자를 구분합니다.
단축키가 아무 반응도 하지 않음 다른 동작에 다시 지정되었거나, 꺼져 있거나, 다른 프로그램이 먼저 등록했습니다. Windows는 전역 키를 여러 프로그램이 함께 쓰게 두지 않습니다. 설정 → 단축키를 확인하세요.
내보낸 프로그램이 F6으로 중지되지 않음 다른 무언가가 이미 중지 단축키를 쓰고 있어서, 프로그램이 시작하기 전에 그렇다고 알리고 Ctrl+Shift나 Ctrl+Alt로 대신 지정했습니다. 단축키는 내보내는 시점에 '설정 → 단축키'에 지정된 대로 옮겨지므로, 다시 지정한 뒤 다시 내보내세요.
재생을 시작해도 아무 일도 일어나지 않음 대상 프로그램은 관리자 권한으로 실행 중인데 Recorder는 그렇지 않습니다. Recorder도 관리자 권한으로 실행하세요.
버튼이 빨간색으로 표시됨 내 요금제에 포함되지 않은 기능입니다. 클릭하면 메시지로 어떤 기능인지 알려 줍니다. 내 라이선스를 참고하세요.
내보낸 프로그램이 눈에 보이는 반응이 없음 제어 창 없이 내보낸 프로그램이라서, 열리는 즉시 실행되고 매크로가 끝나면 닫힙니다. 제어 창 표시를 켜서 다시 내보내세요. 그러면 실행, 일시 중지, 중지 버튼이 화면에 나타나고, 문제가 생기면 메시지로 알려 줍니다.

그래도 해결되지 않나요?

support@mynarecorder.com으로 메일을 보내세요. 무엇을 기대했고 실제로는 무슨 일이 일어났는지, 가능하면 로그와 함께 적어 주시면 한 번의 답장으로 실제 해결책을 드립니다.