Zotero Pdf Translate GuideCAUTION

🔬 A curated collection of 23,000+ agent skills for empirical research across 8 social science disciplines. | 精选 23,000+ AI Agent 技能库,覆盖8大社会科学学科的实证研究。CoPaper.AI 20分钟完成一篇可复现的规范实证论文,并支持用户上传 Skills。-- Maintained by CoPaper.AI from Stanford REAP.

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: zotero-pdf-translate-guide
description: "Guide to Zotero PDF Translate for multilingual PDF and annotation translation"
metadata:
  openclaw:
    emoji: "🌐"
    category: "tools"
    subcategory: "ocr-translate"
    keywords: ["zotero", "pdf-translate", "multilingual", "annotation", "academic-translation"]
    source: "https://github.com/windingwind/zotero-pdf-translate"
---

# Zotero PDF Translate Guide

## Overview

Zotero PDF Translate is one of the most popular Zotero plugins with over 10,000 stars on GitHub, providing seamless translation capabilities directly within the Zotero PDF reader. It enables researchers to translate selected text, annotations, metadata, and even entire pages without leaving their reference management workflow.

The plugin supports a wide range of translation engines including Google Translate, DeepL, Microsoft Translator, OpenAI, and numerous other services. This flexibility allows researchers to choose the engine that best suits their language pair, domain, and accuracy requirements. For academic work involving technical terminology, the ability to switch between engines or use specialized services is invaluable.

Zotero PDF Translate goes beyond simple text translation. It handles EPub documents, web pages saved to Zotero, item metadata fields, and annotation notes. This makes it an essential tool for any researcher who regularly reads papers in languages other than their primary working language, or who collaborates across linguistic boundaries.

## Installation and Setup

Install Zotero PDF Translate through the Zotero Add-ons Manager:

1. Download the latest `.xpi` file from the GitHub releases page at https://github.com/windingwind/zotero-pdf-translate/releases
2. In Zotero, navigate to Tools > Add-ons > gear icon > Install Add-on From File
3. Select the downloaded `.xpi` file and restart Zotero when prompted

After installation, configure your preferred translation engines:

- Open Zotero Preferences > PDF Translate
- Select your primary translation engine from the dropdown
- For engines requiring API access, set your credentials via environment variables:
  - DeepL: configure `$DEEPL_API_KEY` in your environment
  - OpenAI: configure `$OPENAI_API_KEY` in your environment
  - Microsoft: configure `$AZURE_TRANSLATOR_KEY` in your environment
- Set your source and target languages
- Configure auto-translate behavior (on selection, on annotation, etc.)

For best results with academic content, consider using DeepL or OpenAI-based translation, as these engines generally handle technical vocabulary and complex sentence structures better than basic machine translation services.

## Core Features

**In-Reader Translation**: Select any text in the Zotero PDF reader and the translation appears instantly in a sidebar panel. The original and translated text are displayed side by side, making it easy to verify accuracy and understand context.

**Annotation Translation**: When you highlight text and create annotations, Zotero PDF Translate can automatically translate the annotation content. This is particularly useful when building a collection of notes from foreign-language papers, as your annotation library remains in your working language.

**Metadata Translation**: Translate item titles, abstracts, and other metadata fields directly within your Zotero library. This helps when organizing a large collection that includes papers from multiple languages, making search and browsing more efficient.

**Multiple Engine Support**: The plugin supports over 15 translation engines:
- Free engines: Google Translate, Bing, Yandex, LibreTranslate
- Premium engines: DeepL, OpenAI GPT, Azure Translator
- Chinese-specialized: Baidu, Tencent, Youdao, Caiyun
- Academic: CNKI translation services

**Batch Translation**: Translate multiple items or annotations at once rather than processing them one by one. This is essential when processing a large reading list of foreign-language papers.

**Custom Dictionaries**: Define custom term mappings to ensure domain-specific terminology is translated consistently. For example, you can map technical terms in your field to their correct translations rather than relying on generic machine translation.

## Academic Workflow Integration

A typical multilingual research workflow with Zotero PDF Translate involves several stages:

**Literature Discovery**: When you encounter papers in unfamiliar languages through citation tracking or database searches, add them to Zotero normally. Use metadata translation to translate titles and abstracts, helping you triage which papers deserve full reading.

**Deep Reading**: Open a foreign-language PDF in the Zotero reader. As you read, select passages for instant translation. For particularly important sections, create annotations that automatically include both the original text and translation.

**Note Compilation**: After reading, your Zotero annotations contain bilingual notes. Export these to your note-taking system with both original quotes and translations preserved, ensuring you can always trace back to the source text.

**Collaborative Research**: When working with international collaborators, use batch translation to prepare shared reading lists with translated metadata, making it easier for team members to navigate references outside their language expertise.

**Configuration Tips for Researchers**:
- Set keyboard shortcuts for quick translation toggling
- Enable auto-translate on text selection for fluid reading
- Configure fallback engines in case the primary service is unavailable
- Use custom dictionaries for your specific research domain terminology

## Troubleshooting Common Issues

**Translation Not Appearing**: Ensure the plugin is enabled in Tools > Add-ons. Check that your selected translation engine is properly configured and that any required API keys are set in environment variables.

**Slow Translation Speed**: Some engines have rate limits. If translation is slow, try switch

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (1)

- For engines requiring API access, set your credentials via environment variables:

Gates applied: no_behavioural_pass.