Plugins / Translation

Codex Bilingual Reader

by Mengqi97 · github.com/Mengqi97/codex-bilingual-reader-for-zotero

Turns a PDF into a layout-preserving English and Chinese bilingual PDF using the local Codex CLI or an OpenAI-compatible API such as OpenAI or DeepSeek.

Codex Bilingual Reader has a Zotero Plugins grade of B (use with care) because it launches programs on your computer. It works with Zotero 7–9, not the current Zotero 10. Last checked 15 Nov 2026.

View source
Downloads a .xpi file (0.07 MB). In Zotero, open Tools → Plugins and install it from the file.
In useAn estimate of how many copies of Zotero have it: Zotero downloads each new version once for every copy that has the plugin, so we count the downloads of its most-downloaded recent release. Rounded. Plugins that update from outside GitHub count low.
1k
DownloadsAll-time downloads of its release files from GitHub, counting every update. Installs from elsewhere aren't counted.
1,036
Latest releaseDownloads of version 1.4.5, its latest release, since it came out on 17 Aug 2026. A new release starts from zero; Downloads counts every release.
1,005
ReleasesVersions published on GitHub. Everyone who has the plugin downloads each one again, which adds up in Downloads.
3
AgeTime since its GitHub repository was created, on 17 Aug 2026. The plugin can be younger than its repository.
3 months
StarsPeople who starred the repository on GitHub: a rough measure of interest.
24
ContributorsPeople who have committed code to this plugin. Bots don't count, nor do the authors of a template or project it was copied from.
1
LicenceThe licence the code is published under, as GitHub reports it.
MIT
B
Zotero Plugins gradeUse with care
because it launches programs on your computer
Applies to v1.4.5, released 17 Aug 2026Code checked · tested installed in Zotero 9.0.6 on 27 Sep 2026
Doesn't work with the current Zotero (10)Works with Zotero 7, 8, 9.
Another plugin uses the same ID2 other plugins share this add-on ID. Zotero can only install one of them.
What we found in the codeSets the gradeThe worst finding in these three areas sets the grade.
Code transparencyReadable code; not yet checked against the published sourceThe developer uploaded the release file from the Mengqi97 account. We haven't yet checked whether this file matches the public source code.UnknownWe couldn't check this yet.
Updates
Updates come from this project's GitHub repositoryThe update address offers this version
Where your data goesOnly contacts services we could identify11 addresses in 4 groups.LowLow concern: normal for plugins that do this job. Listed so you know.
AI services (5)
Codex CLI (OpenAI)api.deepseek.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.api.openai.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.dashscope.aliyuncs.comnamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.openrouter.ainamed in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Translation (3)
BabelDOC (the AI provider it's set up with)pdf2zh (Google Translate, or the translator it's set up with)pdf2zh-next (SiliconFlow, or the engine it's set up with)
Code hosting (2)
github.comnodejs.org
On your computer (1)
127.0.0.1named in its codeThe address is in its code, but we didn't trace a request to it. It may be a link or unused.
Where we found it
github.comcontent/runtime/install-preserved-pdf-runtime.ps1 · line 10
$engineUrl = "https://github.com/PDFMathTranslate-next/PDFMathTranslate-next/releases/download/v2.9.0/pdf2zh-v2.9.0-BabelDOC-v0.6.4-with-assets-win64.zip"
nodejs.orgcontent/runtime/install-preserved-pdf-runtime.ps1 · line 12
$nodeUrl = "https://nodejs.org/dist/v24.19.0/win-x64/node.exe"
Powerful capabilitiesLaunches programs on your computer, and 4 moreMediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Medium concern (1)
Launches programs on your computer
Low concern (4)
Uses the clipboardStores API keys or passwordsDownloads and runs a PDF translation engine (about 600 MB) when you press install, on WindowsWorks with files on your computer
Where we found it
Launches programs on your computerbootstrap.js · line 4

Programs it names include cmd, codex, codex.cmd, powershell, pythonw

"resource://gre/modules/Subprocess.sys.mjs",
Downloads and runs a PDF translation engine (about 600 MB) when you …content/runtime/install-preserved-pdf-runtime.ps1 · line 38

It checks the download against a fingerprint written into the plugin, so only a new version of the plugin can change what runs. The download comes from the PDFMathTranslate-next project and Node.js, who make them. On Windows, when you press the one-click install button in its settings (its label gives the size), it downloads the PDFMathTranslate-next engine (621 MB), and Node.js (93 MB) if you don't have it, and later runs them to translate PDFs; the README describes the download. We checked that both fingerprints match the files their makers publish.

$curl = [IO.Path]::Combine($env:SystemRoot, "System32", "curl.exe")
Before you installShown, not gradedFacts to help you decide. They don't change the grade.
Works withZotero 7, 8, 9 · not 10Doesn't work with the current Zotero (10)MediumMedium concern: worth reading before you install. One medium finding makes the grade B.
Zotero 7 ✓ worksZotero 8 ✓ worksZotero 9 ✓ worksZotero 10 ✗ doesn't workZotero 11 beta not tested yet: Zotero hasn't opened Zotero 11 testing
What you'll needAn API keyDetected automatically from its code
No further detail for this area yet.
MaintenanceActive · last release 17 Aug 20261 contributor
No further detail for this area yet.
LanguagesDocumentation in English and ChineseInterface: English and Chinese
No further detail for this area yet.
We report what we found in the code. Open any area for the evidence.How we gradeReport a problem

What it does

Written by AI from the README

Turns a PDF into a layout-preserving English and Chinese bilingual PDF using the local Codex CLI or an OpenAI-compatible API such as OpenAI or DeepSeek. Supports batch queues, cost tracking, and imports the result next to the original. Paper text goes to your chosen provider.

Reading English papers in Chinese usually loses figures, formulas and tables. This keeps them in place. Windows setup downloads a separate engine of about 600 MB.

What you'll need

Detected automatically
  • An API keyNeeds a key you get from the service (OpenAI (Codex CLI login or API key), DeepSeek, OpenRouter and Alibaba Qwen (DashScope)). What needs it: Either a local Codex CLI login (default backend) or an API key for OpenAI, DeepSeek or another provider.
  • Or: a model on your own computerIt can use a local model such as Ollama
  • Zotero 7, 8, 9Not working with Zotero 10

Where your data goes

We found: only contacts services we could identify. 11 addresses in 4 groups.

AI services (5)
Codex CLI (OpenAI)api.deepseek.comnamed in its codeapi.openai.comnamed in its codedashscope.aliyuncs.comnamed in its codeopenrouter.ainamed in its code
Translation (3)
BabelDOC (the AI provider it's set up with)pdf2zh (Google Translate, or the translator it's set up with)pdf2zh-next (SiliconFlow, or the engine it's set up with)
Code hosting (2)
github.comnodejs.org
On your computer (1)
127.0.0.1named in its code
Evidence · file and line
github.comcontent/runtime/install-preserved-pdf-runtime.ps1 · line 10
$engineUrl = "https://github.com/PDFMathTranslate-next/PDFMathTranslate-next/releases/download/v2.9.0/pdf2zh-v2.9.0-BabelDOC-v0.6.4-with-assets-win64.zip"
nodejs.orgcontent/runtime/install-preserved-pdf-runtime.ps1 · line 12
$nodeUrl = "https://nodejs.org/dist/v24.19.0/win-x64/node.exe"

Other plugins that do this

Matched on what they do

For the same job, work with Zotero 10 and graded B or better. Closest match first.

  • A
    PaperMirror 文镜 for Zotero

    Shows a translated page next to the original in Zotero's PDF reader, with figures, tables and formulas kept in place and only the body text re-flowed.

    Matches “chinese english reading” · 299 downloads · Active · Zotero 9–10
    Works with Zotero 10
  • A+
    Zotero Bilingual PDF

    Batch-translates English papers into side-by-side English and Chinese PDFs and saves them as child attachments.

    Matches “translate pdf to bilingual” · 118 downloads · Active · Zotero 9–10
    Works with Zotero 10
Compare all 3 side by side
How we pick these

By how closely what they do matches this plugin, using descriptions and the phrases people search with. Copies and forks of this plugin are listed under Forks and copies instead. No plugin pays to appear here.

Forks and copies

2 other plugins use the same ID as this one. Every Zotero plugin carries an ID, a name tag Zotero uses to tell plugins apart. These 3 plugins carry the same one, because people copied Codex Bilingual Reader to make their own versions and kept its ID.Show what this means
  • You can only have one. Zotero sees them as the same plugin.
  • Installing another replaces it. If you install one of the others, it takes this one's place.
  • Check what you install. Several share this plugin's name, so make sure the file comes from the one you meant.
Codex Bilingual Reader · this pluginMengqi97/codex-bilingual-reader-for-zoteroBUse with care1,03617 Aug 2026
Codex Bilingual ReaderCopy · fangchenghao/codex-bilingual-readerCNot recommended1821 Oct 2026
See all 3 and how they differ →

1 listed fork.

The developer's response

The developer hasn't responded. Developers can reply here, and their reply sits next to our findings.I'm the developer

Ratings and reviews

What people who use it say. This is separate from the grade, which is what the code does, and never changes it.

No ratings yet.

Write a review
Your rating of Codex Bilingual Reader v1.4.5

Your review is public, under the name you give, and published with the directory's data under CC BY 4.0. Links are removed. We never store your IP address: a scrambled code made from it is kept for 30 days to catch fake reviews. Every review is checked before it's published; how fake ones are spotted isn't published, so it can't be gamed.

Install Codex Bilingual Reader
BUse with care
Before you install: It launches programs on your computer.Read the finding
Compare with similar plugins