Hanzi Studio

A modern Chinese character learning application built with Pygame + Tkinter

Overview

Hanzi Studio is a powerful Chinese character learning application designed for learners of Chinese. It combines modern UI design, smart learning algorithms, and a rich character database to deliver a comprehensive Chinese learning experience.

The application uses Pygame as the main graphics engine, Tkinter for information display windows, SQLite3 for storing learning data, and integrates Windows SAPI for character pronunciation.

Key Features

Data Scale

16,863+
Chinese characters (including radicals)

The database includes pinyin, word formation, strokes, and more. Database size is approximately 68 MB.

Main Features

Character Learning

Learn three characters per day with classic text mode. Smart cross-text learning with no duplicates.

Pinyin Learning

Automatic pinyin with numeric tone to tone-mark conversion. Integrated text-to-speech.

Stroke Learning

Based on Make Me a Hanzi data: accurate stroke order and SVG path tracing animation.

Word Formation

Character compounds from the database with click-to-play audio for better vocabulary retention.

Tracing Practice

Automatic tracing animation with configurable repeat count and interval for correct writing.

Learning Records

Hierarchical learning history organized by year/month/day for easy review.

Review

Grid view of learned characters with pinyin playback and detail view.

Quiz System

Auto-generated 20-question quizzes: multiple choice, multi-select, and audio recognition.

Print

Generate grid practice sheets with optional handwritten stroke saving for offline practice.

Technical Architecture

Core Tech Stack

Pygame Tkinter SQLite3 Windows SAPI gTTS (optional) PIL/Pillow pywin32 pypinyin

Software Highlights

Smart Learning System

Automatically avoids relearning known characters; cross-text learning with deduplication and per-text progress.

Data Management

SQLite database with 16,863+ characters: strokes, pinyin, word formation. Database size ~68 MB.

User Interface

Modern, responsive layout with clear information and simple, intuitive controls.

Speech Playback

Windows SAPI for local TTS, optional gTTS for online; hybrid playback with automatic fallback.

User Guide

Basic Operations

  1. Select a text - Click a classic text name in the left sidebar
  2. Learn characters - The app picks three non-repeating characters to learn
  3. Switch characters - Use left/right arrow keys or click the left/right circular areas
  4. Play pronunciation - Click the center circular area to hear the current character
  5. Tracing - Click “Start tracing” to watch the stroke animation
  6. Finish learning - Click “Complete learning” to save your progress

Advanced Features

Use Cases

Children's character introduction Adult character learning Teaching Chinese as a foreign language Character culture enthusiasts Calligraphy practice aid

Installation & Running

System Requirements

Running the Application

Portable: no installation required, run directly.

Note: On first run, the database and required data files will be created automatically.

Try Hanzi Studio Now

Start your Chinese character learning journey with a smart, efficient approach

Current version: 1.0.0 | Release: 2025