Guru
무료 · 오픈 소스 · LGPL-3.0

이미 가지고 있는 iPhone을 Anki 리모컨으로

QR 코드로 10초 만에 iPhone과 Anki Desktop을 페어링하고, 소파, 러닝머신 등 어디서든 답 보기 / 다시 / 어려움 / 보통 / 쉬움을 누르세요. 저렴한 8BitDo 컨트롤러를 iPhone에 연결하면, 신호가 iPhone을 거쳐 Mac으로 전달됩니다 — AnkiMobile이 페어링을 거부하는 모델도 여기서는 작동합니다.

다운로드App Store AnkiWeb에서 보기
iPhone showing the Show Answer button while a MacBook in the background runs Anki — connected wirelessly

설정(3단계, 약 1분)

  1. Mac에서: Anki를 열고 도구 → 애드온 → 애드온 받기…에서 이 코드를 입력하세요:
    1196082853
    Anki를 재시작합니다. 애드온이 처음 시작될 때 macOS가 「들어오는 연결을 허용하시겠습니까?」라고 묻습니다 — 허용을 클릭하세요.
  2. iPhone에서: App Store에서 Guru를 설치하세요.
  3. 페어링:
    • Anki에서: 도구 → 전화 연결(Flashcard Guru Remote)… — QR 코드가 표시됩니다.
    • Guru에서: 설정 → Anki 리모컨 → Mac과 페어링 — QR을 스캔하세요.
    끝났습니다. Mac에서 아무 덱이나 열면 iPhone이 인계받습니다.

실제 설정 화면

아래 흐름대로 진행하세요. Anki Desktop에서 애드온을 설치하고 재시작한 뒤 QR 페어링 창을 열고, Guru에서 스캔합니다.

Anki Tools 메뉴에서 Add-ons를 선택한 화면
1 Anki 애드온 열기

Mac에서 Anki를 열고 Tools → Add-ons를 선택합니다.

Anki Add-ons 창에서 애드온 코드를 입력하는 화면 (1) Anki Add-ons 창에서 애드온 코드를 입력하는 화면 (2)
2 애드온 코드 입력

Get Add-ons…를 클릭하고 1196082853을 입력한 다음 확인합니다.

Flashcard Guru Remote 설치 성공 화면
3 Anki 재시작

설치가 완료되면 Anki를 재시작하세요. Flashcard Guru Remote가 Tools 메뉴에 표시됩니다.

Anki Tools 메뉴에서 Connect Phone을 선택한 화면 (1) Anki Tools 메뉴에서 Connect Phone을 선택한 화면 (2)
4 Mac에서 QR 코드 표시

Anki를 다시 열고 Tools → Connect Phone (Flashcard Guru Remote)…를 선택합니다.

Guru Settings 화면의 Anki Remote 항목
5 iPhone에서 Anki Remote 열기

Guru에서 Settings → Anki Remote로 이동합니다.

Guru Anki Remote 화면의 Pair with Mac 항목
6 Mac과 페어링

Pair with Mac을 탭하고 Mac의 QR 코드를 스캔하면 연결됩니다.

원격으로 조작 가능한 항목

답 보기현재 카드 뒤집기.
다시 / 어려움 / 보통 / 쉬움4단계 평가 모두.
오디오 재생미디어가 있는 덱용.
실행 취소직전 평가 되돌리기.

하드웨어 컨트롤러 지원

iPhone에 컨트롤러를 연결(USB-C 또는 Bluetooth)하면 Guru가 버튼을 Anki Desktop으로 전달합니다:

게임패드(MFi)

  • A → 보통 · B → 다시 · X → 어려움 · Y → 쉬움
  • R1 → 답 보기 · L1 → 재생 · Options → 실행 취소

키보드 모드(8BitDo Zero 2 / micro / 외장 키보드)

  • 1 / 2 / 3 / 4 → 다시 / 어려움 / 보통 / 쉬움
  • Space → 답 보기 · R → 재생 · Z 또는 U → 실행 취소

키보드 모드 덕분에 저렴한 8BitDo 컨트롤러를 사용할 수 있습니다 — 이 작은 모델들은 Apple의 GCExtendedGamepad 프로파일을 노출하지 않아서 AnkiMobile이 거부합니다. Guru는 GCKeyboard도 함께 듣는데, 이게 8BitDo의 「키보드 모드」 출력과 맞아떨어집니다.

개인정보

  • LAN 전용. 페어링 토큰은 로컬 Wi-Fi를 떠나지 않습니다. 애드온은 안전 검사로 비공개 IP 범위 외부의 연결을 거부합니다.
  • 텔레메트리 없음. 분석, 원격 로깅, 덱이나 카드 업로드 일체 없음.
  • 언제든 취소 가능. Anki 페어링 대화상자에서 iPhone을 「잊기」 하면 토큰이 즉시 무효화됩니다.

자주 묻는 질문

AnkiMobile(공식 iOS Anki 앱)과 함께 작동하나요?
아니요. 이는 독립적인 iOS 플래시카드 앱인 Guru의 컴패니언입니다. 애드온은 Guru와 WebSocket으로 통신하지, AnkiMobile과 통신하지 않습니다.
왜 StudyRemote처럼 그냥 Bluetooth 키보드로 만들지 않나요?
iOS는 서드파티 앱이 Bluetooth HID 주변기기로 작동하는 것을 허용하지 않습니다 — 이는 플랫폼 수준의 제한이며 우회할 수 없습니다. 대신 Wi-Fi WebSocket 경로로 동일한 복습 조작 경험을 제공합니다.
Windows나 Linux에서 작동하나요?
아마도 작동합니다 — Python 애드온 자체는 크로스 플랫폼입니다 — 하지만 QA는 macOS에서만 적극적으로 합니다. 최소 지원: Anki 2.1.55+(Qt6 빌드).
애드온은 어떻게 업데이트하나요?
Anki Desktop이 자동으로 애드온 업데이트를 확인합니다. 도구 → 애드온에서 버전을 보여주고, 업데이트 확인으로 AnkiWeb에서 새 버전을 받습니다.
iOS 앱은 오픈 소스인가요?
애드온은 LGPL-3.0으로 오픈 소스: jyehn/flashcard-guru-remote-addon. iOS 앱 자체는 비공개입니다.

소스 & 지원