Omahub
← All plugins
S

Quick Translate

by Shaun

A keyboard-friendly translation overlay with public, local, and OpenAI providers.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
284cac8
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
284cac8
Reviewed
1 month ago

Manual review of the sampled code found no malicious, obfuscated, or destructive behavior, consistent with the deterministic scan's 'none' rating. The main risks are the disclosed privacy tradeoff of sending translation text to third-party providers and the plaintext storage of an optional OpenAI API key in the user state file, both of which are clearly documented and expected for this functionality.

  • Translation text is transmitted to the selected provider (Google, Apertium, Bing, Reverso, Ollama, or OpenAI); this is user-consented and documented in the README and SECURITY.md, but it is still a privacy consideration for sensitive content.
  • An optional OpenAI API key is stored in plaintext at ~/.local/state/omarchy/quick-translate/preferences.json with 0600 permissions; it is never returned to the UI, but any process running as the same user could read it.
  • The Google, Apertium, Bing, and Reverso integrations use unofficial public endpoints that may change or rate-limit; this is a reliability caveat rather than a security vulnerability.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/seshna/quick-translate --enable
Other #quickshell

Quick Translate for Omarchy

A fast, keyboard-first translation overlay for Omarchy. It starts with Google and English → Japanese, remembers your selected translator and language pair, and keeps text only for the current Omarchy Shell session.

Quick Translate translator preview Quick Translate settings preview

Install

Install from a public Git repository:

omarchy plugin add https://github.com/seshna/quick-translate.git --enable

The overlay can then be opened from a terminal:

omarchy-shell shell toggle shaun.quick-translate '{}'

It also adds a translate icon to the right side of the Omarchy bar. Open the overlay and select the gear icon to hide that bar button or change shortcuts.

To add the suggested Super+Shift+T binding, add this to ~/.config/hypr/bindings.lua and reload Hyprland:

o.bind("SUPER + SHIFT + T", "Quick Translate",
  "omarchy-shell shell toggle shaun.quick-translate '{}'")

If you already use that shortcut, choose another binding or unbind the existing one first.

Remove

Disable and remove the plugin with:

omarchy plugin remove shaun.quick-translate

Features

  • Google (default), Apertium, Bing, Reverso, Ollama Local, and OpenAI translators
  • Searchable, engine-aware From and To language selectors
  • Multiline input and read-only translated output
  • English → Japanese by default; selected languages save immediately
  • Copy translation, or copy source and translation together
  • Clear both text boxes and undo the clear
  • A matching Omarchy bar launcher that can be hidden from Setup
  • Reconfigurable action shortcuts, recorded directly from the keyboard
  • Optional shortcut hints on the main page, and Ctrl+? to open Setup
  • Up to 5,000 input characters.

Shortcuts

Shortcut Action
Ctrl+Enter Translate (configurable)
Ctrl+U Swap languages and both text boxes (configurable)
Ctrl+Y Copy the translation (configurable)
Ctrl+Shift+Y Copy source, two newlines, then translation (configurable)
Ctrl+Shift+K Clear both text boxes (configurable)
Ctrl+Z Undo the most recent Clear (configurable)
Ctrl+? Open Setup
Escape Close the overlay

Privacy and network use

Translation requests use public, no-key web endpoints for Google, Apertium, Bing, and Reverso. These are not supported commercial APIs; they may change, rate-limit, or become unavailable without notice. Ollama Local sends requests to your local Ollama service; install the gemma3 model with ollama pull gemma3. OpenAI sends requests to OpenAI and requires an API key entered in Setup. Entered text is sent to the selected provider, so do not use this plugin for sensitive content.

The selected translator and language pair, shortcut and display preferences, translation contexts, OpenAI reasoning effort, and optional OpenAI API key are persisted under the XDG state directory, normally:

~/.local/state/omarchy/quick-translate/preferences.json

The preferences file is written atomically with permissions 0600. An OpenAI API key, when configured, is stored there and is never returned to the UI after it is saved. Source and translated text are never written to disk by the plugin.

Requirements

  • Omarchy / Omarchy Shell with third-party plugin support
  • Python 3 (standard library only)
  • wl-copy from wl-clipboard for clipboard actions
  • Internet access for translation

Development

Validate the manifest and run the test suite from the plugin directory:

omarchy plugin validate .
python3 -m unittest discover -s tests -v

To reload a local edit while Omarchy Shell is running:

omarchy-shell shell rescanPlugins

License

MIT. See LICENSE.