AnkiWeb addon 1098736891
Syncs words and cloze phrases saved in Lector into Anki notes by language, and sends Anki review states back to raise mastery levels.
Open on AnkiWeb GitHub Find alternatives
active
| Min Anki | Max Anki | Updated |
|---|---|---|
| 2.1.50 | 25.09.2+ | 2026-08-18 |
Loading…
Generates complete Anki flashcards for German, English and Spanish from a single typed word, including translations, example sentences, grammar, images, audio and optional cloze cards.
Two-way Google Sheets sync for vocabulary decks, writing review stats back to the sheet and gating reverse cards until forward cards mature.
Generates AI content for selected flashcards using Claude, ChatGPT, Gemini, or DeepSeek, saving custom-prompted results—definitions, translations, example sentences—directly into chosen fields via your own API key.
Generates AI-powered example sentences, explanations, collocations, and usage context for vocabulary, then turns that content into Anki notes via a floating window and context menu.
Provides instant popup dictionary lookup and translation on text selection or double-click in nine languages, with audio pronunciation, IPA, definitions, and Ctrl-click inline field editing.
Automatically translates example sentences and target words on newly created Yomitan cards into a chosen language via Google Gemini, filling the SentenceTranslation field in the background without blocking card creation.
Lector Sync connects Anki to Lector, a reading tool for language learners. Lector is at https://lector.dev and the source is at https://github.com/heuwels/lector.
Pull. Words and cloze phrases that you save in Lector become notes in Anki.
They use the Lector and Lector Cloze note types, and they go into one deck for
each language, such as Lector::Italiano. The add-on matches each note by a
stable id, so a repeat export updates the note and never makes a duplicate.
Push. Your Anki review states flow back to Lector and raise the mastery level of each word. Lector never lowers a level because a card lapsed. Daily review counts feed the activity heatmap in Lector.
Remote by design. The add-on talks to your Lector server directly with a scoped API token. Anki does not need to run on the same machine as your browser, and Lector can sit behind HTTPS on another host. Anki Desktop must be open for a sync, because AnkiDroid and AnkiMobile cannot run add-ons.
Hand-made cards. Add the lector tag to your own cards on the Lector note
types. Tagged cards join the sync, and Lector imports them with their sentence
and translation. Untagged cards stay private to Anki.
Deleted cards. When you delete a Lector card in Anki, Lector marks the word as no longer synced. You can then export the word again from the vocab page. Lector never makes the card again on its own, so a card that you delete on purpose stays deleted. A deletion takes two syncs to register. The first sync records your collection and the second reports what is gone.
api_url. Use https://app.lector.dev for the hosted service, or your
own API origin for a self-hosted server.api_token.Delete the old copy first. Open Tools → Add-ons, select the entry named Lector Sync with no AnkiWeb id, and select Delete. Two copies of the add-on sync the same queue twice.
Report a problem at https://github.com/heuwels/lector/issues. Include the text of the sync tooltip or the error dialog.
Lector is a language-learning reader. It is an open-source alternative to LingQ and Clozemaster. Use Lector Cloud, or self-host it with one Docker Compose file.
Import the text that you want to read. Tap a word for a translation. Save it. Practise it. Send it to Anki. A self-host stores data in one SQLite file.
Try the hosted app · Docs · Discord
A local dictionary covers common words with no API key.
Optional local models run through the bundled Ollama service.
Optional cloud models cover rare words and the tutor.
| App | Host | Database | Anki |
|---|---|---|---|
| Lector | Lector Cloud, or one Compose file | SQLite | Two-way (beta) |
| LingQ | Hosted only | Cloud | File export |
| Clozemaster | Hosted only | Cloud | No documented export |
| Lute | pip, Docker, or source | Local files | One-way AnkiConnect |
| LinguaCafe | Four Compose services | MySQL | One-way AnkiConnect |
Full pages live at lector.dev/vs.
You need Docker and Docker Compose.
git clone https://github.com/heuwels/lector.git
cd lector
docker compose up -d
Open http://localhost:3400.
The UI listens on port 3400. The API listens on port 3457. The browser calls the API directly, so both ports must be reachable.
If the browser is not on the server, set API_URL to the origin that the browser uses for the API. Example: http://192.168.1.10:3457.
# optional: cloud translation for rare words
export ANTHROPIC_API_KEY=sk-ant-...
docker compose up -d
The image is registry.lector.dev/lector:latest. That is our own address in
front of GitHub's registry, and pulling through it is the only way we have any
idea how many installs exist — GitHub publishes no pull statistics. No IP
address is stored; the privacy policy explains
what is recorded and how. To stay out of those numbers, pull
ghcr.io/heuwels/lector:latest instead — it is the identical image, and both
Compose files carry it as a commented-out line.
A production Compose file with health checks lives in deploy/. Full
environment notes live in deploy/README.md.
If you do not want to run a server, use the hosted app at app.lector.dev. Paid plans start at $5 per month.
Reader. Import a file or a stream. Each word has a state: new, learning, or known. Tap a word for a translation. The reader accepts:
Cloze practice. Frequency-ordered sentences. Choose an answer from a list, or type the missing word. Spaced repetition (SRS) with mastery levels.
Vocabulary. Save words as you read. Track known and learning states. Save phrases as well as single words.
Anki. The Lector Sync add-on on AnkiWeb is the recommended integration. The add-on code is 1098736891. Cloud mode and a remote HTTPS self-host always use it. A local self-host can instead push cards to AnkiConnect on the computer that runs Anki. Reviews in Anki can update mastery in Lector.
Tutor and journal. Ask grammar questions in plain language. Write in the target language. The tutor returns corrections. Use the Claude API or a local model.
Listen. Optional text-to-speech (TTS). YouTube captions stay timestamped. A podcast upload can become a transcript and a listen-along lesson.
Data. SQLite on your server. Export and restore from Settings. The self-host does not need a cloud account.
Language packs ship for:
A pack includes a dictionary, frequency data, and cloze sentences. Japanese and Korean have a dictionary. They do not have a cloze bank yet. The reader still works for a language with no pack. Depth is lower without a pack.
The language picker lists only the languages that you study. Open the picker and select Add a language to start another one. Open Settings, then Languages, to add a language or to remove one from the list. A language that you remove keeps its words, texts, and cards.
The image holds no dictionaries. Lector downloads the dictionary for a language when you add that language. It keeps the file in the lector-dict volume, so an image update does not remove it. The download runs in the background. The language works at once, because a word with no dictionary entry yet goes to the AI lookup.
The ghcr.io/heuwels/lector:full tag holds every dictionary. It is about 2.6 GB larger. Use it for an air-gapped install. Set DICT_FETCH=0 with it.
Afrikaans was the first pack. It remains the most complete reference set. It is not the product. The product is the reader for any language that you study.
See lector.dev/docs/languages for pack status.
Two transports exist. Open Settings, then Anki Integration, then Connection.
AnkiConnect for a local self-host. The browser talks to AnkiConnect on localhost:8765. Install the AnkiConnect add-on. Allow your app origin:
{
"webCorsOriginList": ["http://localhost:3400", "http://localhost:3456"]
}
Lector Sync add-on for cloud mode or a remote HTTPS self-host. A page on HTTPS cannot call localhost on the computer that runs Anki. The add-on runs inside Anki Desktop. It pulls queued cards onto Lector note types. It writes review states back to Lector. Point api_url at your Lector origin.
If you want a file, copy .env.example to .env. Compose also reads the process environment.
| Variable | Purpose |
|---|---|
ANTHROPIC_API_KEY |
Cloud translation and tutor. Optional. The local dictionary covers common words. |
API_URL |
Browser-facing API origin. Required when the browser is not on the server. |
LECTOR_MODE |
selfhost (default, one user, no login) or cloud (accounts). |
LLM_PROVIDER |
anthropic (default) or an OpenAI-compatible backend. |
OPENAI_COMPAT_URL |
Local model endpoint. The bundled Ollama service is http://ollama:11434. |
CLASSIFY_WORKER |
Set to 1 to fill the fluency radar. Compose sets this for you. |
DICT_LANGS |
Dictionaries to download at start. Use all for every language. Unset downloads only what you add in the picker. |
DICT_FETCH |
Set to 0 to never download a dictionary. Use it with the :full image. |
DICT_DIR |
Where the dictionaries live. The default is the lector-dict volume. |
TRANSCRIBE_WORKER |
Set to 1 to transcribe podcast uploads. Needs a Whisper endpoint. See deploy/README.md. |
The app runs with no API keys. Claude is only required for rare words, phrase translation, and the tutor.
The app caches TTS audio under DATA_DIR/tts-cache. Classification can use a provider batch API at half the synchronous price. Details live in deploy/README.md.
LECTOR_MODE=cloud enables accounts. The self-host stays free. Cloud mode is also the multi-user option on your server.
Required:
BETTER_AUTH_SECRET: generate with openssl rand -base64 32. Cloud mode does not start without it.BETTER_AUTH_URL: public origin for auth links, for example https://app.example.com.Optional:
GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET: Sign in with GitHub.OIDC_ISSUER, OIDC_CLIENT_ID, and OIDC_CLIENT_SECRET.RESEND_API_KEY: verification mail. Without it, mail lands in the server log.TURNSTILE_SITE_KEY and TURNSTILE_SECRET_KEY: bot protection on sign-up.CAUTION: Do not change LECTOR_MODE before you read Move self-host data to an account. If you switch an existing self-host database to cloud mode, the old library stays in the database. The new account does not see it until you move it.
LECTOR_CLOUD_GATE=external sends login to a gateway such as Cloudflare Access. The AWS path lives in deploy/cloud/.
In self-host mode every row belongs to the implicit local user. Cloud mode shows only rows that the signed-in account owns. An empty library after the switch is not data loss.
adopt-local-data moves every row from local to one fresh account. If the target account already owns rows, the script refuses. The default run does not write data.
Stop the app.
Copy DATA_DIR to a backup. Include lector.db. See Backups.
Set LECTOR_MODE=cloud.
Set the auth variables.
Start the app.
Create the target account in the browser.
Check the mail link.
List accounts:
docker compose exec lector sh -c \
'cd /app/api && DATA_DIR=/app/data bun run src/scripts/adopt-local-data.ts --list'
Run the move with no write. The command prints per-table counts:
docker compose exec lector sh -c \
'cd /app/api && DATA_DIR=/app/data bun run src/scripts/adopt-local-data.ts --to you@example.com'
Run the same command with --commit to apply it.
Sign in.
Confirm the library, the vocabulary, and the stats.
Keep the backup.
To roll back:
DATA_DIR.LECTOR_MODE.In-app export. Open Settings, then Learning data, then Export all learning data. This is a JSON export of the library, vocabulary, SRS state, journal, and stats. Restore it with the matching import.
Volume copy. If the app is stopped, copy DATA_DIR. If the app still runs, create a SQLite checkpoint first:
sqlite3 "$DATA_DIR/lector.db" "PRAGMA wal_checkpoint(TRUNCATE)" && cp -a "$DATA_DIR" /path/to/backups/
The hosted app streams writes to object storage with Litestream. See deploy/cloud/.
To run from source, read CONTRIBUTING.md. That file also holds the folder styleguide and the OpenAPI rules.
npm install
npm run dev:api # Hono API on :3457
npm run dev # Next.js UI on :3456
Open http://localhost:3456.
Copyright © 2026 Luke Boyle.
Licensed under the GNU Affero General Public License v3.0 (AGPLv3). See LICENSE. You may use, self-host, study, modify, and redistribute Lector. If you run a modified version as a network service, you must offer the matching source to its users. See AGPL section 13.