On this page
DocsReference
Fonts
The fonts text layers and subtitles can use, the scripts each one covers, and their licences.
A text layer and subtitles name their font
by id in font; inter is the default. GET /v1/fonts lists the same fonts without an API key,
and so does the MCP tool list_fonts. In a command, drawtext names a font by its file
(Command rules) and subtitles by its family (FontName=Open Sans).
| Family | Ids | Scripts |
|---|---|---|
| Inter | inter, inter-bold | Latin, Greek, Cyrillic |
| Roboto | roboto, roboto-bold | Latin, Greek, Cyrillic |
| Open Sans | open-sans, open-sans-bold | Latin, Greek, Cyrillic |
| Montserrat | montserrat, montserrat-bold | Latin, Cyrillic |
| Poppins | poppins, poppins-bold | Latin |
| Oswald | oswald, oswald-bold | Latin, Cyrillic |
| Bebas Neue | bebas-neue | Latin |
| Playfair Display | playfair-display, playfair-display-bold | Latin, Cyrillic |
| Merriweather | merriweather, merriweather-bold | Latin, Cyrillic |
| Noto Sans | noto-sans, noto-sans-bold | Latin, Greek, Cyrillic |
| Noto Serif | noto-serif, noto-serif-bold | Latin, Greek, Cyrillic |
| JetBrains Mono | jetbrains-mono, jetbrains-mono-bold | Latin, Greek, Cyrillic |
Licences#
Every font is licensed under the SIL Open Font License, Version 1.1 (opens in a new tab), and is used unmodified.
- Inter: Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter (opens in a new tab))
- Roboto: Copyright 2011 The Roboto Project Authors (https://github.com/googlefonts/roboto-classic (opens in a new tab))
- Open Sans: Copyright 2020 The Open Sans Project Authors (https://github.com/googlefonts/opensans (opens in a new tab))
- Montserrat: Copyright 2024 The Montserrat.Git Project Authors (https://github.com/JulietaUla/Montserrat.git (opens in a new tab))
- Poppins: Copyright 2020 The Poppins Project Authors (https://github.com/itfoundry/Poppins (opens in a new tab))
- Oswald: Copyright 2016 The Oswald Project Authors (https://github.com/googlefonts/OswaldFont (opens in a new tab))
- Bebas Neue: Copyright © 2010 by Dharma Type.
- Playfair Display: Copyright 2017 The Playfair Display Project Authors (https://github.com/clauseggers/Playfair-Display (opens in a new tab)), with Reserved Font Name "Playfair Display".
- Merriweather: Copyright 2016 The Merriweather Project Authors (https://github.com/EbenSorkin/Merriweather (opens in a new tab)), with Reserved Font Name "Merriweather".
- Noto Sans: Copyright 2022 The Noto Project Authors (https://github.com/notofonts/latin-greek-cyrillic (opens in a new tab))
- Noto Serif: Copyright 2022 The Noto Project Authors (https://github.com/notofonts/latin-greek-cyrillic (opens in a new tab))
- JetBrains Mono: Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono (opens in a new tab))
Characters#
A text may use letters, marks, numbers, punctuation, symbols and spaces, and \n to break a line
(at most 6 lines and 500 characters). The font must have a glyph for every character: a character
it cannot draw is 400 invalid_request with the pointer of the text, naming the character's code
point. Each font covers its scripts in full, with their punctuation and common symbols. Bebas Neue
is an all-capitals typeface.
A subtitles file is read when the job runs, not when it is created, so its characters are not
checked: one the font cannot draw is drawn in another font of the list that has it (Greek in
poppins comes out in Inter), or as an empty box when none has it.
Chinese, Japanese and Korean, Arabic, Hebrew, the scripts of India and emoji are not available yet.