FAQ

Frequently Asked Questions.

Search the manual or browse common answers by topic.

Setup

Setup and accounts

Do I need an API key?

Yes for cloud translation. Gemini is the recommended first provider for most beta testers. Use the Gemini API key guide to create and test a key.

Are API keys backed up or published?

No. Provider keys are stored in platform secure storage and are excluded from backups, exports, support forms, and Global Library submissions.

Which interface profile should I choose?

Choose Personal study for simple learning, Teacher for summaries and handouts, Research/editing for comparison and terminology, Publication for export work, and Library station for shared devices.

Translation

Translation and OCR

What is the difference between OCR and translation?

OCR reads text from an image or PDF. Translation turns source content into the selected output language. The app can use separate providers, models, and templates for each stage.

Can I translate a whole project at once?

Yes. Use Translate whole project or selected-page batch translation. Already completed pages are skipped unless you choose to retranslate them.

Why does a page say failed?

A provider request, OCR step, save verification, cache write, or validation check may have failed. Open the page or batch sheet, read the message, then retry, change provider, or re-import the page if the image is damaged.

Does Local Gemma replace cloud translation?

No. Local Gemma is Offline Beta. It is useful for privacy/offline experiments, but cloud translation remains the recommended quality path for difficult Torah and Chassidus material.

PDFs and corpus

Import, corpus browsing, and exports

Why does PDF import limit me to 15 pages?

The limit prevents accidental large jobs. Advanced users can enable full-PDF import when they intentionally need the entire file.

What if the corpus catalog is missing?

Mobile builds need a configured/published compact catalog. Sync the local mirror or publish the Cloudflare catalog, then refresh the corpus screen.

Can I export the whole project?

Yes. Use project export actions for Reader PDF, Study Reader PDF, Markdown, DOCX, ZIP, and review formats when enabled.

Why was Reader PDF export blocked?

The export preflight may have detected missing translations, possible wrong content, partial nikud, source/translation mismatch, corrupt notes, unresolved sources, or layout risks. Review and resolve the warnings before sharing.

Study tools

Reader, Word Lens, summaries, and terminology

What is Word Lens?

Word Lens lets you tap a source-language word and see context, transliteration, likely meaning, and local or AI-assisted notes without changing the translation.

What is Study Transliteration?

Study Transliteration shows source text, learner transliteration, and translation together so English-speaking learners can follow Hebrew or Yiddish more easily.

What is the difference between glossary and pronunciation?

Glossary affects visible preferred translations. Pronunciation affects read-aloud speech only. Transliteration affects visible learner output.

Are summaries cached?

Yes. If the project content, target level, and template have not changed, the app should show the saved summary instead of spending provider tokens again.

Privacy and support

Privacy, backup, cost, and help

What data goes to the Global Library?

Only text translations, tags, source references, generated username, and coarse country/region are submitted for review. Scans, API keys, local paths, precise location, downloaded models, and backup ZIPs are not published.

How do I protect projects across updates?

Use Backup & Sync or manual backup ZIP export. Project images are stored as app-relative paths so updates should not silently break existing projects.

How do I understand token/cost usage?

FinOps estimates help you compare provider/model usage, token counts, duration, and estimated cost. Treat them as guidance, not a billing statement.

Where should I report problems?

Use the support form or Send Debug Report in the app. Include version, platform, device, provider/model, template, OCR mode, and what you expected. Do not include API keys or private source images.