Repository navigation
Releases
v1.2.2
What's new
Anki Desktop is now the recommended way in, on the computer you study on. Cards go straight into Anki through the AnkiConnect add-on: no second collection, nothing to download first, and Anki syncs them as usual. Built-in Anki with AnkiWeb sync stays the choice for an always-on home server or NAS, where you add cards from your phone while the computer is off.
- Connect Anki preselects Anki Desktop on a fresh install and lists it first. It looks for AnkiConnect by itself, tags Anki Desktop "Found" when it answers, and keeps checking every few seconds while you install the add-on and restart Anki.
- Choosing Built-in Anki while Anki Desktop is running on the same computer shows a warning: it would keep a second copy of your collection, and the two copies can later force a full sync that overwrites one of them.
- Nothing is set up in Anki until you press Connect.
- Switching between the two options and back now shows the note types again.
ankinote-weblogs a warning when it listens beyond this computer: AnkiNote has no login, so keep it on a home network or Tailscale, or behind a reverse proxy that asks for one.- The README is now also in Traditional Chinese, and every README, the deploy guide and the roadmap describe when to use which Anki connection.
After you upgrade
Nothing to do. A choice you already saved is kept, and the headless Docker stack still uses Built-in Anki.
Full Changelog: v1.2.1...v1.2.2
v1.2.1
Fixed
- Reverse proxies that forward to an IP address no longer break saving, syncing and model lists. Since 1.1.2, a proxy (NAS or home-server portals, for example) that forwards to the backend's IP made every write fail with 403: the browser's
Originnamed the proxy's domain whileHostwas the IP. A write whoseOriginis one of the names inANKINOTE_ALLOWED_HOSTSis now accepted.
After you upgrade
If you open AnkiNote through a domain, list it in ANKINOTE_ALLOWED_HOSTS (comma-separated), even when the proxy forwards to an IP:
ANKINOTE_ALLOWED_HOSTS=anki.example.com
Full Changelog: v1.2.0...v1.2.1
v1.2.0
v1.1.3
Fixes for the setup wizard and the card previews, and a new typeface for the app and your cards.
After you upgrade: restyle your note types
The cards now use Source Sans 3 instead of IBM Plex Sans, so Note types says "Anki has an older version" for your AnkiNote note types. Select Set up all there; opening Settings → Anki does the same by itself. This only changes the styling and adds the font files to your collection, so a normal AnkiWeb sync carries it; no full sync is needed.
Setup wizard
- AnkiWeb's full-sync choice no longer slips through. If setting up the note types adds fields to ones already in your collection (for example, from an older AnkiNote), Anki has to send the whole collection to AnkiWeb once. Connect Anki now shows that, offers the upload, and keeps Next disabled until it's done. Before, it still said "Synced", and saving the first card failed with "AnkiWeb needs attention".
- Clearer names when the two copies differ. The choice is now between "Built-in Anki" and "AnkiWeb", and each option shows which way the copy goes and which side gets replaced.
- The first card is kept when you go back to an earlier step. If saving it is blocked, the error links straight to Connect Anki, and Next brings you back to the card.
- The footer stays in view and sits under the step's content: Back, the main button, then what's still missing. On the last step the main button saves the card until it's saved.
Card previews
- Previews show the card at phone scale (at most 560px wide), on Generate, Note types and in the wizard. Before, a wide preview showed every card at a large desktop window's size, with oversized text and headwords.
- On a phone, Generate shows the whole card. The page scrolls as a whole instead of squeezing the card into a small box; sending a word returns to the top, where its progress shows.
Type
- Source Sans 3 replaces IBM Plex Sans in the app and on cards. Plex's files lack most IPA symbols, so pronunciations like /ˈθɪŋ.kɪŋ/ mixed in a fallback font; Source Sans covers IPA and Greek, and matches Source Han Sans / Noto Sans CJK in mixed Chinese and English lines. Plex Mono stays for status text.
Full Changelog: v1.1.2...v1.1.3
v1.1.2
A security release. AnkiNote has no login, so these fixes stop other web pages, other users on the same machine, and logs from getting at your Anki collection and API keys. Upgrading is recommended.
Before you upgrade: opening AnkiNote by a host name
AnkiNote now answers only to localhost and IP addresses. If you open it by a name, such as a reverse proxy's ankinote.example.com, a Tailscale MagicDNS name or mybox.local, add that name to ANKINOTE_ALLOWED_HOSTS (comma-separated) in .env. Without it, every request gets a "does not answer to the host name" error. Access via localhost or an IP address needs no change. See Before you open it to other devices.
Security
- Web pages you visit can no longer drive AnkiNote. A cross-site request is refused before it can change anything: full sync, AnkiWeb login and logout, settings and card generation. Requests from the CLI, curl and AnkiNote's own page work as before.
- Protection against DNS rebinding. A web page can no longer read AnkiNote's API by pointing its own domain at
127.0.0.1(this is whyANKINOTE_ALLOWED_HOSTSabove is needed). - Windows: the web server no longer serves files from outside its own folder. Before this fix, a crafted URL could read any local file,
settings.jsonincluded. settings.jsonis private to your user (mode 0600) and is replaced in one step, so a crash can't leave it truncated. An existing file is fixed the next time you save settings. To fix it now, runchmod 600 ~/.config/ankinote/settings.json.- Google API keys (Gemini, Cloud TTS) no longer appear in URLs. They go in a request header, which keeps them out of proxy and HTTP client logs.
- Model checks pass on only the provider's error message. A raw response body is no longer passed back, so a custom base URL can't be used to read internal services.
- The interactive API docs (
/api/docs) are off by default. SetANKINOTE_API_DOCS=1to turn them on while developing.
Docs
deploy/README.md(standard/) no longer recommends AnkiConnect with"webBindAddress": "0.0.0.0"and"webCorsOriginList": "*". That setup let any web page you visited read and change your collection. On Linux, bind AnkiConnect to the Docker bridge (usually172.17.0.1) instead, and leave its CORS list alone. If you followed the old advice, undo it.
Full Changelog: v1.1.1...v1.1.2
v1.1.1
Fixed
- CLI languages follow your settings.
ankinote word|phrase|sentencenow default--native/--targetto the languages you picked in the web app, instead of always Chinese (Simplified) → English. Explicit flags still win. This matters most when an AI agent runs the CLI for you.
Docs
- The agent skill (
.agents/skills/ankinote-cli) is rewritten for 1.x: it starts from the agent's workflow, and covers built-in Anki vs AnkiConnect, Docker, and sync states that need your decision. docs/cli-usage.md:sentenceinput is in the target language (it said native).
Docker: the GHCR image has moved
Since 1.1, GHCR images are published as ghcr.io/ankinote-ai/ankinote. The old ghcr.io/ignity21/ankinote-ai is no longer updated. If your .env sets ANKINOTE_IMAGE to the old name, change it, then docker compose pull && docker compose up -d. See Upgrading. The Docker Hub image ignity21/ankinote-ai is unchanged.
Full Changelog: v1.1.0...v1.1.1
v1.1.0
What's new
- A new mark. The card's front and back as two tiles. In the app it takes your palette; the favicon, app icons and README use the default Rosé Pine.
- Install it as an app. The web app now has app icons and a manifest, so "Add to Home Screen" on iPhone/iPad/Android and "Install" in desktop browsers give it a proper icon.
- Use the CLI from an AI agent. The README now shows the
ankinoteCLI as a tool for agents like Claude Code or Codex: photograph a page with underlined words, and the agent extracts them and runsankinote word batch ….
Breaking changes
- The old NiceGUI app is gone.
ankinote-guino longer exists; useankinote-web(the Docker image already runs it). Yoursettings.jsonis unchanged. - The encrypted settings backup is gone with it; it only existed in the old app. Your settings stay in
~/.config/ankinote/settings.json. ANKINOTE_STORAGE_SECRETis no longer used. Remove it from your.envif you set it; leaving it there does nothing.
Full Changelog: v1.0.6...v1.1.0