tnychn / opencc-extension

🀄️ A browser extension to convert webpages between different Chinese variants. Powered by OpenCC.

opencc-extension

A browser extension that converts text in the current active tab between different Chinese variants.

This extension is powered by opencc-js, which is a JavaScript API wrapper around the great OpenCC project.

Most of the variants supported by OpenCC are supported:

• cn: Simplified Chinese (Mainland China)
• hk: Traditional Chinese (Hong Kong)
• tw: Traditional Chinese (Taiwan)
  • twp: Traditional Chinese (Taiwan) with native phrases
• t: Traditional Chinese (OpenCC standard)
• jp: Japanese Shinjitai

Note

Only Chrome and Firefox are tested. Other browsers may also work but are not guaranteed to.

Features

• Minimalist user interface.
• Fast performance (using TreeWalker).
• Converts whole text on a webpage with one click.
  • Can also convert dynamically rendered text in auto mode (using MutationObserver).
• Converts selected text on a webpage in right click context menu.
• Converts any text provided in the text box in real time.
• Other features of OpenCC.
  • 嚴格區分「一簡對多繁」和「一簡對多異」。
  • 完全兼容異體字，可以實現動態替換。
  • 嚴格審校一簡對多繁詞條，原則爲「能分則不合」。
  • 支持中國大陸、臺灣、香港異體字和地區習慣用詞轉換，如「裏」「裡」、「鼠標」「滑鼠」。

See usage for more ways to convert text.

Installation

This extension will soon be available on Chrome Web Store.

Usage

Specify the language settings in the extension popup.

Origin → Target

• Origin: the original Chinese text variant in the webpage
• Target: the desired Chinese text variant to be converted into

_{Left: One Click
Right: Auto Mode}

When auto mode is enabled, a grey badge with the letter A appears on the corner of the extension icon.

All text in the webpage of the current active tab is converted whenever it loads or is updated.

Note

For performance reason, auto mode will not convert text on webpages which explicitly specify their lang attributes to be languages other than zh in their HTML documents.

_{Left: Convert Text Selection on Webpage
Right: Convert Any Text in Text Box}

Credits

• https://github.com/BYVoid/OpenCC
• https://github.com/nk2028/opencc-js

---

_{~ crafted with ♥︎ by tnychn ~
MIT © 2024 Tony Chan}