hover-trans-port

KO | EN

gitlite — search

#hacktoberfest #react #ai #typescript #llm #android #deep-learning #java #windows #kubernetes #awesome-list #vue #security #open-source

hover-trans-port

(★ 9)

Chrome MV3 extension for explicit hover/selection translation through a local AI CLI native host.

hover-trans-port 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HoverTransPort

Language: English | [한국어](readmes/README.ko.md)

![HoverTransPort inline translation preview](https://raw.githubusercontent.com/monk-lee/hover-trans-port/main/docs/assets/github-social-preview.png)

HoverTransPort is a Chrome Manifest V3 extension that translates selected or hovered web text on demand and renders the result inline. Hover a sentence, press your trigger hotkey, and read the translation in the page instead of switching to a separate translation tab.

It uses Chrome Native Messaging to call a local helper. The helper invokes the AI CLI that is already installed and authenticated on your machine: Codex CLI, Claude CLI, Gemini CLI, OpenCode CLI, or Antigravity CLI.

This project is not affiliated with, endorsed by, or sponsored by OpenAI, Codex, Anthropic, Claude, Google, Gemini, OpenCode, or Antigravity.

## What It Does

| Flow | Result |
| --- | --- |
| Hover a readable paragraph, list item, or heading | Translate the hovered block inline |
| Select specific text | Translate the selection first |
| Press a configured hotkey | Run translation only when requested |
| Open a YouTube video with provided captions | Pre-translate the caption track and show translated subtitles in sync |
| Use a local AI CLI provider | Keep provider auth outside the extension bundle |

## Quick Start

1. Download `hover-trans-port-extension-v<version>.zip` from the [latest GitHub Release](https://github.com/monk-lee/hover-trans-port/releases/latest).
2. Unzip it, open `chrome://extensions`, enable Developer mode, and load the unzipped folder.
3. Install the native host for your platform.

macOS/Linux:

```bash
   curl -fLO https://github.com/monk-lee/hover-trans-port/releases/latest/download/install.sh
   bash install.sh install
   ```

Windows PowerShell:

```powershell
   Invoke-WebRequest https://github.com/monk-lee/hover-trans-port/releases/latest/download/install.ps1 -OutFile install.ps1
   .\install.ps1 install
   ```

4. Open the extension Options page and run `Check Native Host` and `Check Provider`.
5. Choose a provider, target language, and trigger hotkey.

Each provider CLI is a separate prerequisite. Install and authenticate Codex CLI, Claude CLI, Gemini CLI, OpenCode CLI, or Antigravity CLI before selecting it in Options.

For update, uninstall, inspect-first install, diagnostics, and troubleshooting details, see [Native Host Install](docs/native-host-install.md).

## Use Web Text

1. Open a normal page with readable text.
2. Select text, or hover a paragraph, list item, or heading.
3. Press the configured trigger hotkey. The default is pressing and releasing left Control by itself.
4. Wait for the inline translation.

Common browser and editing shortcuts such as Ctrl+C or Ctrl+F are blocked from trigger recording.

## Use YouTube Subtitles

1. Open a YouTube watch page whose video already has YouTube-provided captions or automatic captions.
2. Click the HoverTransPort subtitle control in the YouTube player controls.
3. Confirm the prompt to translate the video's captions into your configured target language.
4. Wait while subtitle chunks are translated. The first translated chunk can start playback while later chunks continue in the background.
5. Toggle the translated subtitle overlay from the same player control.

HoverTransPort does not transcribe audio, run OCR, or generate captions for videos that have no YouTube caption track. If YouTube already offers a caption track in your target language, the extension does not ask to translate it.

## Current Scope

| Works today | Not yet |
| --- | --- |
| macOS, Linux, and Windows with Google Chrome; Aside on macOS | Chrome Web Store install |
| Unpacked extension loaded from `dist/` | Packaged browser-store distribution |
| Codex, Claude, Gemini, OpenCode, and Antigravity CLI providers | Full-page automatic translation |
| Hovered readable block and selection translation | PDF, iframe, OCR, speech recognition, or audio transcription |
| YouTube provided-caption pre-translation, synced overlay, and local subtitle cache | Firefox/Safari extension builds |
| Inline rendering, local SQLite cache, and Options diagnostics | Hosted translation service |

## Privacy At A Glance

HoverTransPort is local-first, but not offline-only. Requested text is passed to the local helper, which invokes the configured provider CLI. That provider CLI may send requested text upstream according to your account, authentication, environment, and provider policies.

The extension and helper do not store API keys, OAuth tokens, browser cookies, or service session tokens. If cache is enabled, normalized source text and translated text can be stored in local plaintext SQLite. YouTube subtitle cache entries can include a video's timed source captions and timed translated captions.

Read [PRIVACY.md](PRIVACY.md) and [SECURITY.md](SECURITY.md) before using HoverTransPort on sensitive content.

## Build From Source

```bash
pnpm install
pnpm build
```

Load this repository's `dist/` folder from `chrome://extensions`.

For development:

```bash
pnpm install
pnpm verify
pnpm dev
```

Developer native-host install from source:

```bash
pnpm helper:build:release
pnpm native:install
```

## Project Docs

- [Native Host Install](docs/native-host-install.md)
- [Privacy](PRIVACY.md)
- [Security](SECURITY.md)
- [Contributing](CONTRIBUTING.md)

## License

MIT. See [LICENSE](LICENSE).

hover-trans-port

hover-trans-port 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

hover-trans-port

hover-trans-port 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README