Tutorial

From install to your firstword card

This guide walks you through connecting Magpie to Anki: install Anki and the AnkiConnect add-on, let Magpie create the deck and card templates in one click, then clip to add cards — words go to Word cards, longer text to Content cards, with source and date attached. Scheduling is handled by Anki's spaced repetition.

Download MagpieRequires macOS 12+ or Windows 10+, and Anki running on this machine.

Before you start

Two things to prepare

Magpie

Download and install from GitHub Releases. macOS ships a universal .dmg; Windows ships an x64 installer.

Anki 2.1.50+

Get the desktop app from apps.ankiweb.net (Windows / macOS / Linux). Free, open source, runs locally, works offline.

Five steps

From zero to your first card

About 8 minutes end to end — two downloads, one click; after that, cards are created at the moment of selection.

01

Install Anki

~3 min

Visit apps.ankiweb.net, download the desktop build for your system and install it. Anki is free and open source; all data stays on your computer.

  • Windows: 64-bit installer; macOS: pick Apple Silicon or Intel
  • First launch walks you through a blank profile — the default is fine
02

Install the AnkiConnect add-on

~2 min

Magpie talks to Anki through AnkiConnect — without this step, clipping shows a connection failure. To install: open Anki → the Tools menu → Add-ons → Get Add-ons…, paste the code 2055492159 into the dialog, click OK — AnkiConnect appears in the list. Then restart Anki (quit fully and reopen) for it to take effect.

  • Add-on code: 2055492159 (AnkiConnect is a free, open-source add-on from the official directory)
  • Menu path: Tools → Add-ons → Get Add-ons…
  • Restart Anki after pasting the code, or Magpie won't detect it
  • You can also open ankiweb.net/shared/info/2055492159 in a browser to see the add-on details
03

Install Magpie

~2 min

Use the download link at the top of this page or on the homepage, then install from GitHub Releases. macOS build is unsigned: right-click → Open on first launch. Windows: choose "Keep anyway" on the SmartScreen prompt.

  • Clipping needs the Accessibility permission on macOS (granted in System Settings)
  • Install notes live in the homepage download card
04

One-click setup

10 sec

Open Magpie settings → Anki; the page detects your local Anki automatically (keep Anki running). Click the setup button and Magpie creates: the "Magpie" deck (with two sub-decks) and two card templates. It only writes Magpie's own items and never touches your existing decks or templates.

  • The Ready badge means setup is done; existing decks and templates are never created twice
  • If Anki isn't detected, make sure it is running and past the profile screen
05

Clip to add cards

clip away

Select a word in any app and click "Anki" on the floating bar — the card lands in Magpie::Word with the original text on the front. Longer selections go to Magpie::Content. The ⌄ menu picks a type manually; clicking Anki inside the result window also puts the current explanation or translation on the back.

  • Short selections (words, phrases) go to Word cards; long ones to Content cards
  • Source app and date are attached automatically, clustered by day for look-back
  • Duplicates are rejected by Anki — you'll see a notice instead of a second copy

Your first card is in

Every clip after this is a zero-effort save; Anki handles the schedule.

What it looks like

Set up once,clip to add cards

Illustrative mockups (slightly simplified from the real UI).

Creates a "Magpie" deck in Anki, plus two card templates: Word and Content.

Set up in one click

Settings · one-click setup

Detect, click once, deck and templates land in place — the badge shows readiness.

Safari — original sentence

The quickest way to remember a word is to meet it again right before you forget.

TranslateExplainSummarizeCopyAnki
Word拾趣::单词卡
Content拾趣::内容卡

Clip · pick a card type

Click Anki on the floating bar to add instantly; ⌄ expands to pick Word or Content.

Start learning

Cards are in —let spaced repetition schedule the rest

Anki's core is spaced repetition: reviews land right before you're about to forget, so memory sticks with the fewest repetitions. Magpie makes saving effortless; Anki handles the schedule.

Magpie · Word

resilient

/rɪˈzɪliənt/ adj. able to recover quickly

Example: A resilient mind recovers faster than a perfect plan.

Back side from the Explain action
Source: Safari · 2026-11-16Show answer

Review daily

The main screen shows today's due count — click the "Magpie" deck to start. New cards default to 20/day, adjustable in deck options.

Grade honestly

Couldn't recall? Hit "Again". Easy recall gets "Good" — the more honest your grades, the sharper the schedule.

Edit any time

Only the explanation on the back? Double-click a card in Anki to add examples, images or audio.

Review on your phone

Create an AnkiWeb account, sync once on desktop, then install AnkiDroid (Android, free) or AnkiMobile (iOS) to review anywhere.

Going further

Learning resources

To go deeper with Anki, these are the main official and community resources.

FAQ

About Magpie × Anki

Does adding cards need internet?

No. Card creation is local communication between Magpie and Anki on your machine. Only when the back side should carry an AI answer does the selected text go to the model service you configured.

Will it touch my existing decks and templates?

No. Setup only creates the "Magpie" deck, its two sub-decks and two card templates; same-name items are skipped, and everything else stays untouched.

Can I add cards while Anki is closed?

No. AnkiConnect runs inside the Anki process; when Anki isn't detected, Magpie shows a connection failure. Start Anki first, then clip.

Will the same word be added twice?

No. Anki deduplicates on the first field (the original text); on duplicates Magpie shows a notice that the card already exists.

Can I review on my phone?

Yes. After syncing desktop with AnkiWeb, review the same deck on Android with AnkiDroid (free) or on iOS with AnkiMobile.

Can I change card styling?

Yes. Styling belongs to the Anki note type: open Tools → Manage Note Types in Anki, find Magpie Word / Content and edit templates or CSS — changes apply to new cards.

Ready to start

Download Magpie, set up Anki, and your next selection is your first card.