ipa-dict - Monolingual wordlists with pronunciation information in IPA

This project aims to provide a series of dictionaries consisting of wordlists with accompanying phonemic pronunciation information in International Phonetic Alphabet (IPA) transcription for as many words as possible in as many languages / dialects / variants as possible.

The dictionary data is available in a number of human- and machine-readable formats, in order to make it as useful as possible for various other applications.

• Background
• Formats
  • Raw data
  • JSON
  • XML
  • CSV
  • Other formats
• Languages
• Applications
• Demo
• Notes
• Credits
• License

Background

There is no existing central, standardized location for checking the correspondence between orthography and pronunciation in any given language.

Furthermore, IPA information even for large languages can be surprisingly difficult to find, and is generally not provided for each form of a word. In many languages, reference works only carry pronunciation notation for lemmas (headwords), and very little information is available on conjugations and forms of word classes other than the dictionary form. For highly inflected languages (e.g. French), each verb may have 40 or more conjugated forms, but pronunciation will only be listed for the dictionary form.

In fact, many languages do not have any significant amount of IPA information available at all, even in dictionaries, and this is even more likely to be the case for language variants and non-standard varieties.

This project aims to resolve these problems by compiling wordlists for each language along with accompanying IPA transcription.

A combination of manual and semi-automatic generation has been used to compile the pronunciations. Whenever possible, pronunciations have been checked manually by consulting multiple reference works, particularly for lemmas (which are usually more easily available). Inflected forms have been either added manually or with semi-automatic guidance when multiple pronunciations can be pre-determined with some certainty.

Formats

For convenience, the IPA data is provided here in several different formats:

• tab delimited
• JSON
• CSV
• XML

All filenames refer to the ISO language code of the relevant language (e.g. sw.json is a JSON file containing pronunciations for Swahili.

Raw data

The raw data in this repository is provided as a series of text files with each word and its corresponding pronunciation in IPA on a separate line delimited by tab characters. The tab delimited files are plain text UTF-8 encoded files with the filename suffix .txt in the following format:

[ENTRY][TAB][IPA]

This file format is simple, lightweight, human- and machine-readable, and is also easily convertible to other common formats. Several of those formats (e.g. JSON, XML, CSV) are provided as downloads in the Releases section.

JSON

The JSON files are in the following format:

{
    "LANG":
        [{
            "ENTRY1":"IPA1",
            "ENTRY2":"IPA2",
            "ENTRY3":"IPA3",
            "ENTRY4":"IPA4"
        }]
}

XML

XML files have been generated for all the word lists in the following format:

    <IpaEntry EntryID="1">
      <Item>ENTRY</Item>
      <Ipa>/IPA/</Ipa>
    </IpaEntry>

CSV

There are comma-separated files available for use with spreadsheet programs and so on. These are in some ways similar to the raw data files, with the exception that they are delimited by commas rather than tabs. In most spreadsheet programs, you should be able to open these directly from the file menu.

Other formats

The ipa-dict-dsl project has converted all of the IPA data into DSL format dictionary files for use with dictionary software such as ABBY Lingvo, GoldenDict, or gdcl. Pre-compiled and compressed dictionary files for individual languages can be downloaded from the project releases page.

There is also a homonyms package containing all homonyms sorted by IPA reading for each language. Homonym lists are available for French, Japanese, Norwegian, Swedish, Cantonese, and Mandarin. The lists can be downloaded from the releases section.

If there is another format not listed here that would be useful to you, please feel free to open an issue or PR to add it.

Languages

IPA data is currently available for the following languages:

Language | Code -------- | ---- ar | Arabic (Modern Standard) de | German en_UK | English (Received Pronunciation) en_US | English (General American) eo | Esperanto es_ES | Spanish (Spain) es_MX | Spanish (Mexico) fa | Persian fi | Finnish fr_FR | French (France) fr_QC | French (Québec) is | Icelandic ja | Japanese jam | Jamaican Creole km | Khmer ko | Korean ma | Malay (Malaysian and Indonesian) nb | Norwegian Bokmål or | Odia ro | Romanian sv | Swedish sw | Swahili tts | Isan vi_C | Vietnamese (Central) vi_N | Vietnamese (Northern) vi_S | Vietnamese (Southern) yue | Cantonese zh | Mandarin

Applications

This project provides an accessible source for IPA pronunciation information that other dictionary projects (e.g. Wiktionary) and electronic dictionaries can draw on rather than manually adding pronunciations for each entry.

An updated collection of dictionaries in ABBYY Lingvo DSL format is maintained by the open-dsl-dict project for use in dictionary programs such as Goldendict and gdcl:

You can download the binary dictionary files here.

The IPA Lookup project provides a web interface for searching the dictionaries in different languages:

Links to all the available languages can be found on the project homepage.

Apart from the above, there are several other ways that this data could be (and has been) applied:

• Providing pronunciation information for a series of learner's grammars currently being compiled by the Open Grammar Project
• Cross-language comparison of common phonemes
• Intra-language analysis of phoneme patterns
• Automatic generation of homonym lists (a selection of these is now available for download in the releases section)
• Generating complete IPA transcriptions for stories in multiple languages as part of the Storybooks Speech and Hearing project

Demo

You can search the data online on the IPA Lookup page for each language. The website makes use of the JSON formatted data.

Notes

• Pronunciations provided are broadly phonemic, and should represent what one might expect to find in a dictionary or other popular reference work.
• Some familiarty with basic IPA is assumed, however since variation frequently exists among reference works, the transcriptions here try to maximize readability and usefulness for learners (rather than, say linguists, who might prefer to make finer distinctions).
• Pronunciation is provided where possible for each inflected form of a given lexeme, so run, ran, runs, and running for example would each be separate entries.
• The emphasis is on the correspondence between orthography and phonemic pronunciation, so separate entries are given for homonyms that are written or spelled differently.
• Where multiple possible pronunciations exist for a given entry, they should all be listed (separated by commas), even if they have different senses. For example, the word est has two different pronunciations in French (/ɛst/ and /ɛ/), depending on whether it is a noun or an (unrelated) verb, so the entry for est lists both of these pronunciations.
• Conversely, words with different orthographies are considered separate entries, even if they have the same pronunciation. This is because the lists are primarily meant to provide possible pronunciations for unique spellings rather than dictionary information for the possible spellings of unique words.
• Mandarin Chinese data has been provided in two orthographic variants -- Traditional (_hant) and Simplified (_hans) for convenience. Apart from orthography, the pronunciation data in the two versions are always the same -- the codes indicate the specific written standard used rather than pronunciation differences in different regions.

Credits

• Aspell for reference wordlists
• Folkets lexikon for Swedish pronunciation data. (CC BY-SA 2.5)
• Edict for Japanese pronunciation data (CC BY-SA 3.0)
• A Learner's Grammar of Jamaican from the Open Grammar Project for Jamaican Creole pronunciation data (CC BY 4.0)
• Unihan for Chinese character pronunciation data (Unicode License)
• KFCD Pinyin for Mandarin IPA data (CC BY 3.0)
• KFCD Pingyam for Cantonese IPA data (CC BY 3.0)
• Multisyllabic pronunciation data for Cantonese from 開放粵語詞典 (CC BY 3.0)
• Multisyllabic pronunciation data for Mandarin from 開放漢語詞典 (CC BY 3.0)
• prosodic1b by @jsfalk for Finnish IPA data (Finnish wordlist from The Institute for the Languages of Finland) (GPL 2.0)
• English (US) IPA data based on modified version of cmudict-ipa by @lingz, with addition of stress markers made possible by syllabify by @kylebgorman (MIT)
• English (UK) IPA data derived from ipacards by @leoboiko (GPL 3.0)
• Experimental IPA for German has been generated using germanipa by @kdelaney. Feedback and corrections appreciated!
• Experimental IPA for Spanish (es_ES and es_MX) has been generated using Timur Baytukalov's spanish-pronunciation-rules PHP script. Additions, corrections, and expansion of the dictionaries to other Spanish locales are welcome!
• Arabic IPA has been generated by Tim Buckwalter's Arabic Morphological Analyzer, with adjustments to allow for UTF-8 input and IPA output, with inspiration from the arabic_tools project by @lingz.
• Persian vowelled texts are extremely difficult to find, possibly even more so than Arabic. The Persian IPA data here has been pieced together from Wiktionary, the PersPred project, and a great deal of guesswork. It should be considered extremely experimental until more reliable sources become available.
• Odia IPA data provided by @psubhashish, based on converted text from Odia-language Wikimedia data dumps.
• Data for Québécois French has been generated using the qc-ipa converter and is highly experimental. It is provided here for demonstration purposes only. Improvements to the conversion process and additional data should be contributed directly to the qc-ipa project project and the results will be merged here.
• Vietnamese pronunciation data has been generated by @TasseDeCafe using vPhon in combination with this wordlist by Ho Ngoc Duc.
• Many thanks to Dr. Espen Stranger-Johannessen of the Inland Norway University of Applied Sciences for assistance with correcting and updating the Norwegian IPA data.
• Icelandic IPA is from the Pronunciation Dictionary for Icelandic by the Hjal project, released under CC BY 3.0, with some changes.
• Khmer data extracted from the Khmer-English Dictionary at aakanee.com (CC BY-NC-SA 4.0)
• Isan data extracted from the Isaan-English Dictionary at aakanee.com (CC BY-NC-SA 4.0)
• Romanian data provided by MaRePhoR (CC BY-NC)
• Korean data provided by korean-word-ipa-dictionary, extracted from Korean Wiktionary by @laviande22 (CC BY-SA)

License

All material in this repository released under the MIT license unless otherwise specified. Please note that third-party datasets retain their original licenses -- refer to the Credits section above for details.