Obsidian Stats logoObsidian Stats

AI Translation Assistant

by Taoye
5
4
3
2
1
Score: 50/100
Install Code

Description

Translate text and Markdown documents in Obsidian, understand vocabulary in context, and save bilingual notes with AI.

Reviews

No reviews yet.

Stats

0
stars
34
downloads
0
forks
4
days
4
days
4
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
10
commits

Latest Version

1.1.0
5 days ago

Changelog

Translate words and passages directly in Obsidian’s desktop Web Viewer, using the same selection gesture and language settings as your notes and PDFs.

  • Enable the Web viewer core plugin, then hold Cmd/Ctrl while selecting webpage text (or disable the modifier requirement in settings).
  • Use the popup’s Refine translation action for your configured AI backend.
  • Updated all seven README languages and the demo index, now with 13 feature demos.

Translate directly in Web Viewer

Watch the MP4 · English subtitles

The recording uses real Obsidian and actual translation results; it is silent, with waiting time shortened. Main-page text is supported; editable fields and cross-origin iframe selections are excluded. Initial online translations can use Google independently of the AI backend.

Requires desktop Obsidian 1.13.7 or later. Update through Settings → Community plugins → Check for updates, or use the three plugin files attached below. Your existing plugin settings are preserved.

Validation: 56 unit tests per product, 9 Obsidian integration tests across both public plugins, and two real-provider recording scenarios passed.

中文：新增 Web Viewer 网页划词翻译；README 已补齐用法、限制及真实录屏（GIF、MP4、英文字幕）。

See all version on GitHub

README file from

Github

AI Translation Assistant

Understand words in context, translate passages and keep bilingual notes inside Obsidian. Work with Markdown and selectable PDF text without copying everything into a separate chat app.

English · 简体中文 · 日本語 · 한국어 · Español · Français · Deutsch

See it in action

One complete walkthrough covers all 13 features, including Web Viewer translation. Individual instructions and recordings are in the feature directory.

Complete feature walkthrough

Full video guide · Feature directory

What you can do

  • Translate selected words and passages in Markdown, selectable PDF text or Web Viewer webpages.
  • Get vocabulary explanations that use the surrounding context.
  • Keep the original text and insert a translation underneath.
  • Translate one Markdown note or multiple notes, appended or interleaved.
  • Collect excerpts with translations in a note of your choice.
  • Listen to selected text with adjustable language and reading speed.

Install

Desktop Obsidian 1.13.7 or later is required. Mobile is not supported.

  1. Open Settings → Community plugins in Obsidian and enable community plugins if prompted.
  2. Click Browse and search for AI Translation Assistant.
  3. Click Install, then Enable.
  4. Open the plugin’s settings to choose your language and AI service.

Translate your first passage

  1. Configure AI below and choose Learning / target language.
  2. Select text in a note, then run Translate selected text from the command palette.
  3. For a popup while reading, keep Auto translate selection enabled and hold Command on macOS or Ctrl on Windows/Linux while selecting. You can change this requirement in settings.
  4. Select a word to see its meaning and request an AI explanation in context. PDF text must be selectable; scanned pages need OCR first.

Set up AI

Open this plugin’s settings and choose AI backend. For OpenAI or Anthropic, enter your own API key. API usage is billed by that provider. For local Codex or Claude Code, install and sign in to that application first; set Codex command or Claude command if it is not found automatically. Local CLI use can still send your content to its AI provider.

Start with Automatic · Economy for supported lightweight models. It caches selections for one hour and never automatically upgrades to a flagship model. Use Manual to choose a specific model; custom API base URLs require Manual mode. If using an API, run Test API connection.

Keep a useful note

Use Insert translation below selected text to retain the original passage. For a whole Markdown note, choose the command that appends a translation or interleaves it with the original. Batch commands work with multiple Markdown files. These commands modify your notes, so try them on a copy first.

Use Save selected text to excerpt note to collect passages. Choose Excerpt file, whether to include the translation, and whether to open it after saving. Read selected text aloud uses the configured speech language and rate.

Privacy and common questions

Translation and AI explanations send the selected text and relevant context—or document chunks for full-file translation—to your chosen provider. Basic online dictionary/translation lookup can contact Google independently of the AI backend. Automatic selection translation runs when its configured gesture is triggered; disable Auto translate selection to use commands only.

If a selection does nothing, check the modifier-key setting or use the command palette. If PDF text cannot be selected, apply OCR first. For large documents, allow more time or adjust Batch chunk size and Timeout.

API keys are saved in this plugin’s settings in your vault. Keep those settings private, including when sharing or syncing your vault. If AI fails, check the selected backend, login/API key and model; quota or network errors do not cause an automatic model switch.

For YouTube/local playback, subtitles and screenshot notes, use Video Player (AI integrated).

Help

Report a problem on GitHub Issues; include the plugin version and error message, but never an API key or private notes.

Local AI integrations also read the CLI’s model catalog and use its existing login in your user directory. The plugin does not install these tools for you.

MIT License · © 2026 Taoye

Sponsors