Naar inhoud gaan

Documentatie

Alles wat je nodig hebt om dragoman te installeren, een model te koppelen en alles draaiende te houden.

Installeren

Installeer dragoman via de store van je browser. Daar wordt de extensie ook automatisch bijgewerkt.

Chrome, Edge, Helium en andere Chromium-browsers
Een release handmatig installeren

Elke release staat ook op GitHub, met zips voor Chromium-browsers en Firefox, plus de volledige broncode. Handmatig geladen builds werken zichzelf niet bij.

  1. 1 Download de Chrome-zip van de nieuwste release en pak hem uit.
  2. 2 Open helium://extensions, of chrome://extensions in andere browsers, en zet de Ontwikkelaarsmodus aan.
  3. 3 Kies Uitgepakte extensie laden en selecteer de uitgepakte map.
Nieuwste release openen

Zet dragoman vast in de werkbalk, zodat het altijd binnen handbereik is.

Chrome voor Android ondersteunt geen extensies. Gebruik op Android Firefox.

Je eerste pagina vertalen

Open een website, klik op het dragoman-icoon, kies een taal en klik op Pagina vertalen. Alt+Shift+T, of Option+Shift+T op een Mac, doet hetzelfde via het toetsenbord. Concepten krijgen een gestippelde gouden onderstreping, die verdwijnt zodra je model elke alinea heeft verfijnd.

AltShiftT / ⌥⇧T Pagina vertalen of origineel tonen

Zo leest een vertaalde pagina

Vertaald op je apparaat
Mochi is momenteel bevorderd tot redacteur in chef.
Verfijnd door het model van jouw keuze
Mochi is inmiddels gepromoveerd tot hoofdredacteur.
Het origineel is altijd dichtbij
Houd de aanwijzer op een alinea om te lezen wat er eerst stond. Eén klik op de badge, of Alt+Shift+T, zet de hele pagina terug.

Open dragoman op een telefoon of tablet via het extensiemenu van je browser.

Vergeleken met de vertaler van je browser

Chrome, Edge, Safari en Firefox kunnen zelf pagina's vertalen, en voor een snelle blik is dat vaak genoeg. dragoman is voor als je een pagina echt wilt lezen: de betekenis en de formulering kloppen, en jij bepaalt wie de tekst ziet.

Het leest de hele pagina

Ingebouwde vertalers werken een pagina in kleine stukjes af, elk los van de rest, waardoor hetzelfde woord een paar regels verder heel anders kan uitvallen. dragoman laat je AI-model de titel, de koppen en de terugkerende zinsdelen van de pagina zien, zodat een naam, label of term van boven tot onder één vertaling houdt.

Stukje voor stukje

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

Met de hele pagina in beeld

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Een voorbeeld: één Grieks label dat steeds terugkomt in een infobox, vertaald naar het Engels.

Jij bepaalt waar de tekst heen gaat

Als Chrome of Edge een pagina vertaalt, gaat de tekst naar Google of Microsoft. dragoman maakt een concept op je apparaat en stuurt daarna alleen wat je leest naar de aanbieder die je kiest, met je eigen sleutel. Houd je alles op het apparaat, dan verlaat er helemaal geen paginatekst je computer.

Waar de tekst van de pagina naartoe gaat

Chrome Google Edge Microsoft dragoman Je apparaat Je AI-aanbieder alleen wat je leest, als je een model toevoegt
Jij kiest de vertaler
Chrome vertaalt pagina's met Google Translate, Edge met Microsoft Translator. dragoman werkt met het AI-model dat jij kiest, of dat nu Claude, Gemini, de modellen achter ChatGPT of een model op je eigen computer is. De AI-modellen van nu zijn doorgaans beter in uitdrukkingen, toon en woorden waarvan de betekenis van de zin afhangt.
Het origineel blijft dichtbij
Houd de muis boven een alinea, of tik erop op je telefoon, om te lezen wat er eerst stond, zonder de hele pagina terug te zetten.

De vertaler van je browser is ingebouwd, gratis en vraagt geen installatie. De lokale concepten van dragoman zijn ook gratis, en verfijnen kost alleen wat je provider rekent voor de tekst die je leest, met een klein model meestal heel weinig. De eigen vertaler van Firefox draait op Bergamot, dezelfde engine waarmee dragoman in Firefox concepten maakt. Daar zit het verschil dus in de AI-ronde en de paginacontext erbovenop.

Onder de motorkap
Twee rondes
Het model op je apparaat maakt op de achtergrond een concept, en Bergamot, gecompileerd naar WebAssembly, springt bij waar dat model ontbreekt. Alinea's op het scherm en net daaronder gaan vervolgens in kleine porties naar je model, en elke verfijnde alinea vervangt het concept.
Paginacontext
Elk verzoek bevat de paginatitel, een overzicht van de koppen, de zinsdelen die op de pagina terugkomen met de tekst rond hun eerste vermelding, en elke vertaling die tot nu toe is vastgelegd. Het model geeft de gekozen termen terug, en latere verzoeken houden zich daaraan.
Opmaak
Links, nadruk en andere inline-elementen reizen mee als genummerde placeholders, zodat de lay-out en de links intact terugkomen.
Alleen wat je leest
Verfijnen volgt wat er in beeld is, dus een lange pagina kost alleen het deel waar je doorheen scrolt. Klare vertalingen worden op je apparaat bewaard en hergebruikt als je terugkomt.
Geen tussenpersoon
Verzoeken gaan rechtstreeks van je browser naar je aanbieder, met je eigen sleutel. Er is geen server van dragoman, en elke regel code is openbaar.

Vertalen op je apparaat

Elke pagina begint op je apparaat. dragoman maakt concepten met het model dat in Chrome en Edge is ingebouwd, en met dat van Apple in Safari. Die draaien op je computer, anders dan de eigen paginavertaling van de browsers, die online gaat. Overal elders, en voor talen die zij niet ondersteunen, maakt Bergamot, de open engine achter Firefox Translations, het concept in je browser. Je hebt nergens een account of sleutel voor nodig. Zo krijg je al een snelle, privé vertaling. Met een AI-model worden die concepten een eerste versie die je model bijschaaft.

Eenmalige download per talencombinatie

  • Engels → Turks 15 MB
  • Engels → Duits 26 MB
  • Frans → Engels 26 MB
  • Japans → Engels 49 MB

Frans → Engels → Duits

52 MB

Geen direct model tussen twee talen? Dan gaat dragoman via het Engels en downloadt beide helften.

Downloadgroottes zoals vermeld in het modelregister van Mozilla.
Talen
Meer dan 50 talen, van en naar het Engels. Tussen twee andere talen vertaalt dragoman via het Engels. In de talenlijst hebben de talen met Alleen AI een AI-model nodig.
Eerste gebruik
Chrome en Edge halen hun taalpakketten op zodra je ze voor het eerst nodig hebt, en Safari gebruikt de talen die op je apparaat voor de vertaling van Apple zijn gedownload. De taalcombinaties van Bergamot worden eenmalig van Mozilla gedownload, meestal 15 tot 50 MB, en blijven in je browser. Daarna werkt alles offline.
Eerste versies en verfijning
Eerste versies zijn snel en vrij letterlijk, handig om de strekking te begrijpen. Je model herschrijft ze met de hele pagina in beeld, zodat de tekst natuurlijk leest en namen en termen consistent blijven.
Jij kiest
Wil je een pagina op je apparaat houden terwijl er een model is ingesteld, zet dan Alleen op dit apparaat aan in de pop-up. Wil je de concepten overslaan en op je model wachten, zet dan Eerst een concept op dit apparaat uit in Instellingen.

Bergamot is voortgekomen uit een onderzoeksproject dat door de Europese Unie werd gefinancierd. Mozilla traint en publiceert de taalmodellen die het gebruikt. Over Bergamot

Een AI-model toevoegen

Open Instellingen via de pop-up, kies een aanbieder en volg de drie stappen. dragoman controleert de sleutel zodra je die plakt en kiest alvast een snel, voordelig model, dat je altijd kunt wijzigen.

Aanbieders die je kunt gebruiken

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Elke OpenAI-compatibele server

OpenRouter kan een sleutel voor je aanmaken. Kies Verbinden met OpenRouter en keur het verzoek goed.

Anthropic-sleutels die niet aan een workspace gekoppeld zijn, hebben ook een workspace-ID nodig. Die vind je in de Anthropic Console onder Settings en dan Workspaces.

Een lokaal model gebruiken

Installeer Ollama, haal een model op zoals gemma3 en start het met OLLAMA_ORIGINS ingesteld, zodat het verzoeken van de extensie accepteert:

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

Laad in LM Studio een model, zet CORS aan in de serverinstellingen en start de lokale server. dragoman vindt die op localhost:1234.

Wat het kost

dragoman is gratis. Verfijning loopt via je eigen sleutel, dus de aanbieder rekent rechtstreeks met je af. Kleine, snelle modellen zijn meestal genoeg om te vertalen. Het tabblad Gebruik in Instellingen telt elke maand de tokens per model, en met Kosten per pagina tonen zie je de kosten van de huidige pagina naast de badge.

4 van 14 alinea's verfijnd

  • Verfijnd
  • Vertaald
  • Nog niet

Terwijl je scrolt, krijgen de alinea's net voor je een snelle eerste vertaling en worden de alinea's op je scherm verfijnd. De rest van de pagina kost niets tot je er bent.

Privacy

Wat je computer verlaat: de alinea's op het scherm en net daaronder, plus tekst die je je metgezel laat vertalen, verstuurd naar de provider die je hebt gekozen, en voor talen die je browser niet zelf kan vertalen een eenmalige modeldownload van Mozilla. Je sleutel gaat alleen naar de bijbehorende provider. dragoman heeft geen server, geen account en geen analytics.

Lees het volledige privacybeleid

Problemen oplossen

De pop-up zegt dat de pagina niet kan worden vertaald

Browserpagina's zoals de instellingen, de extensiepagina en webwinkels laten niet toe dat extensies ze wijzigen. Open in plaats daarvan een gewone website.

De lokale engine heeft geen model voor deze talencombinatie

De lokale vertalers ondersteunen de meest gebruikte talen. In Safari kun je er meer toevoegen via Vertaaltalen in de instellingen voor Taal en regio van je apparaat. Voor de rest voeg je een AI-model toe, dan vertaalt dragoman daar direct mee.

Mijn browser biedt ook aan de pagina te vertalen

dragoman vraagt je browser zich in te houden op pagina's die hij zou kunnen vertalen. Heb je dat uitgezet, zet dan Houd de vertaler van mijn browser op afstand aan in Instellingen, onder Talen. Heeft je browser een pagina al vertaald, kies dan In plaats daarvan dragoman gebruiken om hem opnieuw in het origineel te laden.

Een lokaal model maakt geen verbinding

Controleer of de server draait en of het adres in Instellingen klopt. Ollama heeft OLLAMA_ORIGINS nodig en bij LM Studio moet CORS aanstaan.

dragoman kan de pagina niet lezen

In Safari en Firefox kies je zelf welke websites een extensie mag lezen. Open dragoman en kies Toestaan op alle websites.

Firefox verfijnt niet met mijn model

Firefox vraagt toestemming voordat een extensie paginatekst ergens naartoe stuurt. Open Instellingen en kies onder je model Verzenden van paginatekst toestaan.

Bouwen vanuit de broncode

dragoman is open source onder de MIT-licentie. Om hem te bouwen heb je Node 24 en pnpm nodig.

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

Elke browser heeft een eigen build. Voer deze uit vanuit extension/:

Chromium-browsers pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Bouw daarna safari/dragoman.xcodeproj in Xcode.

De repository is een pnpm-workspace:

extension/
De extensie, gebouwd met WXT en Svelte
site/
Deze website, gebouwd met SvelteKit
brand/
De dragomans, het logo en de stad
messages/
Interfaceteksten in 85 talen