문제 해결

대부분의 문제는 세 가지 중 하나에서 비롯됩니다. macOS 권한, 타이핑 방식과 맞지 않는 세션 설정, 또는 현재 사용 중인 앱을 조용히 제외하는 필터입니다. 아래 단계를 순서대로 진행하세요 — 가장 흔한 원인부터 드문 원인 순서로 되어 있습니다.

Pulse 작동 원리

Pulse가 무엇을 저장하는지 이해하면 대부분의 문제가 명확해집니다. Pulse는 Mac 전체에서 키스트로크 타이밍을 관찰하며 — 입력한 글자 자체는 절대 기록하지 않습니다 — 이를 묶어 타이핑 세션으로 저장합니다. 세션은 설정한 기준을 충족할 때만 저장됩니다. 기준은 최소 글자 수, 최소 단어 수, 그리고 하나의 세션이 끝나고 다음이 시작되는 시점을 정하는 비활성 시간입니다.

예를 들어, 단어 하나를 입력하고 비활성 시간보다 길게 멈추는 경우를 생각해보세요. 최소 4단어 이상이어야 유효한 세션으로 설정되어 있다면, 그 단어 하나는 버려집니다. 속도를 측정하기에 충분한 샘플이 아니므로 통계에 포함되지 않습니다.

별도로, 메뉴 막대 수치는 업데이트 간격에 따라 새로고침됩니다. 따라서 막 입력한 내용이 바로 반영되지 않을 수 있습니다. 이는 정상 동작이며 버그가 아닙니다.

Pulse가 세션을 저장하지 않아요

메뉴 막대가 0을 표시하거나, 업데이트되지 않거나, 한동안 새로운 기록이 없다면 가장 흔한 원인은 macOS 권한 문제입니다. 아래 단계를 따라 정확히 어디서 문제가 생기는지 확인하세요.

1단계 — Pulse가 키보드를 읽는지 확인

먼저 Pulse가 키스트로크를 받고 있는지 확인하세요. 가장 빠른 방법은 메뉴 막대에서 라이브 메트릭을 여는 것입니다. 라이브 메트릭 HUD는 타이핑 속도를 실시간으로 보여주는 작은 플로팅 패널입니다. 타이핑하는 동안 숫자가 속도에 따라 오르내려야 합니다.

타이핑하는 동안 속도가 반응한다면, Pulse가 키보드를 읽을 수 있는 것입니다 — 권한 문제가 아닙니다. 세션 설정 확인으로 바로 넘어가세요.

타이핑 중에도 0에 머문다면, Pulse가 키스트로크를 받지 못하고 있는 것입니다. 먼저 메뉴 막대에서 Pulse를 종료하고 다시 여세요. 그래도 0에 머문다면 권한 문제입니다 — 다음 단계로 진행하세요.

2단계 — 입력 모니터링 권한 확인

Pulse는 macOS 입력 모니터링 권한을 통해 키스트로크를 집계합니다. (오래된 안내서에는 손쉬운 사용이 언급되기도 하지만, Pulse는 더 이상 해당 권한을 사용하지 않습니다. 필요한 권한은 입력 모니터링입니다.) 확인 방법은 다음과 같습니다.

1. 시스템 설정 → 개인 정보 보호 및 보안 → 입력 모니터링을 여세요.
2. 목록에서 Pulse를 찾아 토글이 켜져 있는지 확인하세요.
3. Pulse가 목록에 없으면 + 버튼을 클릭하고 응용 프로그램 폴더에서 추가하세요. (Pulse는 첫 실행 시 이 권한을 요청합니다 — 설정 화면에서 시스템 설정 열기를 클릭하면 이 목록으로 바로 이동합니다.)

macOS는 Pulse가 실행될 때 이 권한을 바인딩합니다. 따라서 토글을 켠 뒤에는 Pulse를 재시작해야 집계가 시작됩니다. 권한 허용을 감지하면 Pulse가 직접 재시작을 안내합니다. 확실하지 않다면 메뉴 막대에서 종료하고 다시 여세요. 그런 다음 라이브 메트릭으로 다시 확인하세요.

3단계 — 목록에는 있지만 여전히 동작하지 않는 경우

때로는 macOS가 Pulse를 목록에 유지하지만 권한이 만료되어 토글을 껐다 켜도 해결이 안 될 수 있습니다. 이 경우 깨끗하게 초기화하세요.

1. 메뉴 막대에서 Pulse를 종료하세요.
2. 입력 모니터링에서 Pulse를 선택하고 − 버튼으로 제거하세요.
3. Mac을 재시작하세요.
4. 입력 모니터링으로 돌아가 + 버튼으로 Pulse를 다시 추가하고, 토글이 켜져 있는지 확인하세요.
5. Pulse를 열고 라이브 메트릭으로 정상 작동을 확인하세요.

세션 설정 확인

라이브 메트릭에 속도가 표시되는데 세션이 저장되지 않는다면, Pulse 자체는 정상 작동 중입니다 — 설정이 실제 타이핑 방식과 맞지 않아 세션이 너무 짧다고 판단되어 버려지고 있는 것입니다.

이를 실시간으로 확인할 수 있습니다. 라이브 메트릭 HUD를 열고 조금 타이핑한 뒤 멈추세요. 멈추는 순간 HUD가 세션 정보를 펼칩니다. 세션이 저장되었으면 녹색, 최솟값을 충족하지 못해 버려졌으면 빨간색으로 표시됩니다. 빨간색이 나온다면 임곗값이 실제 타이핑 빈도보다 높은 것입니다. 라이브 메트릭에는 최근 저장된 세션 목록도 표시됩니다.

Pulse는 라이브 메트릭이 열려 있든 없든 동일하게 동작합니다 — HUD는 그 결정을 실시간으로 볼 수 있게 해줄 뿐입니다.

Pulse에서 설정을 열고 실제 작성 방식에 맞게 조정하세요. (모든 타이핑 burst를 저장할 필요는 없습니다 — 단어 하나는 속도의 공정한 측정이 아니므로, 이 임곗값은 통계를 왜곡할 샘플을 걸러내기 위해 존재합니다.)

• 비활성 시간 — 마지막 키스트로크 이후 몇 초가 지나면 현재 세션을 종료할지 설정합니다. 작업 중 자연스럽게 멈추는 시간으로 설정하세요. 이 시간보다 오래 아무것도 입력하지 않으면, Pulse가 세션을 닫고 아래 최솟값에 따라 저장 여부를 판단합니다.
• 최소 글자 수 — 이 값보다 글자 수가 적은 세션은 저장되지 않습니다. 짧게 타이핑하는 경우 줄여보세요.
• 최소 단어 수 — 동일한 임곗값을 단어 수로 설정합니다.
• 업데이트 간격 — 메뉴 막대 수치가 얼마나 자주 갱신될지 설정합니다. Pulse는 모든 키스트로크를 계속 추적합니다. 이 설정은 리소스 사용을 줄이기 위해 화면 갱신 빈도만 조절합니다.

세션에 영향을 줄 수 있는 설정이 하나 더 있습니다. 합성 키스트로크 필터입니다. Pulse는 붙여넣기, 스니펫 확장기, AppleScript 및 기타 자동 입력을 제외하여 속도가 과장되지 않게 합니다. 하드웨어나 설정 환경이 자동 입력처럼 보이는 신호를 만든다면, 이 필터가 실제 타이핑을 버릴 수 있습니다 — 그런 경우 꺼보세요.

필터 모드 확인

Pulse는 설정 → 필터에서 특정 앱을 포함하거나 제외할 수 있습니다. 어떤 모드를 사용하는지에 따라 저장되는 내용이 달라지므로 확인해보는 것이 좋습니다.

• 제외 모드 — Pulse가 차단 목록의 앱을 제외한 모든 앱을 추적합니다. 현재 타이핑 중인 앱이 목록에 있으면 해당 내용은 저장되지 않습니다.
• 허용 모드 — Pulse가 목록에 있는 앱 만 추적하고 나머지는 무시합니다. 현재 타이핑 중인 앱이 목록에 없으면 저장되지 않습니다.

예상했던 세션이 나타나지 않는다면, 해당 앱이 제외되어 있는지 — 또는 허용 모드인 경우 추적 목록에 추가되어 있는지 — 확인해보세요.

진단 로그 보내기

위의 모든 단계를 진행했는데도 Pulse가 올바르게 집계하지 않는다면, 진단 로그를 통해 각 키스트로크에 대해 Pulse가 어떤 결정을 내렸는지 정확히 확인할 수 있습니다. 로그는 기본적으로 꺼져 있으며 Mac 외부로는 전송되지 않습니다 — 직접 선택할 때만 공유됩니다.

로그에는 키스트로크 메타데이터가 기록됩니다. 키 위치, 타이밍, 최전면 앱, 활성 입력 소스, 그리고 Pulse의 수락/거부 결정이 포함됩니다. 입력한 글자나 텍스트는 절대 기록되지 않습니다. 입력 내용을 복원하는 데 사용할 수 없습니다.

로그를 캡처하고 보내려면:

1. Pulse에서 설정 → 일반을 열고 진단 섹션을 찾으세요.
2. 진단 로깅을 켜세요. 로컬 파일에 기록되며, 24시간 후 자동으로 꺼집니다. 토글을 잊어버려도 파일이 계속 쌓이지 않습니다.
3. 문제를 재현해보세요 — 세션이 사라질 때와 같은 방식으로 타이핑하세요. 깨끗하게 캡처하고 싶다면 로그 지우기를 먼저 사용하세요.
4. Finder에서 보기를 클릭해 로그 폴더(~/Library/Application Support/Pulse/DebugLogs/)를 여세요. 로그 파일은 .jsonl 형식입니다.
5. 파일을 hello@utropia.es로 이메일 보내주세요. 관찰한 내용, macOS 버전, Pulse 버전(설정 → 정보에서 확인)을 간단히 적어주세요.

완료 후 진단 로깅을 다시 꺼주세요 (또는 24시간 자동 종료를 기다리셔도 됩니다). 캡처된 파일을 Mac에서 삭제하려면 로그 지우기를 사용하세요.

그래도 해결이 안 되나요?

Pulse는 1인 팀이 만들고, 모든 메시지를 직접 읽습니다. hello@utropia.es로 이메일을 보내거나 문의 페이지를 이용해 주시면 며칠 내로 답변드리겠습니다.