Lexora

About

Lexora

Carry your content across languages.

Each project keeps its own glossary and translation memory, so names, honorifics, and voice stay consistent from the first segment to the thousandth.

Setup

1. Install the extension from the Chrome Web Store or load it unpacked from the dist/ folder in Developer Mode at chrome://extensions.
2. Click the Lexora icon in the browser toolbar to open the popup.
3. Sign in. The popup opens the Lexora web app login page. Once signed in, the extension syncs automatically.
4. Set the backend URL if needed. Development mode allows connections to localhost:8000. Click Test Connection to verify connectivity.
5. Import site adapters. Paste adapter JSON into the Site Adapters section of the popup and grant host permissions when prompted. Lexora only activates on sites that have a valid adapter.

How It Works

1. Open a supported chapter page. A floating panel appears in the bottom-right corner of the page.
2. Lexora detects the novel automatically. On the first visit, you'll be prompted to create a new project or link the novel to an existing project. Future visits automatically resolve to the same project.
3. Click Translate This Segment, or enable Auto-Translate to translate chapters automatically as you browse. The content is sent through the translation pipeline and streamed back in real time.
4. The translated text replaces the original content directly within the page reader. It inherits the site's styling and appears native. Glossary terms are highlighted and display tooltips on hover.

Panel Controls

Translate This Segment
Translates the current chapter.

Stop
Cancels an active translation.

Re-translate
Runs a new translation and replaces the previous result.

Show Original / Show Translation
Switches between source text and translated text.

Auto-Translate
Automatically translates each chapter as you browse.

Model
Located under More Options. Selects the language model used for the project.

Unlink This Page
Located under More Options. Removes the connection between the current novel and its project.

Panel Behavior

Minimize
Click the minus button in the header to collapse the panel into a floating button. The button indicates status using color and icons:

• Blue — Translation in progress
• Green ✓ — Translation completed
• Red ! — Error

Click the button to expand the panel again.

Drag
Drag the panel header or floating button to move it anywhere on the page. The position is remembered across pages.

Reconnect
If the backend connection is interrupted during translation, Lexora automatically retries and displays "Reconnecting...". No translation progress is lost.

View Modes

After a translation completes, three viewing modes become available:

Reading
Displays only the translated text.

Source
Displays only the original text.

Parallel
Displays the original and translated text side by side.

Linked Novels

The popup displays all novels linked to projects. Use search to quickly find a specific novel. Clicking Unlink removes the association while preserving all project data and translations.

Site Adapters

Site adapters tell Lexora how to identify and translate content on a specific website.

Import adapters by pasting adapter JSON into the popup and clicking Import. Existing adapters can be enabled, disabled, granted permissions, or deleted directly from the popup.

Adapter Builder

If a site does not yet have an adapter, Lexora can generate one automatically using an AI-powered builder.

The builder analyzes the live page, creates an adapter, validates it, and allows further refinement through natural language instructions.

Opening the Builder

1. Navigate to a chapter page on the site you want to support.
2. Open the Lexora popup from the browser toolbar.
3. Click Detect This Site. Lexora requests host permissions, injects the required scripts, and opens the builder panel.

If an adapter already exists, the builder enters refinement mode and loads the existing adapter automatically.

Builder Layout

Status Header
Displays the agent's current state, progress, and step count.

Anchor Buttons
Optional helper buttons that let you identify important page elements. Selecting one or two anchors significantly improves adapter accuracy.

Step Log
A live console showing every action the AI agent performs while analyzing the page.

Extracted Preview
Displays the generated adapter output, including title, novel identifier, chapter information, render mode, content preview, and validation warnings.

Edit Spec JSON
Provides direct access to the generated adapter JSON. Changes can be tested immediately against the current page.

Follow-Up Chat
Available after generation completes. Describe issues in plain language and the agent will update the adapter accordingly.

Agent Settings
Configure the model, maximum step count, and tool output limits. Settings sync with your account.

Running the Agent

1. Optionally select one or two anchor fields.
2. Click Detect This Site (AI).
3. The agent inspects the page structure, tests selectors, extracts identifiers, and validates candidate adapters.
4. Every action appears in the step log. Errors, warnings, and successful validations are clearly marked.
5. When satisfied, the agent submits the adapter and displays the extracted preview.
6. If corrections are needed, use the chat interface to describe the problem.
7. Review and edit the generated JSON if necessary.
8. Click Save Adapter. The adapter is synced to your account and immediately available for future visits.

Element Picker

Segment Body
Maps to content.root. Select the container that holds the chapter content.

Title
Maps to novel.title. Select the element displaying the novel title.

Segment Number
Maps to chapter.number. Select the element displaying the chapter number.

Novel ID
Maps to novel.id. Select an element or link containing a stable novel identifier.

Author
Maps to novel.author. Select the element displaying the author's name.

Selected fields display a check mark and can be re-selected at any time. These hints are included in the agent's initial analysis.

Refining Existing Adapters

When an adapter already exists, the builder automatically validates it against the current page. The chat interface opens immediately, allowing you to describe issues and update only the affected fields.

Stop and Retry

Click Stop to cancel an active builder session. The generated transcript and adapter remain available. You can edit the JSON manually or restart the process by clicking Detect This Site (AI).

Language Check

Lexora verifies that the page language matches the project's source language before translating.

If a mismatch is detected, such as when the browser has already translated the page, Lexora displays a warning.

Choose Translate Anyway to continue, or disable language validation permanently for the current project by selecting Don't Check Language For This Project.

Troubleshooting

Panel Does Not Appear

The site may not have a valid adapter. Check the Site Adapters section in the popup and verify that host permissions have been granted.

Connecting to Backend...

Verify the configured backend URL and use Test Connection to confirm connectivity.

Translation Fails

Click Retry. If the issue persists, the displayed error message will indicate the cause, such as a pipeline failure or model error.

Text Looks Incorrect

Your browser may have automatically translated the page. Disable the browser's built-in translation feature for the site and reload the page.