char-converter

Chinese Character Variant Converter,

an open-source library for converting Chinese character variants to standard simplified or traditional characters.

* About the project's name and logo: "CHAR" comes from "Chinese character variant" and also refers to a type of beautiful fish with a gradient of red color (Arctic Char).

Online Demo

Char Converter Demo

News

2024-11-15: npm package for JavaScript has been released.

Python

Install

pip install char-converter

Update

Important Note: We have been checking and updating the data from time to time. Please run the following command to ensure the package is the latest version before using it to handle important mateirals every time.

pip install char-converter -U

Usage

Convert text

• Mode: one2one

from char_converter import CharConverter

text = '苟馀情其訫姱㠯练要兮，镸顑頷亦何伤。'

converter = CharConverter('v2t')
converted_text = converter.convert(text)
# 苟餘情其信姱以練要兮，長顑頷亦何傷。

converter = CharConverter('v2s')
converted_text = converter.convert(text)
# 苟余情其信姱以练要兮，长顑颔亦何伤。

• Mode: one2many

from char_converter import CharConverter

text = '鈡𩄇毓秀'

converter = CharConverter('v2t')
converter.set_mode('one2many')
converted_text = converter.convert(text)
# 【鍾|鐘】靈毓秀

Convert file

from char_converter import CharConverter

converter = CharConverter('v2s')
converter.convert_file(input_file, output_file)

HTML

<script src="https://unpkg.com/char_converter@latest/dist/bundle.js"></script>
<script>
  const CharConverterClass = CharConverter.default;

  const converter = new CharConverterClass('v2t', 'offline');
  converter.setMode('one2many');

  async function testConversion() {
    const result = await converter.convert('鈡𩄇毓秀');
    console.log(result);
  }

  testConversion();
</script>

JavaScript

Install

npm install char_converter

Update

Important Note: We have been checking and updating the data from time to time. When initializing the converter, two options ("online" and "offline") are both available. If choosing "online", the data will be retrieved directly from the updated online source. If choosing "offline", please run the following command to ensure the package is the latest version regularly to check if the data is up-to-date.

npm install char_converter@latest

Usage

Convert text

• Mode: one2one

const CharConverter = require('char_converter');

const text = '苟馀情其訫姱㠯练要兮，镸顑頷亦何伤。';

const converter = new CharConverter('v2t', source = 'online'); // Variant to Traditional
converter.setMode('one2one');
const convertedText = converter.convert(text);
console.log(convertedText); // 苟餘情其信姱以練要兮，長顑頷亦何傷。

const converter = new CharConverter('v2s', source = 'online'); // Variant to Simplified
converter.setMode('one2one');
const convertedText = converter.convert(text);
console.log(convertedText); // 苟余情其信姱以练要兮，长顑颔亦何伤。

• Mode: one2many

const CharConverter = require('char_converter');

const text = '鈡𩄇毓秀'

const converter = new CharConverter('v2t', source = 'online'); // Variant to Traditional
converter.setMode('one2many');
const convertedText = converter.convert(text);
console.log(convertedText); // 【鍾|鐘】靈毓秀

Data source

CBDB Project

OpenCC

Dictionary of Variant Chinese Characters

General Standard Chinese Characters Table

Data filtering

Contributors

Yuqi Chen (data collection and programming)

Hongsu Wang (project manager)

Yiyi Wang (proofreading)

Fengyi Ji (data collection)

Kaini Xiong (proofreading)

License