# Hunspell and OpenOffice Dictionaries > Download and install Hunspell and OpenOffice dictionaries for TX Spell .NET for WPF: .dic and .aff files, languages, archive folders, licenses and REP. - **Product:** TX Spell .NET for WPF - **Section:** Documentation - **Kind:** Topic - **Path:** TX Spell .NET for WPF > Dictionaries and Languages > Hunspell and OpenOffice Dictionaries - **1284 words** - **Web URL:** https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/hunspell/ - **LLMs URL:** https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/hunspell/llms.txt - **LLMs-Full URL:** https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/hunspell/llms-full.txt --- The dictionaries of TX Spell .NET are Hunspell dictionaries, the format of the spell checkers in OpenOffice and LibreOffice. They exist for more than 60 languages, most of them are free to use and to ship with your application, and Text Control tests them and offers the approved ones for download. US English comes with TX Spell .NET; every other language is a download away. Read on for what a dictionary consists of, which languages Text Control offers, and where the files go. ### What a Hunspell Dictionary Is A Hunspell dictionary is a pair of text files with the same name: | File | Holds | |---|---| | *.dic* | The word list: the number of words in the first line, then one word per line, with optional flags that refer to the affix file, such as `0th/pt` | | *.aff* | The affix rules that build the forms of a word from its stem, such as plural or past forms, and settings: the encoding of the files in the `SET` line, for example `SET UTF-8`, and replacement rules for suggestions | Because the forms of a word are built by rules, the word list stays small. TX Spell .NET loads the pair as an [OpenOfficeDictionary](https://docs.textcontrol.com/tx-spell-dotnet-wpf/reference/txtextcontrol-proofing/openofficedictionary/llms-full.txt). Words of your own go into a user dictionary, a plain word list with the extension *.txd*, which [User Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/user/llms-full.txt) describes. ### US English Is Included The NuGet packages and the setup of TX Spell .NET bring the US English dictionary, *en\_US.dic* and *en\_US.aff*, so English text is checked in a new project without any setup. [What You Get Out of the Box](https://docs.textcontrol.com/tx-spell-dotnet-wpf/installation/language-data/#what-you-get-out-of-the-box) lists the files and where they go. ### Download More Languages Text Control offers the tested dictionaries as ZIP archives, one per language or region, on the [dictionary download page](https://www.textcontrol.com/product/tx-spell-dotnet-wpf/download/dictionary/). Each archive is named *dictionary..zip*, for example *dictionary.de\_DE.zip*. Archives exist for about 40 languages, from Afrikaans to Vietnamese; [Supported Languages](https://docs.textcontrol.com/tx-spell-dotnet-wpf/overview/languages/#languages-and-their-data) lists them with the files each archive contains. Arabic, Hebrew, Persian and Urdu are written from right to left; [Right-to-Left Languages](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/right-to-left/llms-full.txt) covers them. ### What an Archive Contains An archive holds a folder named after the locale, with the files already sorted into the folders TX Spell .NET reads. The German archive, for example, contains: ```text tx_spell_dictionary.de_DE/ Dictionaries/ de_DE_frami.aff de_DE_frami.dic README_de_DE_frami.txt COPYING_GPLv2.txt COPYING_GPLv3.txt HyphenationLists/ hyph_de_DE.dic README_hyph_de.txt COPYING_GPLv2.txt COPYING_GPLv3.txt SynonymLists/ th_de_DE_v2.dat th_de_DE_v2.idx README_thesaurus.txt COPYING_GPLv2.txt COPYING_GPLv3.txt ``` - **Dictionaries** holds the spell checking dictionary with its license files. Every archive has it. - **HyphenationLists** holds the hyphenation list of the language, where one exists; [Hyphenation Lists](https://docs.textcontrol.com/tx-spell-dotnet-wpf/hyphenation/lists/llms-full.txt) describes them. - **SynonymLists** holds the thesaurus, where one exists; [Synonym Lists](https://docs.textcontrol.com/tx-spell-dotnet-wpf/synonyms/lists/llms-full.txt) describes them. The name of the dictionary file doesn't always match the locale: the German archives contain *de\_DE\_frami.dic*, *de\_AT\_frami.dic* and *de\_CH\_frami.dic*, and the Catalan archive *ca.dic*. The name is what you pass when you load a dictionary by name. ### Install a Dictionary 1. Download the archive of the language. 2. Unzip it and copy the contents of its folders into the folders of the same name that TX Spell .NET reads: the *.dic* and *.aff* files into *Dictionaries*, and the others into *HyphenationLists* and *SynonymLists*. 3. For a .NET project, put the files into folders of the project and set their **Copy to Output Directory** property, so that every build copies them next to the application, where the packaged English files are. By default, TX Spell .NET reads the *Dictionaries* folder next to the application or, on the development machine, below the *Assembly* folder of the installation. [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/managing/llms-full.txt) shows how to use another folder and how the spell checker chooses among the dictionaries it finds. ### Check the License of Each Dictionary The dictionaries are written and maintained by their own authors, and each comes with its own license, in the README and COPYING files next to it in the archive. Most use the LGPL, but not all: the German dictionaries are licensed under the GPL, version 2 or 3, the French dictionary under the Mozilla Public License 2.0, and the English word list under the license of its SCOWL source. Read the license files of the dictionaries you ship. ### How TX Spell .NET Uses the Affix Rules TX Spell .NET reads the rules of the *.aff* file for more than word forms: - **Suggestions.** Replacement rules, written `REP` in the affix file, describe typical mistakes: a missing accent, an umlaut written as two letters, "ue" for "ΓΌ", or a phonetic spelling, "f" for "ph". TX Spell .NET considers them when it creates suggestions, so "Fone" gets "Phone" as its first suggestion, here in TX Text Control Words: ![The context menu of the misspelled word "Fone" in TX Text Control Words, with the suggestions Phone, Phones, Phoned, Phony and IPhone.](https://docs.textcontrol.com/assets/img/tx-spell-dotnet-wpf/suggestions-rep-flag.5d14a15d.webp) - **Word characters.** The flags `WORDCHARS`, `BREAK` and `ICONV` define characters that belong to words, characters that are both part of a word and a delimiter, and characters that are read as another character. The same flags work at the start of a user dictionary, as [User Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/user/llms-full.txt) shows. ### Next Steps - [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/managing/llms-full.txt): load the downloaded dictionaries and choose which one is used. - [User Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/user/llms-full.txt): add words of your own. - [Multilingual Documents and Language Scopes](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/multilingual/llms-full.txt): check texts in several languages at once. --- ## Nearby - **Previous:** [Dictionaries and Languages](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/llms-full.txt) - **Next:** [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-wpf/dictionaries/managing/llms-full.txt)