Lispr ← Back to lispr.ai
도움말

Lispr를 최대한 활용하세요.

Lispr는 일부러 작게 만들었습니다 — 설정 창도 없고, 계정도 없고, 깜짝 놀랄 일도 없습니다. 이 페이지는 Lispr가 무엇을 하는지, 가끔 어긋나는 몇 가지 문제를 어떻게 고치는지, 그리고 당신의 목소리에 무슨 일이 일어나는지 설명합니다.

처음 설정

Lispr는 첫 실행 시 이 과정을 안내합니다 — 다시 해야 할 경우를 대비해 같은 흐름을 기록해 둡니다.

1. 마이크

Lispr는 당신의 목소리를 들어야 합니다. macOS가 처음에 묻습니다. 프롬프트를 놓쳤거나 권한을 취소했다면 시스템 설정 → 개인정보 보호 및 보안 → 마이크에서 권한을 부여하세요 — Lispr를 켜세요.

2. 손쉬운 사용

Lispr는 인식된 텍스트를 커서가 있는 곳에 삽입합니다 — 이를 위해 손쉬운 사용 권한이 필요합니다. 시스템 설정 → 개인정보 보호 및 보안 → 손쉬운 사용에서 권한을 부여하세요 — Lispr를 켜세요.

3. Input Monitoring (macOS 10.15+ 에서만)

다른 앱이 포커스를 가지고 있을 때도 Lispr가 트리거 키 누름을 들을 수 있도록 하기 위함입니다. 시스템 설정 → 개인정보 보호 및 보안 → Input Monitoring에서 권한을 부여하세요. Lispr는 0.33부터 IOHIDRequestAccess를 통해 적절히 요청합니다.

이 권한들은 허용해도 계정을 만들거나 당신의 기계 밖으로 무언가를 보내지 않습니다. 그저 Lispr가 실제로 작동하기 위해 필요한 macOS의 부분을 해제할 뿐입니다.

일상 사용

눌러서 말하기

오른쪽 키를 누른 채로 말하고 손을 떼세요. 어떤 앱에서든 커서 위치에 텍스트가 나타납니다. 그게 전부입니다 — 깨우기 단어 없음, 듣기 모드 없음, 설정 없음.

고정(핸즈프리) 모드

트리거 키를 두 번 두드리면 다시 두드릴 때까지 Lispr가 녹음을 계속합니다. 양손을 자유롭게 써야 할 때 유용합니다.

녹음 중간에 취소

녹음 중 Esc를 누르면 말한 내용이 폐기됩니다 — 아무것도 받아쓰지 않고, 아무것도 삽입하지 않습니다.

대체 트리거 키

Mac에서 오른쪽 가 다른 단축키에 점유되어 있다면, Lispr는 Fn 키도 push-to-talk 트리거로 지원합니다.

언어

Lispr는 다국어 지원 Whisper를 통해 받아씁니다. 언어는 자동으로 감지됩니다 — 문장 도중에 바꿔도 따라옵니다. 약 99개 언어가 인식되며, 별도 설정이 필요 없습니다.

스마트 문장 이음

한 구절을 받아쓰고 바로 이어서 또 받아쓰면, Lispr가 그 사이에 마침표와 공백을 넣어줍니다 — 끝없이 이어지는 문장이 안 됩니다. 자동 이음은 Lispr 자체의 직전 삽입 이후에만 일어나므로, 당신이 직접 친 텍스트는 건드리지 않습니다.

클립보드

Lispr는 텍스트 삽입에 클립보드를 내부적으로 사용합니다 — 하지만 직후에 당신이 복사해 둔 것을 복원합니다. ⌘V는 여전히 한 시간 전에 복사한 링크나 단락을 돌려줍니다.

업데이트

Lispr는 Sparkle을 통해 자동 업데이트됩니다 — 새 릴리스가 서명되면, 설치된 Lispr가 다음 실행 시 이를 제안합니다. 각 버전에서 무엇이 바뀌었는지는 changelog를 보세요.

문제 해결

트리거 키가 아무 반응이 없음

  • Input Monitoring이 허용되어 있는지 확인하세요(위의 3단계) — 이것이 없으면 Lispr는 백그라운드 앱에서의 키 누름을 볼 수 없습니다.
  • 다른 앱이 오른쪽 를 가로채고 있지 않은지 확인하세요 — Karabiner, BetterTouchTool, Raycast 단축키, Magnet 등. 만약 그렇다면, 메뉴 막대 아이콘에서 Lispr를 Fn으로 전환하세요.

"잘 들리지 않았어요"

Lispr는 매우 짧고 조용한 녹음을 필터링합니다(0.39부터) — 이 중 약 10건 중 9건은 짧은 침묵이었고 놓친 말이 아니었습니다. 이 메시지가 뜨는데도 실제로 말한 경우: 말하기 전에 키를 잠깐 더 눌러 보고, 메뉴 막대 아이콘에서 올바른 입력 장치가 선택되었는지 확인하세요.

텍스트가 엉뚱한 앱에 들어감

Lispr는 트리거 키를 놓는 순간 포커스가 있는 커서에 삽입합니다. 녹음 도중 앱을 바꿨다면 텍스트는 새 앱에 들어갑니다. 팁: 키를 누르기 전에 커서를 목적지에 두세요.

메뉴 막대 아이콘이 안 보임

  • 특히 macOS 11–12에서 이전 빌드(≤ 0.24)가 아이콘을 잃어버릴 수 있었습니다 — changelog 페이지에서 최신 버전으로 업데이트하세요. 이는 0.25에서 수정되었습니다.
  • 최신 macOS인데도 보이지 않는다면, 메뉴 막대가 가득 차서 아이콘이 Control Center / Bartender 아래에 숨어 있을 수 있습니다. 몇 개를 숨겨 메뉴 막대 공간을 넓혀 보세요.

받아쓰기 시간 초과

네트워크가 끊기면 Lispr는 이제 10초 후 포기하고(0.34부터) 친절한 메시지를 보여줍니다. 다시 시도해 보세요 — 다음 요청은 자주 성공합니다. Lispr는 일시적 실패에도 자동으로 재시도(0.31부터)하기 때문입니다.

Sparkle이 업데이트를 가져오지 못함

DMG와 appcast는 proxy.lispr.ai에서 TCP-only 경로로 제공됩니다(0.39부터) — 이는 일부 네트워크의 HTTP/3 문제를 우회합니다. 네트워크가 여전히 막는다면, 언제든 lispr.ai에서 최신 Lispr.dmg를 직접 다운로드해 앱을 수동으로 교체할 수 있습니다.

10분 녹음 한도

Lispr는 한 번의 녹음을 10분 후 로컬라이즈된 경고와 함께 중지합니다(0.37부터) — 우발적 마라톤 녹음을 막기 위한 부드러운 상한입니다. 더 긴 받아쓰기는 한 번 놓고 새 녹음을 시작하세요.

개인정보 보호 빠른 참조

전체 이야기는 개인정보 보호정책에 있습니다. 여기는 대부분이 묻는 짧은 버전입니다.

제 목소리는 어디로 가나요?

당신의 Mac에서 암호화된 연결을 통해 저희가 운영하는 엣지 프록시로 가고, 그 프록시는 받아쓰기를 위해 Groq로 전달합니다. Groq가 텍스트를 반환하고, 프록시가 그것을 당신의 Mac으로 돌려주며, 오디오는 즉시 폐기됩니다. 서버에 아무것도 저장하지 않습니다. 아무것도 모델 학습에 쓰지 않습니다.

계정이 있나요?

없습니다. 가입 없음, 비밀번호 없음, 프로필 없음. 로그인할 곳이 없는 이유는 로그인할 곳이 없기 때문입니다.

로그는요?

0.40부터, 문제가 생기면 Lispr는 진단용 X-Lispr-* 헤더를 보낼 수 있습니다 — 이는 헤더(타이밍, 오류 코드)이며 오디오나 받아쓴 내용이 아니고, 서버 측에 보관하지 않습니다.

오프라인에서도 동작하나요?

아니요 — 받아쓰기는 클라우드에서 실행됩니다. 그래서 빠르고(0.41부터 종단간 중앙값 ~300 ms) 정확합니다. 완전히 로컬한 받아쓰기가 필요하다면 macOS 내장 받아쓰기가 괜찮은 대안입니다. 이는 속도와 언어 커버리지를 위해 우리가 한 트레이드오프입니다.

여전히 막혔나요?

여기서 답을 찾지 못했다면 — 버전(메뉴 막대 → Lispr 정보)과 망가졌을 때 무엇을 하고 있었는지 적어 보내주세요. 파헤쳐 보겠습니다.

[email protected]