Skip to content

susumuota/deeplbox

Repository files navigation

DeepL Box: Translation history management

A Google Chrome extension to manage DeepL translation history, e.g. save, indexing, compare, search, copy and open translation.

(Click on the image to open YouTube video)

DeepL Box: translation history management

This extension provides the translation history management which saves all of the previous translations, shows index of the translations, compares the source and translation sentences one by one, searches by keyword, copies to clipboard and prepares keyboard shortcut Command-b (macOS) or Alt-b (other OS) to translate.

Install

There are 2 options to install DeepL Box. Chrome Web Store is convenient for all users. Source would be useful for developers.

(Option 1) Install from Chrome Web Store

(Option 2) Install from source

  • Open Terminal and type
# install latest stable version of Node.js and npm if needed
node -v  # v18.14.2
git clone https://github.com/susumuota/deeplbox.git
cd deeplbox
npm ci
npm run build
  • Open Chrome's extensions setting page chrome://extensions.
  • Turn Developer mode on.
  • Click Load unpacked.
  • Specify the dist folder /path/to/deeplbox/dist.

Usage

  • Select text by mouse or keyboard.
  • Press Command-b (macOS) or Alt-b (other OS).
    • Or right click to open context menu and choose DeepL Translate. − Translation window will open.

Settings

Change keyboard shortcuts

  • Open extensions setting page chrome://extensions.
  • Open menu by clicking hamburger button "☰" (triple bar icon) on the left of Extensions.
  • Click Keyboard shortcuts.
  • Click the pencil icon on the right of Open DeepL page and send selected text.

DeeLKey keyboard shortcuts

  • Input key stroke. Default is Command-b (macOS) or Alt-b (other OS).

Change settings by popup dialog

You can change source/translation language and split on punctuation option by extension popup dialog.

  • Click the DeepL Box icon D (if you "pinned" icon).

DeepL Box icon

  • Change settings by selections and buttons.

DeepL Box popup

  • Source Language specify the language of the text to be translated.

    Note: in most cases, DeepL automatically detects source language.

  • Target Language specify the language into which the text should be translated.
  • Splits on punctuation may improve the readability of long text without newlines, such as PDF.

Limitations

TODO

  • Support keyboard shortcut for local PDF files.
  • Detect paragraphs in PDF document (is there any convenient way?).

Source code

https://github.com/susumuota/deeplbox

Author

Susumu OTA