Zhenzhu

Setup and support

Get back to reading.

Need a hand? Email Minh, the developer, at nguyenducminh.dev@gmail.com.

Your first lookup

  1. Use a Mac running macOS 15 or later. Download Zhenzhu from the product page, open the disk image, and move the app to Applications.
  2. Open Zhenzhu and complete onboarding. Its controls live in the menu bar; it does not keep a permanent Dock icon.
  3. Select Chinese text in a supported app and use your configured lookup action. For text in an image or a paused video, use Snip to Translate.
  4. Inspect pinyin, definitions, and the sentence breakdown. Save useful words to local flashcards or configure the optional Anki integration.

Permissions and capture

Accessibility permission supports selected-text lookup. Screen Recording permission supports Snip to Translate and Hover Lookup. Manage these in macOS System Settings → Privacy & Security. Grant only the permissions needed for the features you use.

Selection lookup depends on what the source app exposes to macOS. If it cannot expose the text, use Snip to Translate or type or paste into Zhenzhu. Clipboard fallback is optional in Settings.

If lookup does not appear, check the configured trigger and excluded apps. If OCR is unavailable, check Screen Recording permission and your remaining monthly allowance.

Offline use and Anki

The dictionary, OCR, history, and local flashcards work on your Mac. Translation and speech depend on macOS language support and may need an initial download. First license activation, purchases, and updates require internet access.

Anki is optional. To use it, install Anki desktop and the AnkiConnect add-on, keep Anki open, and configure the integration in Zhenzhu Settings. Zhenzhu connects to Anki on your computer. You can also use the built-in flashcards without Anki.

Free and Pro

Free has no time limit and needs no sign-up. It includes unlimited dictionary lookup, sentence translation, speech, and reviews; the latest 30 history entries; one deck; and 15 new mined cards and 20 OCR reads per calendar month. The card count is shared by Zhenzhu flashcards and Anki, and a card sent to both counts once.

Zhenzhu Pro costs US$29 once and includes all future updates. It covers 3 Macs and is not a subscription. Pro 1 licenses bought earlier keep working in Zhenzhu 1.x.

Choose Buy Zhenzhu Pro in the app or on zhenzhu.app/buy to open Lemon Squeezy checkout. After purchase, use the activation link or enter your license key in License Settings. If activation fails, email your order number and purchase email privately. Do not send your full license key.

Report a problem

Email nguyenducminh.dev@gmail.com with your Zhenzhu version, macOS version, the app you were reading in, what you expected, and what happened. Include the exact error wording if available.

A short reproduction or a cropped screenshot helps. Remove private text, payment details, and license keys before sharing. For purchase or refund questions, include your order number and checkout email.

Purchases include a 14-day refund window. Email within 14 days of purchase for a full refund; no reason is required.

See the privacy notice for local storage, optional analytics, and crash-reporting details.