Chinese Character Relations - related words & hanzi components on review

AnkiWeb addon 1076075855

Displays related words from chosen decks that share characters with the reviewed card, plus offline character decomposition with pinyin and hover glosses, linking related notes to the Browser.
AI-generated summary; may contain mistakes.

review-flowsearchappearancedictionary

Open on AnkiWeb GitHub Find alternatives

AnkiWeb

Votes
3 (👍 3 · 👎 0)
Updated
2026-09-07
Anki versions
25.02.5~
License
MIT (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
JSON, Python
Description language
en

Maintenance

active

  • Last update or commit: 2026-09-07 (55 days before the snapshot).
  • Test files: 4.
  • Commits in the last year: 15.
  • Issues: 0 open, 0 closed.
  • Pull requests: 0 open, 0 merged.

Will it work on my Anki?

Version branches
Min AnkiMax AnkiUpdated
23.1025.02.5+2026-09-07
History across monthly snapshots

Loading…

Similar addons

Chinese Word Synonyms

Shows offline synonyms from your own collection on Chinese review cards as known/total counts on the front and a clickable synonyms panel on the back.

searchdictionary

1 votes 21% approval 👍 1 · 👎 0 ⭐ 1 Anki 25.09.2~ Updated 2026-09-07

Description

Anki desktop add-on for Chinese study: on the answer side, a Relatives panel shows words from your own decks that share characters with the card, plus optional character decomposition (components + pinyin, offline).

Related words (your collection)

  • Indexed from decks you choose; shares a hanzi with the word you are reviewing (current word never listed).
  • Multi-character words (e.g. 奶茶) get one group per character, each with its own horizontal list.
  • Optional pinyin above relatives when your note has a Pinyin field configured.
  • Click a related word to open that note in the Browser.
  • Colors: green = mature, default = learning, red = suspended (if enabled in settings).

Character components (bundled data)

  • Per character: decomposition row (e.g. 奶 → 女 乃) with pinyin on each piece.
  • Hover a character or component for a short English gloss (make-me-a-hanzi data, MIT). Offline — no web requests.
  • Toggle under Tools → Chinese Character Relations… → General → Show character components.
  • If there are no deck relatives but decomposition exists, you still see the component row.

First-time setup

  1. Restart Anki after install.
  2. Tools → Chinese Character Relations…
  3. General: set Word/Hanzi (and optional Pinyin) fields to match your note type, pick decks to scan.
  4. Click Rebuild Index (required after deck or field changes).

Defaults assume fields named Word and Pinyin. Many decks use Hanzi or Expression — set those on the General tab. Customize panel width, fonts, and colors on the Appearance tab.

Requirements: Anki Desktop 23.10+ (Qt6). macOS, Windows, Linux.

Dark mode · Light mode

Settings — General · Settings — Appearance

Support & source

  • Bugs: GitHub Issues
  • Source & releases: GitHub
  • License: MIT. Decomposition data from make-me-a-hanzi (MIT).

README

Chinese Character Relations

Anki desktop add-on for reviewing Chinese: related words from your own deck plus character decomposition on the answer side.

What you see during review

Flip to the answer. Below your card, a Relatives panel appears when there is something to show.

Related words (your collection)

Words from your indexed decks that share a character with the card you are reviewing. The current word is never listed.

  • Single character (e.g. 好) → one group of relatives containing 好.
  • Multi-character word (e.g. 奶茶) → one group per character (奶, 茶), each with its own horizontal list of related words.
  • Pinyin appears above each related word when your note has a Pinyin field configured.
  • Click a related word to open that note in the Browser.
  • Green = mature cards, default color = learning, red = suspended (when included in settings).

Character components (bundled data)

For each character in the word, a decomposition row sits above that character’s relatives:

奶 → 女 乃 with pinyin above each piece (head character and components).

  • Hover (desktop) a character or component to see a short English gloss from bundled make-me-a-hanzi data (MIT). Nothing is shown at rest, so the row stays compact.
  • Works offline; no website calls.
  • If a character has no decomposition in the data, you still get relatives when your deck has matches.
  • If a character has only decomposition and no relatives in your deck, you still get that character’s row (components only).

Example from the screenshots: 奶茶 shows 奶 → 女 乃 and 茶 → 艹 人 木, each with deck relatives underneath.

Screenshots

Dark mode

Relatives panel with components (dark mode)

Light mode

Relatives panel with components (light mode)

Requirements

  • Anki Desktop 23.10+ (Qt6 preferred)
  • macOS, Windows, or Linux

Install

From AnkiWeb (recommended)

  1. In Anki: Tools → Add-ons → Get Add-ons…
  2. Enter add-on code 1076075855 → OK, then restart when prompted.
  3. Or open the AnkiWeb listing and download from there.
  4. Open Tools → Chinese Character Relations… → General → set fields → Rebuild Index.

From GitHub

  1. Open the latest Release.
  2. Download the .ankiaddon asset (e.g. chinese_char_relations-0.2.2.ankiaddon), not Source code.
  3. Double-click the file, or open it with Anki / drag it onto the Anki window.
  4. Restart Anki when prompted.
  5. Open Tools → Chinese Character Relations…
  6. On the General tab, set your Word / Hanzi (and optional Pinyin) fields, then click Rebuild Index.

Manual (developers)

Copy the chinese_char_relations folder into your Anki add-ons folder, then restart Anki:

  • macOS: ~/Library/Application Support/Anki2/addons21/
  • Windows: %APPDATA%\Anki2\addons21\
  • Linux: ~/.local/share/Anki2/addons21/

Settings

Tools → Chinese Character Relations… (or Tools → Add-ons → Config):

Tab What it’s for
General Scan decks, show-in decks, fields, relatives limits, Show character components, Rebuild Index
Appearance Panel width, type sizes, colors, optional custom CSS
About Version, changelog, data credit, links

General tab (quick reference)

Setting What it does
Decks to scan Which decks feed the related words index (empty = all decks)
Show panel in Which decks show the Relatives panel (default = same as scan)
Word / Hanzi, Pinyin Fields used for indexing and display
Max per character Cap on related words per character group
Min word length Skip very short related candidates
Include suspended Show relatives from fully suspended notes
Show only on back Relatives + components on answer only (default)
Show character components Turn decomposition row on or off (no rebuild)
Rebuild Index Required after changing decks or word field

Rebuild after scan-deck or field changes. Show panel in, Appearance, and Show character components apply on the next card flip.

Defaults assume Word and Pinyin. If your deck uses Hanzi, Expression, etc., set those on the General tab.

Tips

  • Hover component tiles on the answer side for English meanings (macOS: trackpad or mouse over the hanzi).
  • Components use per-character dictionary entries, not whole-word definitions for compounds.
  • If the panel never appears, check field names and Rebuild Index; if a character has no relatives and no decomposition data, that group is omitted.
  • Customize colors and sizes under Appearance; target .char-relations, .char-relations-decomp, etc. in custom CSS.

Support

Maintainer docs: docs/MAINTENANCE.md · QA: docs/TESTING.md · Config reference: chinese_char_relations/config.md

License

MIT — see LICENSE. Character decomposition data derived from make-me-a-hanzi (MIT).