Skip to content

Releases

v1.2.2

Choose a tag to compare

@ignity21 ignity21 released this 19 Nov 12:17

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-web logs 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

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 16:05

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 Origin named the proxy's domain while Host was the IP. A write whose Origin is one of the names in ANKINOTE_ALLOWED_HOSTS is 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

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 15:32

Full Changelog: v1.1.3...v1.2.0

v1.1.3

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 14:34

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

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 12:41

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 why ANKINOTE_ALLOWED_HOSTS above 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.json included.
  • settings.json is 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, run chmod 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. Set ANKINOTE_API_DOCS=1 to 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 (usually 172.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

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 11:25

Fixed

  • CLI languages follow your settings. ankinote word|phrase|sentence now default --native/--target to 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: sentence input 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

Choose a tag to compare

@ignity21 ignity21 released this 18 Nov 07:02

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 ankinote CLI as a tool for agents like Claude Code or Codex: photograph a page with underlined words, and the agent extracts them and runs ankinote word batch ….

Breaking changes

  • The old NiceGUI app is gone. ankinote-gui no longer exists; use ankinote-web (the Docker image already runs it). Your settings.json is 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_SECRET is no longer used. Remove it from your .env if you set it; leaving it there does nothing.

Full Changelog: v1.0.6...v1.1.0

v1.0.6

Choose a tag to compare

@ignity21 ignity21 released this 17 Nov 04:03

Full Changelog: v1.0.5...v1.0.6

v1.0.5

Choose a tag to compare

@ignity21 ignity21 released this 16 Nov 03:00

Full Changelog: v1.0.4...v1.0.5

v1.0.4

Choose a tag to compare

@ignity21 ignity21 released this 15 Nov 11:56

Full Changelog: v1.0.3...v1.0.4