# BYVoid/OpenCC

Library for conversion between Traditional and Simplified Chinese

Repository: https://github.com/BYVoid/OpenCC
Canonical: https://ross.abutalabs.com/products/opencc
Homepage: https://opencc.byvoid.com/
Language: C++
License: Apache-2.0
License Family: permissive
Topics: chinese-translation, traditional-chinese, simplified-chinese, chinese, chinese-conversion
Last push: 2026-08-26T04:41:40+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 87, longevity 100
- inputs: {"age_days": 5893, "days_push": 7, "days_rel": 11, "gap_med": 31.0, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 9942, forks 1062 (observed 2026-08-28T04:10:38.900127+00:00)

## What it is
OpenCC is an open-source C++ library and toolset for high-quality, deterministic conversion between Traditional Chinese, Simplified Chinese, Japanese Shinjitai, and regional wording across Mainland China, Taiwan, and Hong Kong. It uses decoupled, extensible dictionaries with phrase-level and variant-aware rules, and ships bindings for Python and Node.js plus CLI tools.

## Use cases
- convert simplified Chinese text to traditional Chinese
- convert traditional Chinese to simplified with Taiwan or Hong Kong regional wording
- handle one-to-many simplified-to-traditional character mappings correctly
- convert Chinese text offline without LLMs
- customize Chinese conversion dictionaries for a project
- convert Japanese Shinjitai kanji to Chinese variants

## When to choose
- you need predictable, auditable, dictionary-based Chinese conversion rather than machine translation
- you need phrase-level and regional vocabulary conversion (e.g. 鼠标/滑鼠) across Mainland, Taiwan, and Hong Kong conventions
- you need offline, fast conversion with bindings for C++, Python, or Node.js
- you want to extend or replace conversion dictionaries with your own rules

## When to avoid
- you need translation between Chinese languages such as Mandarin and Cantonese
- you need general machine translation between Chinese and other languages
- you need fuzzy or context-based translation rather than deterministic rule-based conversion

## Facets
- artifact type: library
- maturity: stable
- function: nlp, parser, cli, sdk
- domain: developer-tools, cross-platform
- platform: cpp, python, cross-platform, cli, windows
- tags: chinese-conversion, simplified-chinese, traditional-chinese, dictionary-based, offline, regional-vocabulary, japanese-shinjitai, natural-language-processing, localization, nodejs, macos, linux

## Member repositories
- BYVoid/OpenCC (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:38.900127+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:20:17.212242+00:00, confidence not recorded.
  - readme: https://github.com/BYVoid/OpenCC (fetched 2026-08-28T04:10:38.900127+00:00, sha afe02e45864a)
  - homepage: https://opencc.byvoid.com/ (fetched 2026-08-29T08:20:00.798322+00:00, sha 24f08d37b8a2)
  - site_page: https://opencc.byvoid.com/docs (fetched 2026-08-29T08:20:00.807612+00:00, sha 4e3bb3f5a492)
  - site_page: https://opencc.byvoid.com/1.4.0 (fetched 2026-08-29T08:20:00.809620+00:00, sha 87c3517bc7f6)
- Data as of 2026-08-30T08:39:29.467469+00:00.
