browsermt/bergamot-translator

Descreptions what the Bergamond AddOn do on Firefox

theuserbl opened this issue · 1 comments

I think, there is missing a description, what the Bergamond AddOn do on Firefox.

The AddOn is aved under
%APPDATA%\Mozilla\Firefox\Profiles\xj4dw7ov.default-release\extensions
as file
firefox-translations-addon@mozilla.org.xpi

The file is a compressed zip file. But if I look input it, there is no wordlist with english, german, spain and other language words.

Someone who have a filterlist in its router sais, that the AddOn works at the beginning not correct. Only after disabling the filtering of special URLs, the translations works perfect.

  • Which internet URLs are after the installation of the AddOn needed?
  • Which files are downloaded in the background after the normal installation?
  • Where will the other downloaded files be saved (all other files then firefox-translations-addon@mozilla.org.xpi )?
  • Where will be the wordlist / dictionary of the different languages be saved?

I don't find any answers to this questions.
So I think a description of it is needed.

Hey!

This question is more applicable to https://github.com/mozilla/firefox-translations. That extension is the one you installed, and it uses bergamot-translator internally. But it ultimately controls which models to download & use, and how to use the translations. The add-on has a privacy policy but that doesn't list the specific domains.

Which internet URLs are after the installation of the AddOn needed?

The add-on downloads translation models from storage.googleapis.com. See modelRegistry.js for the urls.

The following are not essential for the plugin to function:

  • If enabled, the add-on can report errors it encounters to *.ingest.sentry.io. See settings/prod.js
  • Likewise, if enabled, it can send telemetry to Mozilla's telemetry platform. It does this through internal Firefox APIs. I don't know the domain of the endpoint used.
  • After enabling translations, a survey button will open a tab to qsurvey.mozilla.com when clicked.

Which files are downloaded in the background after the normal installation?

Only the translation model files necessary for the language you selected to translate from (and optionally to, if not either from or to is English.). These files include all data necessary to do the translation, and only once you selected to translate something from/to that specific language will they be downloaded.

Where will the other downloaded files be saved?

In the default browser cache of Firefox. Go to the url about:cache in Firefox to see the path for your computer and its entries.

Where will be the wordlist / dictionary of the different languages be saved?

As mentioned, all translation model files are stored in the browser cache.

The model doesn't include a complete dictionary or anything, that's not how modern machine translation works. There is the file vocab.*.spm, which contains parts of words, or subwords if you will. A bit like syllables (but not syllables). The neural network, the file named model.*.intgemm.alphas.bin encodes indirectly how words are read and formed from those subwords.

I hope that helps!