Skip to main content

Generate a Chinese character grid for study

Project description

This is the command line tool that generated the above chinese character study grids, and with which you can create your own study grids.

  • SVG images - great for printing, making your own chinese character poster and hanging it on your wall!
  • An interactive HTML page (using the SVG images - for study on computers or mobile devices. There’s also Javascript/JSON output which you can immediately reuse in your own applications.

The tool is fed a list of input characters (a plain text file), and it will look up each character in HSK level 1 to 6 and draw it on the grid along with additional information. This means you can use it to generate custom grids with exactly the characters you want and in the order you want.


  • Characters can be assigned a colour corresponding to the tone (1 - red, 2 - yellow, 3 - green, 4 - blue). Characters that have multiple readings, are neutral tone, or for which no pinyin could be found (if they’re not in HSK) are always shown in black.
  • HSK levels can be indicated by cell background colour (HSK1-3: white, HSK4: light grey; HSK5: yellow, HSK6: red, not in HSK: dark grey). This may act as a cue for you to skip the character until you’re proficient in the lowel levels.
  • Example words from the HSK lexicon are shown (up to two in the images). In the interactive form, click a character words in which they occur.
  • Showing pinyin on the grid is supported (but not enabled by default)
  • Pinyin ordering is supported (not enabled by default)
  • The alternative character (simlified/traditional) can be shown in the bottom-right corner of the cell.
  • You can determines the columns/rows/cell sizes.


Familiarity with Python and the command line is assumed if you want to use this tool to make your own hanzi grids, install hanzigrid using pip as follows:

pip install hanzigrid


See hanzigrid --help


The interactive page HTML outputted by this tool has to be served from a proper webserver, serving locally from file:/// will not work well!

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for hanzigrid, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size hanzigrid-0.1.tar.gz (9.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page