Create a dictionary for French language and use it for spell checking

Now it works ! Many thanks !
Just another and last question: in order to end the process of creation of the french dictionary for the spell checker, I should follow the instructions of “developers” section in the wiki, shouldn’t I ?

If you already have a word list, you can do what’s described at “For Users” (Spell check - LanguageTool Wiki). The script mentioned in the “For Developers” section does almost the same, only that it first creates a list of words from the hunspell dictionary.

1 Like

Hello again,
I was maybe too much optimist!
I noticed that after creating the dictionary, its dimension is 1KB and my original dictionary.txt is 3.646 KB instead. Is this normal?

Then I tried to convert the just created dictionary.dict, in the related word list (in order to see if the content is the same as my word list) following the instruction of the wiki… But I can’t as you can see in the code below.

I copied the “” file required, from org\languagetool\resource\fr… Maybe Do I need another .info file?

I noticed also that in org\languagetool\resource\fr there’s already a french dictionary.dict and after doing the same process, it returned a corrected word list.

Here’s my code in command line:

Here I created my dictionary using my word list:
> C:\Users\HP\Desktop\LT>java -cp languagetool.jar fr_FR -i C:/Users/HP/Desktop/LT/french.txt -info C:/Users/HP/Desktop/LT/ -o C:/Users/HP/Desktop/LT/output.dict
> Running Morfologik FSACompile.main with these options: [–exit, false, -i, C:\Users\HP\AppData\Local\Temp\SpellDictionaryBuilder781820826994572409.txt, -o, C:\Users\HP\Desktop\LT\output.dict, -f, CFSA2]
> Done. The binary dictionary has been written to C:\Users\HP\Desktop\LT\output.dict

Then I tried to re-convert the dictionary in a word list to see its content:

> C:\Users\HP\Desktop\LT>java -cp languagetool.jar -i C:/Users/HP/Desktop/LT/output.dict -info C:/Users/HP/Desktop/LT/ -o C:/Users/HP/Desktop/LT/test.dict
> Running Morfologik DictDecompile.main with these options: [--exit, false, -i, C:\Users\HP\Desktop\LT\output.dict, -o, C:\Users\HP\AppData\Local\Temp\DictionaryExporter_separator1455210922122033918.txt, --overwrite]
 > _> An unhandled exception occurred. Stack trace below.

_ > java.nio.file.NoSuchFileException: C:\Users\HP\Desktop\LT\
_ > at sun.nio.fs.WindowsException.translateToIOException(Unknown Source)
_ > at sun.nio.fs.WindowsException.rethrowAsIOException(Unknown Source)
_ > at sun.nio.fs.WindowsException.rethrowAsIOException(Unknown Source)
_ > at sun.nio.fs.WindowsFileSystemProvider.newByteChannel(Unknown Source)
_ > at java.nio.file.Files.newByteChannel(Unknown Source)
_ > at java.nio.file.Files.newByteChannel(Unknown Source)
_ > at java.nio.file.spi.FileSystemProvider.newInputStream(Unknown Source)
_ > at java.nio.file.Files.newInputStream(Unknown Source)
_ > at
_ > at
_ > at
_ > at
_ > at
_ > at
_ > at
Done. The dictionary export has been written to C:/Users/HP/Desktop/LT/test.dict


I changed the encoding of my word list, I created a .info file and after executed the code, it created a file .dict of 205 KB.
I tried to open this file but the content is not readable.
How can I check if the .dict file has been well created?

Theoretically the fastest way to check if your dictionary was created right is by using morfologik tools:

But for that you’ll need to clone and build that tool.

Since I got it, I would like to post here step by step how to create the dictionary and how to use it, for people who will need it again.

Hello this is my experience in creating a dictionary for spell checking with Language Tool ! Hope you enjoy it.

Part 1: How to create the dictionary

You need:

• A .txt file with the dictionary inside

• An .info file specifying the info on how to set LT output file (It is already present in LT directory).

• LanguageTool standalone version

• Java 8

At the end of this section, you will have:

• a .dict file i.e. the file with your dictionary in a readable form for LT

  1. Install the LAST version of LT: Index of /snapshots/
  2. Be sure to have your .txt in the right format (a) and encoding (b):
    a. 1 word par line
    b. UTF8 encoding
  3. In the command line write:
    a. java -cp languagetool.jar fr_FR -i path of the dictionary file -info path of the .info file -o path of the output file


i. fr_FR is the code related to the language of the dictionary

ii. –i it’s the parameter of the input file (your .txt)

iii. –info it’s the parameter of the .info file related to the dictionary. You can create it following these instructions (Spell check - LanguageTool Wiki - “Configuring the dictionary” section) or use the .info already present – if present – in \org\languagetool\resource\yourlanguage

iv. –o it’s the parameter for specifing where you wish to save the .dict output file

Part 2: How to integrate the dictionary on LT for spell checking

You need:

• JDK 1.8 (

• Maven (Maven – Download Apache Maven)

• IDE for Java (JetBrains, Eclipse, etc.)

• .info file + .dict file (see part1)

• GitHub LanguageTool project (GitHub - languagetool-org/languagetool: Style and Grammar Checker for 25+ Languages)

  1. Set the JDK and Maven bin path (more info: Maven – Installing Apache Maven)
  2. Copy the .info and .dict files created on part1 in \languagetool-master\languagetool-language-modules\YourLanguage\src\main\resources\org\languagetool\resource\YourLanguage\hunspell
  3. Open with your IDE the java file called as the language of your dictionary (for ex. :

a. Change HunspellNoSuggestionRule in to MorfologikYourLanguageSpellerRule

  public List<Rule> getRelevantRules(ResourceBundle messages) throws IOException {
    return Arrays.asList(
new CommaWhitespaceRule(messages),
new DoublePunctuationRule(messages),
new GenericUnpairedBracketsRule(messages,
Arrays.asList("[", "(", "{" /*"«", "‘"*/),
Arrays.asList("]", ")", "}"
/*"»", French dialog can contain multiple sentences. */
/*"’" used in "d’arm" and many other words */)),
new MorfologikYourLanguageSpellerRule(messages, this),
new UppercaseSentenceStartRule(messages, this),
new MultipleWhitespaceRule(messages, this),
new SentenceWhitespaceRule(messages),
// specific to French:
new CompoundRule(messages),
new QuestionWhitespaceRule(messages)

b. Create the new in \languagetool-master\languagetool-language-modules\YourLanguage\src\main\java\org\languagetool\rules\YourLanguage :

/* LanguageTool, a natural language style checker
 * Copyright (C) 2012 Marcin Miłkowski (
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * Lesser General Public License for more details.
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301
 * USA


import java.util.ResourceBundle;

import org.languagetool.Language;
import org.languagetool.rules.spelling.morfologik.MorfologikSpellerRule;

public final class MorfologikYourLanguageSpellerRule extends MorfologikSpellerRule {

    public static final String RULE_ID = "MORFOLOGIK_RULE_CODEOFYOURLANGUAGE"; /* for ex. Fr_FR for French */

    private static final String RESOURCE_FILENAME = "PATH TO YOUR .DICT FILE";

	public MorfologikFrenchSpellerRule(ResourceBundle messages,
                                      Language language) throws IOException {
    super(messages, language);

    public String getFileName() {
        return RESOURCE_FILENAME;

    public String getId() {
        return RULE_ID;

c. Go to \languagetool-master\ with your command line and write : Mvn package

d. See your results in \languagetool-master\languagetool-standalone\target\LanguageTool-3.4-SNAPSHOT\LanguageTool-3.4-SNAPSHOT.

1 Like