Adding A New Language To Automatic Language Detection

This wiki has been moved to - this page is archived and is not updated anymore


This page is not up-to-date anymore. Since 2.9 LanguageTool uses language-detector for language detection.

LanguageTool uses Apache's tika library to do source language detection. Since LanguageTool supports more languages than are currently available in tika, we've created additional language profiles and add them into tika at runtime.

Tika doesn't support Belarusian, Catalan, Esperanto, Galician, Romanian, Slovak, Slovenian, Ukrainian, Malayalam, and Khmer. Language profiles have been added for all but the last two.

Adding a new language

To add a new language, you need to create an n-gram profile file. This is a collection of frequency counts for letter trigrams in natural language. Here are the steps to create a new language profile:

  1. Get a corpus in the source language, preferably with as little formatting and foreign words as possible. I used Wikipedia article dumps and stripped out the punctuation and XML. The result is available at Although Wikipedia contains a lot of proper nouns and foreign words, I've found the language detection works fairly well in practice. An additional (kind of cheating) trick you can do is: after you've created an initial .ngp profile for a language, comb through your corpus file and use the LanguageIdentifier class to remove obviously foreign lines. (E.g. there are a lot of completely English sentences in foreign language Wikipedia).
  2. Pass the cleaned up text to Apache nutch's NGramProfile.create() method. (To get nutch, go here. You'll also probably need some supporting packages)
  3. Save the output n-gram profile (
  4. NGramProfile.create() creates up to four-grams, but tika only wants trigrams. Remove all the non-trigrams from the output .ngp file.
  5. Add the .ngp file to the appropriate resource/<lang>/ folder.
  6. Add the language's short name to the additionalLanguages array in
  7. Edit build.xml to copy the .ngp file over to the dist/ folder
Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License