Hanzipopup
Popup Dictionary for Chinese Language
Port of zhongwen browser extension as UserScript for Android and iOS.
Description
A UserScript for browsers to show meaning in popup for selected Chinese characters. The UserScript uses zhongwen browser extension codes.
Highlights
- Supports both traditional and simplified characters.
- Natural Text to Speech for selected Chinese characters.
- Includes a recent version of the widely used CEDICT Chinese English dictionary.
- Displays Hanyu Pinyin along both the simplified and traditional characters, however only showing either simplified or traditional characters can be configured as an option.
- As a learning aid it uses different colors for displaying the Pinyin syllables, depending on the tone of the Chinese character.
- Can be turned on and off with a single mouse-click.
- Highlights the characters whose translation is displayed in the pop-up window.
- Also supports keyboard navigation for translating the next character, the next word, or the previous character.
- Allows you to add words to a built-in word list. Words from this list can be exported to a text file for further processing, such as importing the words into Anki.
- Includes links to grammar and usage notes on the Chinese Grammar Wiki.
Install
Note: Read installation instruction here. https://greasyfork.org
Android
Install Greasemonkey, Tampermonkey, or Violentmonkey for Firefox.
iOS
Install UserScript manager for Safari browser.
Usage
Open browser and enable extension
Download and install Hanzipopup UserScript
Download from GitHub
hanzipopup.user.js
Download from Greasy Fork
hanzipopup.user.js
Open extension and enable the UserScript
Enable Hanzipopup and click on Chinese characters to view definitions
Note: For Chrome and Firefox, use official Zhongwen extension.
Source
Source Code
Images
Technical Details
The API used to open word list and tts page. The word list store the saved words in local storage and can be used to edit the list and export as file.
The API used communicate between current page and word list or tts page. In case of word list page, words data sent from current page to word list page and stored in local storage. In case of tts, selected Chinese text sent from current page to tts page.
The meta used for getting unzipit library for extracting compressed cedict_ts.zip file.
The meta used for getting zhongwen dictionary data.
Experimental Feature
Text to speech for selected Chinese characters
To fix following error, a new window with tts.html opened and tts played in that window.
Refused to connect to 'wss://speech.platform.bing.com/consumer/speech/synthesize/readaloud/edge/v1?TrustedClientToken=
To fix following error, in opened tts.html page, a toggle button added to make sure, user should interact to the tts page before using tts in opener page.
Uncaught (in promise) DOMException: play() failed because the user didn't interact with the document first.
After tts page opened, go back to opener page click once tts icon, again come back to opener pager.
Issues
For issues and help,
https://github.com/krmanik/hanzipopup/issues
License
- krmanik
- GPL-2.0 Copyright (C) 2024
- Read more License
