# Installing Dictionaries and Language Data

> Install dictionaries, hyphenation lists, thesaurus files and language recognition data for Windows Forms: the four folders, (Auto) lookup and downloads.

- **Product:** TX Spell .NET for Windows Forms
- **Section:** Documentation
- **Kind:** Topic
- **Path:** TX Spell .NET for Windows Forms > Installation Guide > Installing Dictionaries and Language Data
- **1213 words**
- **Web URL:** https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/language-data/
- **LLMs URL:** https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/language-data/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/language-data/llms-full.txt

---

TX Spell .NET reads its language data from files: dictionaries for spell checking, hyphenation lists, thesaurus files and the data for language detection. US English comes with the packages and the setup, and every other language is a download. Where the files are decides whether the spell checker finds them, on your development machine and on the machines of your users.

### The Four Folders

| Folder | Holds | Used for | Property |
|---|---|---|---|
| *Dictionaries* | Hunspell dictionaries (*.dic* and *.aff*) and user dictionaries (*.txd*) | Spell checking and suggestions | [DictionariesDirectoryPath](https://docs.textcontrol.com/tx-spell-dotnet-winforms/reference/txtextcontrol-proofing/txspellchecker/dictionariesdirectorypath-property/llms-full.txt) |
| *HyphenationLists* | Hunspell hyphenation lists (*hyph\_\*.dic*) | Hyphenation | [HyphenationListsDirectoryPath](https://docs.textcontrol.com/tx-spell-dotnet-winforms/reference/txtextcontrol-proofing/txspellchecker/hyphenationlistsdirectorypath-property/llms-full.txt) |
| *SynonymLists* | Thesaurus files (*.dat* and *.idx*) | Synonyms | [SynonymListsDirectoryPath](https://docs.textcontrol.com/tx-spell-dotnet-winforms/reference/txtextcontrol-proofing/txspellchecker/synonymlistsdirectorypath-property/llms-full.txt) |
| *LanguageRecognition* | *languageRecognition.resources* | Language detection | [LanguageRecognitionDirectoryPath](https://docs.textcontrol.com/tx-spell-dotnet-winforms/reference/txtextcontrol-proofing/txspellchecker/languagerecognitiondirectorypath-property/llms-full.txt) |

The spell checker uses the files in these folders automatically.

### What You Get Out of the Box

- **.NET projects.** The TX Spell .NET packages contain the US English files of all four folders and copy them into the output folder when you build: *en\_US.dic* and *en\_US.aff*, *hyph\_en\_US.dic*, *th\_en\_US\_v2.dat* and *th\_en\_US\_v2.idx*, and *languageRecognition.resources*.
- **.NET Framework projects.** The setup installs the same files in the four folders below the *Assembly* folder of the installation.

With either, English text is checked, hyphenated and given synonyms without any setup.

### Where the Spell Checker Looks

The four folder properties in the table above are "(Auto)" by default. "(Auto)" means:

1. The folder of that name next to the application, such as *Dictionaries* in the output folder.
2. On the development machine, the folder of that name below the *Assembly* folder of the TX Spell .NET installation.

To keep the files elsewhere, for example in a folder shared by several applications, set the property to that folder:

```csharp
txSpellChecker1.DictionariesDirectoryPath = @"C:\Data\Dictionaries";
txSpellChecker1.SynonymListsDirectoryPath = @"C:\Data\SynonymLists";
```

Set the properties before the first check. The [TXSpell](https://docs.textcontrol.com/tx-spell-dotnet-winforms/reference/txtextcontrol-proofing/txspell/llms-full.txt) class, which checks text without a user interface, has the same four properties. When a folder can't be found, the spell checker throws an exception; [Dictionaries Not Found](https://docs.textcontrol.com/tx-spell-dotnet-winforms/troubleshooting/dictionaries/llms-full.txt) lists the causes. [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/managing/llms-full.txt) shows how the spell checker then chooses among the dictionaries it finds.

### Add Other Languages

Text Control offers tested dictionaries, hyphenation lists and thesaurus files for about 40 languages on the dictionary download page of [TX Spell .NET for Windows Forms](https://www.textcontrol.com/product/tx-spell-dotnet-winforms/download/dictionary/). No sign-in is needed:

![The Download Dictionaries page of TX Spell .NET for Windows Forms, with the note that it is compatible with Hunspell dictionary, hyphenation and thesaurus files, and the Afrikaans entry expanded with its file South Africa.](https://docs.textcontrol.com/assets/img/tx-spell-dotnet-winforms/dictionary-download-page.1c590ecf.webp)

Each language opens a list of files per region:

![The German entry of the dictionary download page expanded, with the files Austria, Germany and Switzerland, each 9.4 MB.](https://docs.textcontrol.com/assets/img/tx-spell-dotnet-winforms/dictionary-download-german.46ad22dd.webp)

1. Download the file of the language and region.
2. Unzip it. The archive contains a folder named after the locale, such as *tx\_spell\_dictionary.de\_DE*, with the folders *Dictionaries*, *HyphenationLists* and *SynonymLists*, as far as the language has them.
3. **In a .NET project,** add the files to folders of the same names in the project and set their **Copy to Output Directory** property, so that every build copies them next to the packaged English files.
4. **In a .NET Framework project,** copy the files into the folders below the *Assembly* folder of the installation while you develop, and ship them with the application.

[Hunspell and OpenOffice Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/hunspell/llms-full.txt) describes the archives, the file names and the licenses of the dictionaries.

### Ship the Language Data

The application needs its language data folders on the user's machine: with the NuGet packages, **Publish** copies them; without them, you copy the four folders next to the executable. The [Deployment Guide](https://docs.textcontrol.com/tx-spell-dotnet-winforms/deployment/llms-full.txt) covers deployment in full, and [Check the License of Each Dictionary](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/hunspell/#check-the-license-of-each-dictionary) the licenses of the files you ship.

### Next Steps

- [Loading and Managing Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/managing/llms-full.txt): load the dictionaries you added.
- [Hunspell and OpenOffice Dictionaries](https://docs.textcontrol.com/tx-spell-dotnet-winforms/dictionaries/hunspell/llms-full.txt): the languages and what the archives contain.
- [License Configuration](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/licensing/llms-full.txt): how your license reaches the application.

---

## Nearby

- **Previous:** [Visual Studio Toolbox and Designer](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/toolbox/llms-full.txt)
- **Next:** [License Configuration](https://docs.textcontrol.com/tx-spell-dotnet-winforms/installation/licensing/llms-full.txt)
