Chinese Reading Add-on

AnkiWeb addon 429826592

Generates tone-coloured pinyin, bopomofo, and jyutping readings, simplified/traditional variants, and injects CSS/JS into card templates for studying Chinese flashcards.
AI-generated summary; may contain mistakes.

card-creation formatting card-templates

Open on AnkiWeb GitHub Find alternatives

AnkiWeb

Votes: 0 (👍 0 · 👎 0)
Updated: 2026-06-14
Anki versions: 25.09.2~
License: GPL-3.0 (from the GitHub repository)
Virus scan: No ClamAV match A match does not prove malware. No match does not prove that the code is safe.
Languages: TSV, Python, JavaScript, CSV, JSON
Description language: en

Maintenance

active

Last update or commit: 2026-06-19 (135 days before the snapshot).
Test files: 12.
GitHub Actions workflows: 1.
Commits in the last year: 81.
Issues are turned off.
Pull requests: 0 open, 1 merged.

GitHub

Repository: alexander-nilsson/chinese-reading-addon · more by alexander-nilsson
Stars: ⭐ 2 · forks 0 · open issues 0
Last commit: 2026-06-19
License: GPL-3.0
Languages: Python, JavaScript
Tests: 12

Will it work on my Anki?

Version branches

Min Anki	Max Anki	Updated
25.09.2	+	2026-06-14

History across monthly snapshots

Loading…

Similar addons

Chinese Support 3 has 2 forks →

Automatically fills Chinese flashcard fields with translations, Pinyin or Jyutping romanization, audio, simplified/traditional characters, frequency, and example sentences, plus tone coloring.

card-creation formatting card-templates dictionary fork-or-reupload beta

Chinese Support Redux v0.14.2 archived has 1 fork →

Automatically fills Chinese flashcard fields with translations, Pinyin or Jyutping romanization, audio, traditional/simplified characters, Bopomofo, rubies, frequency data, and tone colors using built-in note types.

card-creation formatting card-templates dictionary obsolete fork-or-reupload beta

🐼Chinese Support V4 - auto fill Chinese cards (Fixed by Shigeඞ) fork

Automatically fills Chinese note fields from entered hanzi, providing translations, pinyin or Jyutping, audio, simplified/traditional characters, Bopomofo, frequency, example sentences, and tone coloring.

card-creation formatting card-templates dictionary obsolete fork-or-reupload

Hanzi2Pinyin

Converts Chinese characters in any Anki field into Pinyin or Zhuyin ruby annotations displayed above the Hanzi, supporting simplified and traditional text.

card-creation formatting

Chinese Vocabulary Generator

Generates Chinese vocabulary notes with simplified and traditional characters, pinyin, meanings, audio, and example sentences fetched online, adding them to selected Anki decks.

card-creation card-templates dictionary

Hanzi Writer Card Template

Enables stroke-order practice for simplified and traditional Chinese characters in Anki, with progressively harder recall, practice mode, automatic pinyin/meaning, and audio support.

card-creation card-templates quiz dictionary mobile-compatible beta

Description

Chinese Reading Add-on

Streamline your Chinese vocabulary and reading workflow in Anki. This add-on is designed to make creating and studying Chinese flashcards smoother by automating reading aids and formatting.

Features

Automatic Pinyin/Zhuyin Generation: Quickly generate phonetic readings for your vocabulary or sentence fields.
Tone Colorization: Automatically color-code your Chinese characters or pinyin by tone to boost visual memory recognition (e.g., 1st tone red, 2nd tone green, etc.).
Seamless Field Mapping: Configure which fields the add-on should read from and write to, allowing it to adapt to your existing custom note types.

How to Setup

Configure your fields: Open your card layout and ensure you have dedicated fields for your Hanzi (Chinese Characters) and/or your Reading (Pinyin/Bopomofo).
Run the Add-on: Use the add-on menu inside Anki to map your source fields to your destination fields.
Bulk Generate: (Optional) Run the generator over your existing deck to fill in missing reading data instantly.

Bug Reports & Contributing

This project is open-source! If you run into any issues, have feature requests, or want to contribute to the code, please visit the GitHub repository:

👉 Alexander-Nilsson/Chinese-Reading-Addon

README

Chinese Reading Addon

An Anki add-on for Chinese learners. Generates tone-coloured readings (pinyin, bopomofo, jyutping), simplified/traditional variants, and injects CSS/JS into card templates.

Demo reading generation

---

Features

Tone-coloured readings: Pinyin, Bopomofo, and Jyutping with configurable tone colours
Simplified/Traditional variants: Auto-generate character variants via the browser
Card template injection: Auto-injects CSS and JavaScript into card templates for tone colouring
Active Fields system: Configure which note types, card types, fields, and card sides get processed
Masked Hanzi mode: Display readings while hiding the original characters
Exportable configuration: Supports profiles for different reading workflows

Demo of all 8 display types

Configuration

Access settings via Tools → Chinese Reading Settings or through Anki's add-on config editor.

Finding the settings in Anki

Options tab

Active Fields

Configure processing rules per note type/card type/field/side via the Active Fields tab.

display_type: one of the 8 display types
note_type, card_type, field: target identifiers
side: front or back, or all
reading_type: pinyin, bopomofo, or jyutping

Active Fields tab

File References Mode

When enabled, CSS/JS are written to collection.media/ as standalone files referenced via <link>/<script src> instead of inline.

Development

uv venv --python /usr/bin/python3.14 .venv
source .venv/bin/activate
uv sync

# Run checks
python dev.py lint        # ruff linter
python dev.py typecheck   # ty type checker
python dev.py test-unit   # fast unit tests (no Anki)
python dev.py test        # full test suite (needs Anki)
python dev.py build       # .ankiaddon package
python dev.py ci          # full CI pipeline

License

GNU AGPLv3 — see LICENSE.