Hyperglot helps type designers answer a seemingly simple question of language support in fonts: When can I use font A to set texts in language B? It takes a pragmatic answer by identifying a standard character set for each orthography used by a language. The database that currently contains information for over 640+ languages is a work in progress, designed to grow.
We record a basic and any auxiliary character sets for each orthography of a language. Note that only actively used orthographies (their status is set to primary) are used when detecting language support in a font. Other, secondary or historical, orthographies are displayed just for information purposes.
Where relevant, we also provide a brief design note containing tips about shaping and positioning requirements that go beyond Unicode character code points. Hyperglot should only be used to detect whether a font can be considered for use with a particular language. It does not say anything about the quality of a font’s design.
Hyperglot is a work in progress provided AS IS, and the validity of its language data varies. To help you assess the validity of the results you view, each language in the database comes with a label indicating the quality of the data we have for it (e.g. some are considered drafts, some have been verified). We have checked the information against various online and offline sources and we are committed to continually improve it. However, we admit that mapping all the languages of the world in this way is beyond our capacity – we need help from users of each respective language! So, if you spot an issue or notice your favourite language is altogether missing from the database, get in touch. We will happily incorporate your feedback and credit you.
Read more about Hyperglot on the web app about page
The comparison of Hyperglot and the Unicode CLDR
There are several ways how to use the database:
pip install hyperglot, see usage notes below)pip install hyperglot)A few notes to illustrate why the question of language support is complicated:
It is important to note that there is more to language support in fonts than supporting a set of code points. A font needs to include glyphs with acceptable/readable shapes of the characters for a particular language. Sometimes there are regional or language variations for the same code point which means that different languages pose different requirements on the shape of a character, but identical requirements on the code point of the character. Moreover, glyphs have to interact as expected by the convention of a particular script/orthography. For example, some languages/scripts require (or strongly expect) certain glyph combinations to form ligatures or some glyph combinations require additional spacing correction (kerning) to prevent clashes or gaps. Thus, the report produced by the Hyperglot tools should only be used to detect whether a font can be considered for use with a particular language. It does not say anything about the quality of the design.
Read more about this on the web app about page
Characters are represented using Unicode code points in digital texts, e.g. the Latin-script letter a has a code point U+0061. Digital OpenType fonts map these code points to glyphs, visual representations of characters. In order to find whether one can use a font for texts in a particular language, one needs to know which character code points are required for the language. This is what the Hyperglot database is for.
A list of codepoints is obtained from a font.
The database can be accessed in two modes:
ä), codepoints for base characters and combining mark characters (e.g. a and combining ¨) from these combinations are not required unless the combination has no encoded form or the --marks flag is used.--decomposed flag fonts are required to contain the base character and combining marks for a language (e.g. languages with ä will match for fonts that only have a and combining ¨ but not ä as encoded glyph).Specified validity level is used to filter out language entries with a lower (meaning, more uncertain) validity.
If requested, base and aux (auxiliary) lists of codepoints are combined to achieve more strict criteria by using the --support option. The marks in the data are required based on the --decomposed and --marks flags. Marks that only appear in aux characters will not be required for base validity.
When detecting language support, code points for any primary orthography for a given language are considered. Orthographies with historical and secondary status are ignored. If multiple orthographies have the preferred_as_group value they are considered as one orthography even if including several scripts.
When detecting orthography support, use --include-all-orthographies, all orthographies for a given language are checked individually. Orthographies with secondary status are included. Orthographies with historical status are ignored.
If the list of code points in the font includes all code points from the list of codepoints from points 5 or 6, the font is considered to support this language/orthography. Additionally, joining behaviour and mark attachment is validated and a language/orthography is only considered supported if the font shapes these correctly. In listings the supported languages are grouped by scripts.
The language-orthography combination means that a language that has multiple orthographies using different scripts (e.g., Serbian or Japanese) is listed under all of these scripts in the tools’ output.
Important note: the web app currently does not include the shaping checks!
A simple CLI tool is provided to output language support data for a passed in font file.
You will need to have Python 3 installed. Install via pip:
pip install hyperglot
hyperglot path/to/font.otf
or to check several fonts at once, or their combined coverage (with -m union)
hyperglot path/to/font.otf path/to/anotherfont.otf ...
Additional options:
-s, --support: Specify what level of support to check against (currently options are "base" (default if omitted) or "aux")-m, --marks: Flag to signal a font should also include all combining marks used for a language - by default only those marks are required which are not part of preencoded characters (default is False)-d, --decomposed: Flag to signal a font should be considered supporting a language as long as it has all base glyphs and marks to write a language - by default also encoded precomposed glyphs are required (default is False)-a, --autonyms: Output the language names in their native language and script--speakers: Ouput how many speakers each language has (where available)--sort: Specify "speakers" to sort by speakers (default is "alphabetic")--sort-dir: Specify "desc" to sort in descending order (default is "asc" for ascending order)-o, --output: Supply a file path to write the output to, in yaml format. For a single input font this will be a subset of the Hyperglot database with the languages and orthographies that the font supports. If several fonts are provided the yaml file will have a top level dict key for each file. If the -m option is provided the yaml file will contain the specific intersection or union result-c, --comparison: How to process input if several files are provided (currently options are "individual", "union" and "intersection")--include-all-orthographies: Check all orthographies of a language, not just its primary one(s)--validity: Specify to filter by the level of validity of the language data (default is "preliminary")--include-historical: Option to include languages and orthographies marked as historical (default is False)--include-constructed: Option to include languages and orthographies that are marked as constructed (default is False)--strict-iso: Display language names and macrolanguage data strictly according to ISO (default is False)-v, --verbose: More logging information (default is False)-V, --version: Print the version hyperglot version number (default is False)Installing the pip package also installed the hyperglot-validate and hyperglot-save commands, which allow checking and saving the yaml data in a structured and compatible way.
Hyperglot comes with a hyperglot-report command that takes all the same options
the main hyperglot command (see above). It additionally takes these options to
output reporting about what characters or shaping is missing in order to support
languages detected as not supported:
--report-missing: Parameter to report unmatched languages which are missing n or less characters. If n is 0 all languages with any number of missing characters are listed (default).--report-marks: Parameter to report languages which are missing n or less mark attachment sequences. If n is 0 all languages with any number any number of missing mark attachment sequences are listed (default).--report-joining: Parameter to report languages which are missing n or less joining sequences. If n is 0 all languages with any number of missing joining sequences are listed (default).--report-all: Parameter to set/overwrite all other --report-xxx parameters.The data structure is described in a separate file together with guidelines for contributing.
Updates are comitted/merged to the dev branch with the master branch holding the latest released version.
base + mark combinations are affected by the font instructionsThe Hyperglot database and tools were originally developed by Rosetta, world typography specialists, publishers, and makers of original fonts addressing the needs of global typography. Our goal is to enable people to read better in their native languages.
Main contributors, so far:
FAQs
Detect language support for font binaries
We found that hyperglot demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.