Zum Inhalt springen

Dokumentation

Alles, was du brauchst, um dragoman zu installieren, ein Modell zu verbinden und alles am Laufen zu halten.

Installation

Installiere dragoman aus dem Store deines Browsers, dann hält es sich von dort aus selbst auf dem neuesten Stand.

Chrome, Edge, Helium und andere Chromium-Browser
Release manuell installieren

Jedes Release gibt es auch auf GitHub, mit Zips für Chromium-Browser und Firefox sowie dem vollständigen Quellcode. Manuell geladene Builds aktualisieren sich nicht selbst.

  1. 1 Lade die Chrome-ZIP aus der neuesten Version herunter und entpacke sie.
  2. 2 Öffne helium://extensions bzw. in anderen Browsern chrome://extensions und aktiviere den Entwicklermodus.
  3. 3 Wähle „Entpackte Erweiterung laden“ und dann den entpackten Ordner.
Neueste Version öffnen

Hefte dragoman an die Symbolleiste, damit es nur einen Klick entfernt ist.

Chrome für Android unterstützt keine Erweiterungen. Nutze auf Android Firefox.

Deine erste Seite übersetzen

Öffne eine beliebige Website, klicke auf das dragoman-Symbol, wähle eine Sprache und dann „Seite übersetzen“. Alt+Shift+T, auf dem Mac Option+Shift+T, erledigt das per Tastatur. Entwürfe erscheinen mit gepunkteter goldener Unterstreichung, die verschwindet, sobald dein Modell den Absatz verfeinert hat.

AltShiftT / ⌥⇧T Seite übersetzen oder Original anzeigen

So liest sich eine übersetzte Seite

Auf deinem Gerät vorübersetzt
Mochi ist derzeit befördert zu Chef in Redakteur.
Verfeinert vom Modell deiner Wahl
Inzwischen wurde Mochi zur Chefredakteurin befördert.
Das Original ist nur einen Mauszeiger entfernt
Fahr mit dem Zeiger über einen Absatz, um den ursprünglichen Text zu lesen. Ein Klick auf das Badge oder Alt+Shift+T stellt die ganze Seite wieder her.

Öffne dragoman auf Handy oder Tablet über das Erweiterungsmenü deines Browsers.

Im Vergleich zum Übersetzer deines Browsers

Chrome, Edge, Safari und Firefox können Seiten selbst übersetzen, und für einen kurzen Blick reicht das oft. dragoman ist für die Momente, in denen du eine Seite wirklich lesen willst: Bedeutung und Wortwahl stimmen, und du entscheidest, wer den Text sieht.

Es liest die ganze Seite

Eingebaute Übersetzer arbeiten eine Seite in kleinen Stücken ab, jedes für sich, sodass dasselbe Wort ein paar Zeilen weiter anders herauskommen kann. dragoman zeigt deinem KI-Modell den Titel der Seite, ihre Überschriften und die wiederkehrenden Wendungen, damit ein Name, eine Bezeichnung oder ein Begriff von oben bis unten gleich übersetzt bleibt.

Stück für Stück

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

Mit der ganzen Seite im Blick

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Ein Beispiel: dieselbe griechische Bezeichnung, mehrfach in einem Infokasten, ins Englische übersetzt.

Du entscheidest, wohin der Text geht

Wenn Chrome oder Edge eine Seite übersetzt, geht der Text an Google oder Microsoft. dragoman übersetzt auf deinem Gerät vor und schickt dann nur das, was du liest, mit deinem eigenen Schlüssel an den Anbieter deiner Wahl. Bleibst du auf dem Gerät, verlässt überhaupt kein Seitentext deinen Computer.

Wohin der Seitentext geht

Chrome Google Edge Microsoft dragoman Dein Gerät Dein KI-Anbieter nur, was du liest – wenn du ein Modell hinzufügst
Du wählst den Übersetzer
Chrome übersetzt Seiten mit Google Übersetzer, Edge mit Microsoft Translator. dragoman arbeitet mit dem KI-Modell, das du wählst – ob Claude, Gemini, die Modelle hinter ChatGPT oder eines auf deinem eigenen Computer. Heutige KI-Modelle kommen meist besser mit Redewendungen, Tonfall und Wörtern zurecht, deren Bedeutung vom Satz abhängt.
Das Original bleibt griffbereit
Fahr mit der Maus über einen Absatz oder tipp ihn auf dem Handy an, um zu lesen, was vorher dastand, ohne die ganze Seite zurückzustellen.

Der Übersetzer deines Browsers ist eingebaut, kostenlos und braucht keine Einrichtung. Auch die Vorübersetzungen von dragoman auf dem Gerät sind kostenlos, und das Verfeinern kostet nur, was dein Anbieter für den gelesenen Text berechnet – mit einem kleinen Modell meist sehr wenig. Der eigene Übersetzer von Firefox nutzt Bergamot, dieselbe Engine, mit der dragoman in Firefox vorübersetzt. Dort liegt der Unterschied also im KI-Durchgang und im Seitenkontext obendrauf.

Unter der Haube
Zwei Durchgänge
Das Modell deines Browsers übersetzt im Hintergrund vor; wo es keines gibt, springt Bergamot ein, kompiliert zu WebAssembly. Absätze auf dem Bildschirm und direkt danach gehen dann in kleinen Paketen an dein Modell, und jeder verfeinerte Absatz ersetzt seinen Entwurf.
Seitenkontext
Jede Anfrage enthält den Seitentitel, eine Gliederung der Überschriften, die auf der Seite wiederkehrenden Wendungen samt Text um ihr erstes Vorkommen und alle bisher festgelegten Übersetzungen. Das Modell gibt die gewählten Begriffe zurück, und spätere Anfragen halten sich daran.
Auszeichnung
Links, Hervorhebungen und andere Inline-Elemente reisen als nummerierte Platzhalter mit, sodass Layout und Links unversehrt zurückkommen.
Nur, was du liest
Das Verfeinern folgt dem sichtbaren Bereich, sodass eine lange Seite nur den Teil kostet, durch den du scrollst. Fertige Übersetzungen werden auf deinem Gerät gespeichert und wiederverwendet, wenn du zurückkommst.
Kein Zwischenhändler
Anfragen gehen mit deinem Schlüssel direkt von deinem Browser an deinen Anbieter. Es gibt keinen dragoman-Server, und jede Zeile des Codes ist öffentlich.

Übersetzung auf dem Gerät

Jede Seite beginnt auf deinem Gerät. dragoman übersetzt mit dem in Chrome und Edge eingebauten Modell vor, in Safari mit dem von Apple. Diese laufen auf deinem Computer – anders als die Seitenübersetzung der Browser, die online arbeitet. Überall sonst und für alle Sprachen, die sie nicht abdecken, übersetzt Bergamot, die offene Engine hinter Firefox Translations, direkt in deinem Browser. Nichts davon braucht ein Konto oder einen Schlüssel. Allein bekommst du eine schnelle, private Übersetzung. Mit einem KI-Modell werden diese Entwürfe zur Vorlage, die dein Modell verfeinert.

Einmaliger Download pro Sprachpaar

  • Englisch → Türkisch 15 MB
  • Englisch → Deutsch 26 MB
  • Französisch → Englisch 26 MB
  • Japanisch → Englisch 49 MB

Französisch → Englisch → Deutsch

52 MB

Kein direktes Modell zwischen zwei Sprachen? dragoman geht den Umweg über Englisch und lädt beide Hälften herunter.

Downloadgrößen laut Mozillas Modellverzeichnis.
Sprachen
Mehr als 50 Sprachen, aus dem und ins Englische. Zwischen zwei anderen Sprachen übersetzt dragoman über Englisch. In der Sprachliste brauchen die mit Nur KI markierten Sprachen ein KI-Modell.
Erste Nutzung
Chrome und Edge laden ihre Sprachpakete, wenn du sie zum ersten Mal brauchst, und Safari nutzt die Sprachen, die für Apples Übersetzung auf deinem Gerät geladen sind. Die Sprachpaare von Bergamot werden einmalig von Mozilla geladen, meist 15 bis 50 MB, und bleiben in deinem Browser. Danach funktioniert alles offline.
Entwürfe und Verfeinerung
Entwürfe sind schnell und eher wörtlich – gut, um das Wesentliche zu verstehen. Dein Modell überarbeitet sie mit Blick auf die ganze Seite, sodass der Text natürlich klingt und Namen und Begriffe einheitlich bleiben.
Deine Wahl
Um eine Seite auch mit eingerichtetem Modell auf deinem Gerät zu behalten, aktiviere Nur auf diesem Gerät im Pop-up. Um Vorübersetzungen zu überspringen und auf dein Modell zu warten, deaktiviere Zuerst auf diesem Gerät vorübersetzen in den Einstellungen.

Bergamot entstand aus einem von der Europäischen Union geförderten Forschungsprojekt. Mozilla trainiert und veröffentlicht die Sprachmodelle, mit denen es arbeitet. Über Bergamot

KI-Modell hinzufügen

Öffne im Pop-up die Einstellungen, wähle einen Anbieter und folge den drei Schritten. dragoman prüft den Schlüssel direkt beim Einfügen und wählt ein schnelles, günstiges Modell vor, das du jederzeit ändern kannst.

Verfügbare Anbieter

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Jeder OpenAI-kompatible Server

OpenRouter kann den Schlüssel für dich erstellen. Wähle „Mit OpenRouter verbinden“ und bestätige die Anfrage.

Anthropic-Schlüssel ohne Workspace-Bindung brauchen zusätzlich eine Workspace-ID. Du findest sie in der Anthropic Console unter „Settings“ und dann „Workspaces“.

Lokales Modell nutzen

Installiere Ollama, lade ein Modell wie gemma3 und starte es mit gesetztem OLLAMA_ORIGINS, damit es Anfragen der Erweiterung annimmt:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

Lade in LM Studio ein Modell, aktiviere CORS in den Servereinstellungen und starte den lokalen Server. dragoman findet ihn unter localhost:1234.

Was es kostet

dragoman ist kostenlos. Das Verfeinern läuft über deinen eigenen Schlüssel, der Anbieter rechnet also direkt mit dir ab. Für Übersetzungen reichen meist kleine, schnelle Modelle. Der Tab „Nutzung“ in den Einstellungen zählt die Tokens pro Modell und Monat. Wenn du „Kosten pro Seite anzeigen“ aktivierst, stehen die Kosten der aktuellen Seite neben dem Badge.

4 von 14 Absätzen verfeinert

  • Verfeinert
  • Vorübersetzt
  • Noch nicht

Beim Scrollen bekommen die Absätze direkt voraus eine schnelle Vorübersetzung, die sichtbaren werden verfeinert. Der Rest der Seite kostet nichts, bis du dort ankommst.

Datenschutz

Was deinen Computer verlässt: die Absätze auf dem Bildschirm und direkt danach sowie jeder Text, den dein Begleiter für dich übersetzen soll – gesendet an den Anbieter deiner Wahl – und für Sprachen, die dein Browser nicht selbst übersetzen kann, ein einmaliger Modell-Download von Mozilla. Dein Schlüssel wird nur an seinen eigenen Anbieter gesendet. dragoman hat keinen Server, kein Konto und keine Analyse.

Vollständige Datenschutzerklärung lesen

Fehlerbehebung

Das Pop-up meldet, dass die Seite nicht übersetzt werden kann

Browserseiten wie Einstellungen, die Erweiterungsseite und Web Stores lassen sich von Erweiterungen nicht verändern. Öffne stattdessen eine normale Website.

Die lokale Engine hat kein Modell für dieses Sprachpaar

Die Übersetzer auf dem Gerät decken die meistgenutzten Sprachen ab. In Safari kannst du unter „Übersetzungssprachen“ in den Einstellungen für Sprache & Region deines Geräts weitere hinzufügen. Für alle anderen füge ein KI-Modell hinzu, dann übersetzt dragoman direkt damit.

Mein Browser bietet auch an, die Seite zu übersetzen

dragoman bittet deinen Browser, sich auf Seiten zurückzuhalten, die er übersetzen könnte. Falls du das ausgeschaltet hast, aktiviere in den Einstellungen unter „Sprachen“ die Option „Übersetzer meines Browsers fernhalten“. Hat dein Browser eine Seite schon übersetzt, wähle „Stattdessen dragoman nutzen“, um sie im Original neu zu laden.

Ein lokales Modell verbindet sich nicht

Prüfe, ob der Server läuft und die Adresse in den Einstellungen übereinstimmt. Ollama braucht OLLAMA_ORIGINS, bei LM Studio muss CORS aktiviert sein.

dragoman kann die Seite nicht lesen

In Safari und Firefox legst du fest, welche Websites eine Erweiterung lesen darf. Öffne dragoman und wähle „Auf allen Websites erlauben“.

Firefox verfeinert nicht mit meinem Modell

Firefox fragt nach, bevor eine Erweiterung Seitentext irgendwohin sendet. Öffne die Einstellungen und wähle unter deinem Modell „Senden von Seitentext erlauben“.

Aus dem Quellcode bauen

dragoman ist Open Source unter der MIT-Lizenz. Zum Bauen brauchst du Node 24 und pnpm.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

Jeder Browser hat einen eigenen Build. Führe diese Befehle in extension/ aus:

Chromium-Browser pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Baue dann safari/dragoman.xcodeproj in Xcode.

Das Repository ist ein pnpm-Workspace:

extension/
Die Erweiterung, gebaut mit WXT und Svelte
site/
Diese Website, gebaut mit SvelteKit
brand/
Die Dragomane, das Logo und die Stadt
messages/
Oberflächentexte in 85 Sprachen