2020-04-09 19:56:19 +03:00
## Fira Code: free monospaced font with programming ligatures
2014-11-11 22:47:04 +03:00
2021-02-16 00:46:47 +03:00
![Fira Code ](./extras/logo.svg )
2015-07-30 15:27:45 +03:00
2023-06-19 18:23:58 +03:00
Read in [Español ](./LEEME.md ) | [简体中文 ](./README_CN.md ) | [日本語 ](./README_JA.md )
2021-12-20 14:59:31 +03:00
2014-11-11 22:47:04 +03:00
### Problem
2016-04-01 15:45:12 +03:00
Programmers use a lot of symbols, often encoded with several characters. For the human brain, sequences like `->` , `<=` or `:=` are single logical tokens, even if they take two or three characters on the screen. Your eye spends a non-zero amount of energy to scan, parse and join multiple characters into a single logical one. Ideally, all programming languages should be designed with full-fledged Unicode symbols for operators, but that’ s not the case yet.
2014-11-11 22:47:04 +03:00
### Solution
2020-04-09 19:56:19 +03:00
Fira Code is a free monospaced font containing ligatures for common programming multi-character combinations. This is just a font rendering feature: underlying code remains ASCII-compatible. This helps to read and understand code faster. For some frequent sequences like `..` or `//` , ligatures allow us to correct spacing.
2015-12-21 10:29:09 +03:00
2020-04-09 19:56:19 +03:00
### Download & Install
2018-09-18 22:39:18 +03:00
2022-03-05 04:49:03 +03:00
< a href = "https://github.com/tonsky/FiraCode/releases/download/6.2/Fira_Code_v6.2.zip" > < img alt = "Fira_Code_v6.2.zip - December 6, 2021 - 2.5 MB" src = "./extras/download.png" width = "520" > < / a >
2014-11-11 22:47:04 +03:00
2020-04-09 19:56:19 +03:00
Then:
2021-02-16 00:46:47 +03:00
- [How to Install ](https://github.com/tonsky/FiraCode/wiki )
- [Troubleshooting ](https://github.com/tonsky/FiraCode/wiki#troubleshooting )
- [News & Updates ](https://twitter.com/FiraCode )
2020-04-09 19:56:19 +03:00
2022-02-09 17:50:05 +03:00
### Sponsors
2020-04-09 19:56:19 +03:00
2020-07-14 09:03:51 +03:00
Fira Code is a personal, free-time project with no funding and a huge [feature request backlog ](https://github.com/tonsky/FiraCode/issues ). If you love it, consider supporting its development via [GitHub Sponsors ](https://github.com/sponsors/tonsky ) or [Patreon ](https://patreon.com/tonsky ). Any help counts!
2020-04-09 19:56:19 +03:00
2022-02-09 17:50:05 +03:00
Huge thanks to:
< table >
< td align = "center" >
2022-02-09 19:40:30 +03:00
< a href = "https://workos.com/?utm_campaign=github_repo&utm_medium=referral&utm_content=firacode&utm_source=github" >
2022-02-09 17:50:05 +03:00
< div >
< img src = "https://user-images.githubusercontent.com/629429/151508669-efb4c3b3-8fe3-45eb-8e47-e9510b5f0af1.svg" width = "290" alt = "WorkOS" >
< / div >
< b > Your app, enterprise-ready.< / b >
< div >
< sub > Start selling to enterprise customers with just a few lines of code. Add Single Sign-On (and more) in minutes instead of months.< / sup >
< / div >
< / a >
< / td >
< / table >
2020-04-09 19:56:19 +03:00
### What’ s in the box?
Left: ligatures as rendered in Fira Code. Right: same character sequences without ligatures.
2022-03-05 04:49:03 +03:00
< img src = "./extras/ligatures.png" width = "754" >
2020-04-09 19:56:19 +03:00
2020-07-14 09:03:51 +03:00
Fira Code comes with a huge variety of arrows. Even better: you can make them as long as you like and combine start/middle/end fragments however you want!
2020-04-09 19:56:19 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/arrows.png" width = "754" >
2020-04-09 19:56:19 +03:00
2020-05-18 00:34:17 +03:00
Fira Code is not only about ligatures. Some fine-tuning is done for punctuation and frequent letter pairs.
2020-04-09 19:56:19 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/typographics.png" width = "754" >
2014-11-11 22:47:04 +03:00
Update README with cv01, ss01 , zero, onum, etc
Those are already reference in the images, but they are not searchable.
By putting in the text is easier to find as you can search for calt, onum, zero, cv01, ss01,
and find the relevant documentation
2023-03-16 10:36:54 +03:00
Fira Code comes with a few different character variants (`cv01`, `cv02` , etc), stylistic sets (`ss01`, `ss02` , etc) and other font features (`zero`, `onum` , `calt` , etc), so that everyone can choose what’ s best for them. [How to enable ](https://github.com/tonsky/FiraCode/wiki/How-to-enable-stylistic-sets )
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/character_variants.png" width = "754" >
2016-08-30 14:34:40 +03:00
2021-11-06 04:47:45 +03:00
Some ligatures can be altered or enabled using stylistic sets/character variants:
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/ligature_variants.png" width = "754" >
2016-08-30 14:34:40 +03:00
2021-11-06 04:47:45 +03:00
Being a programming font, Fira Code has fantastic support for ASCII/box drawing, powerline and other forms of console UIs:
2017-09-28 15:13:33 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/console.png" width = "754" >
2021-11-06 04:47:45 +03:00
Fira Code is the first programming font to offer dedicated glyphs to render progress bars:
2022-03-05 04:49:03 +03:00
< img src = "./extras/progress.png" width = "754" >
2021-11-06 04:47:45 +03:00
In action:
2022-03-05 04:49:03 +03:00
< img src = "./extras/progress.gif" width = "560" >
2021-11-06 04:47:45 +03:00
We hope more programming fonts will adopt this convention and ship their own versions.
Unicode coverage makes Fira Code a great choice for mathematical writing:
2022-03-05 04:49:03 +03:00
< img src = "./extras/math.png" width = "754" >
2017-09-28 15:13:33 +03:00
2020-05-18 00:34:17 +03:00
### How does it look?
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/samples.png" width = "754" >
< img src = "./extras/samples2.png" width = "754" >
2015-12-20 17:51:56 +03:00
2020-04-09 19:56:19 +03:00
### Editor compatibility list
2014-11-11 22:47:04 +03:00
2017-03-25 18:05:36 +03:00
| Works | Doesn’ t work |
2020-05-18 00:34:17 +03:00
|-------|----------------|
2023-05-26 00:16:15 +03:00
| **Arduino IDE** (2.0+,same instructions as [vscode ](https://github.com/tonsky/FiraCode/wiki/VS-Code-Instructions )) | **Adobe Dreamweaver** |
| **Abricotine** | **Delphi IDE** |
| **Android Studio** (2.3+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) | Standalone **Emacs** ([workaround](https://github.com/tonsky/FiraCode/wiki/Emacs-instructions)) |
| **Anjuta** (unless at the EOF) | **IDLE** |
| **AppCode** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) | **KDevelop 4** |
| **Atom** 1.1 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/Atom-instructions)) | **Monkey Studio IDE** |
| **BBEdit** (14.6+ [instructions ](https://github.com/tonsky/FiraCode/wiki/BBEdit-instructions )) | **UltraEdit** (Windows) |
2022-07-11 22:11:46 +03:00
| **Brackets** (with [this plugin ](https://github.com/polo2ro/firacode-in-brackets )) |
2023-05-26 00:16:15 +03:00
| **Chocolat** |
2022-07-11 22:11:46 +03:00
| **CLion** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2021-12-06 19:12:08 +03:00
| **Cloud9** ([instructions](https://github.com/tonsky/FiraCode/wiki/Cloud9-Instructions)) |
2021-06-11 17:44:24 +03:00
| **Coda 2** |
2021-11-12 05:04:44 +03:00
| **CodeLite** |
| **CodeRunner** |
2022-06-30 01:59:46 +03:00
| **Comma** (Under: Preferences > Editor > Font) |
2020-11-03 12:50:16 +03:00
| **CotEditor** |
2020-06-17 17:37:01 +03:00
| **Eclipse** |
| **elementary Code** |
2021-06-11 21:35:50 +03:00
| **Geany** (1.37+) |
2017-03-25 18:05:36 +03:00
| **gEdit / Pluma** |
| **GNOME Builder** |
2022-07-11 18:03:03 +03:00
| **Godot** |
2018-12-04 17:13:01 +03:00
| **GoormIDE** ([instructions](https://github.com/tonsky/FiraCode/wiki/GoormIDE-Instructions)) |
2021-12-06 18:06:18 +03:00
| **gVim** ([Windows](https://github.com/tonsky/FiraCode/issues/462), [GTK ](https://vimhelp.org/options.txt.html#%27guiligatures%27 )) |
2022-02-07 00:27:30 +03:00
| **IntelliJ IDEA** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Kate, KWrite** |
2019-06-03 13:22:45 +03:00
| **KDevelop 5+** |
2017-03-25 18:05:36 +03:00
| **Komodo** |
| **Leafpad** |
| **LibreOffice** |
| **LightTable** ([instructions](https://github.com/tonsky/FiraCode/wiki/LightTable-instructions)) |
| **LINQPad** |
| **MacVim** 7.4 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/MacVim-instructions)) |
| **Mancy** |
2021-03-08 05:03:51 +03:00
| **MATLAB** ([instructions](https://github.com/tonsky/FiraCode/wiki/MATLAB-for-Windows-Instructions)) |
2017-03-25 18:05:36 +03:00
| **Meld** |
| **Mousepad** |
2018-03-13 12:51:38 +03:00
| **NeoVim-gtk** |
2017-03-25 18:05:36 +03:00
| **NetBeans** |
2019-11-04 16:45:41 +03:00
| **Notepad** (Windows) |
2023-11-09 16:41:46 +03:00
| **Notepad++** ([instructions](https://github.com/tonsky/FiraCode/issues/1555)) |
2019-11-15 15:32:53 +03:00
| **Notepad3** ([instructions](https://github.com/rizonesoft/Notepad3/issues/361#issuecomment-365977420))|
2021-11-12 05:04:44 +03:00
| **Nova** |
2022-02-07 00:27:30 +03:00
| **PhpStorm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
| **PyCharm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2021-06-29 15:56:11 +03:00
| **QOwnNotes** (21.16.6+) |
2017-03-25 18:05:36 +03:00
| **QtCreator** |
| **Rider** |
| **RStudio** ([instructions](https://github.com/tonsky/FiraCode/wiki/RStudio-instructions)) |
2022-02-07 00:27:30 +03:00
| **RubyMine** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Scratch** |
2019-01-02 19:22:28 +03:00
| **Scribus** (1.5.3+) |
2017-10-06 18:34:44 +03:00
| **SublimeText** (3146+) |
2017-03-30 16:23:15 +03:00
| **Spyder IDE** (only with Qt5) |
2017-12-12 02:06:14 +03:00
| **SuperCollider 3** |
2022-01-31 02:11:45 +03:00
| **TeXShop** |
2019-11-04 16:45:41 +03:00
| **TextAdept** (Linux, macOS) |
2017-03-25 18:05:36 +03:00
| **TextEdit** |
| **TextMate 2** |
2023-05-26 00:16:15 +03:00
| **UltraEdit (UEX)** (Linux) |
2017-03-25 18:05:36 +03:00
| **VimR** ([instructions](https://github.com/qvacua/vimr/wiki#ligatures)) |
2019-05-31 14:12:26 +03:00
| **Visual Studio** (2015+, [instructions ](https://github.com/tonsky/FiraCode/wiki/Visual-Studio-Instructions )) |
2017-03-25 18:05:36 +03:00
| **Visual Studio Code** ([instructions](https://github.com/tonsky/FiraCode/wiki/VS-Code-Instructions)) |
2022-02-07 00:27:30 +03:00
| **WebStorm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Xamarin Studio/Monodevelop** |
2017-08-07 16:27:23 +03:00
| **Xcode** (8.0+, otherwise [with plugin ](https://github.com/robertvojta/LigatureXcodePlugin )) |
2020-04-18 17:47:10 +03:00
| **Xi** |
2017-03-25 18:05:36 +03:00
| Probably work: **Smultron, Vico** | Under question: **Code::Blocks IDE** |
2014-11-11 22:47:04 +03:00
2020-05-18 00:34:17 +03:00
### Terminal compatibility list
2022-04-01 17:55:14 +03:00
| Works | Doesn’ t work |
|-------|--------------|
| crosh ([instructions](https://github.com/tonsky/FiraCode/wiki/ChromeOS-Terminal)) | Alacritty |
2023-05-26 00:16:15 +03:00
| Hyper (see [#3607 ](https://github.com/vercel/hyper/issues/3607 )) | Asbru Connection Manager |
| iTerm 2 | Cmder |
| Kitty | ConEmu |
| Konsole | GNOME Terminal |
| Mintty | gtkterm ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| QTerminal | guake ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| st ([patch](https://st.suckless.org/patches/ligatures/)) | LXTerminal ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| Tabby | mate-terminal |
2022-04-01 17:55:14 +03:00
| Terminal.app | PuTTY |
| Termux | rxvt |
| Token2Shell | sakura ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
2023-05-26 00:16:15 +03:00
| Wez’ s terminal | SecureCRT
| Windows Terminal | Terminator ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| ZOC (macOS) | terminology |
| | Tilix |
2023-02-22 18:42:08 +03:00
| | Windows Console |
2022-04-01 17:55:14 +03:00
| | xfce4-terminal ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| | xterm |
| | ZOC (Windows) |
2020-05-18 00:34:17 +03:00
2015-12-19 19:15:03 +03:00
### Browser support
2015-05-07 17:41:30 +03:00
2017-09-28 10:56:54 +03:00
```html
<!-- HTML -->
2021-12-06 23:52:45 +03:00
< link rel = "stylesheet" href = "https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css" >
2017-09-28 10:56:54 +03:00
```
```css
/* CSS */
2021-12-06 23:52:45 +03:00
@import url(https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css);
2017-09-28 10:56:54 +03:00
```
2019-03-11 21:44:23 +03:00
```css
/* Specify in CSS */
2019-10-18 10:55:38 +03:00
code { font-family: 'Fira Code', monospace; }
@supports (font-variation-settings: normal) {
code { font-family: 'Fira Code VF', monospace; }
}
2019-03-11 21:44:23 +03:00
```
2020-02-07 00:35:37 +03:00
- IE 10+, Edge Legacy: enable with `font-feature-settings: "calt";`
2015-12-19 19:15:03 +03:00
- Firefox
2015-12-20 11:20:33 +03:00
- Safari
2016-11-30 21:39:19 +03:00
- Chromium-based browsers (Chrome, Opera)
2015-12-21 23:12:16 +03:00
- ACE
2016-11-30 21:40:27 +03:00
- CodeMirror (enable with `font-variant-ligatures: contextual;` )
2016-07-18 18:02:34 +03:00
2017-02-15 22:07:49 +03:00
### Projects using Fira Code
2017-02-16 12:17:37 +03:00
- [CodePen ](https://codepen.io/ )
2017-02-15 22:07:49 +03:00
- [Blink Shell ](http://www.blink.sh/ )
- [Klipse ](http://app.klipse.tech/ )
- [IlyaBirman.net ](http://ilyabirman.net/ )
- [EvilMartians.com ](https://evilmartians.com/ )
2018-03-11 22:54:23 +03:00
- [Web Maker ](https://webmakerapp.com/ )
2018-03-31 19:10:28 +03:00
- [FromScratch ](https://fromscratch.rocks/ )
2018-09-20 07:04:12 +03:00
- [PEP20.org ](https://pep20.org/ )
2016-07-18 18:02:34 +03:00
2015-07-16 20:13:24 +03:00
### Alternatives
2020-05-18 00:34:17 +03:00
Free monospaced fonts with ligatures:
2020-04-09 19:56:19 +03:00
- [Hasklig ](https://github.com/i-tu/Hasklig )
- [Monoid ](http://larsenwork.com/monoid/ )
- [Fixedsys Excelsior ](https://github.com/kika/fixedsys )
- [Iosevka ](https://be5invis.github.io/Iosevka/ )
- [DejaVu Sans Code ](https://github.com/SSNikolaevich/DejaVuSansCode )
- [Victor Mono ](https://rubjo.github.io/victor-mono/ )
- [Cascadia Code ](https://github.com/microsoft/cascadia-code )
- [JetBrains Mono ](https://github.com/JetBrains/JetBrainsMono )
Paid monospaced fonts with ligatures:
- [PragmataPro ](http://www.fsd.it/fonts/pragmatapro.htm )
2021-01-05 15:06:04 +03:00
- [Mono Lisa ](https://www.monolisa.dev/ )
2015-07-16 20:13:24 +03:00
2019-05-21 17:21:07 +03:00
### Building Fira Code locally
2019-04-04 23:05:55 +03:00
2020-07-14 09:03:51 +03:00
In case you want to alter FiraCode.glyphs and build OTF/TTF/WOFF files yourself, this is the setup I use on macOS:
2019-04-04 23:05:55 +03:00
2019-05-21 17:21:07 +03:00
```bash
# install all required build tools
2021-11-12 05:04:44 +03:00
./script/bootstrap_macos.sh
2019-04-04 23:05:55 +03:00
2019-05-21 17:21:07 +03:00
# build the font files
2021-11-12 05:04:44 +03:00
./script/build.sh
2019-05-21 17:21:07 +03:00
# install OTFs to ~/Library/Fonts
2021-11-12 05:04:44 +03:00
cp distr/otf/*.otf ~/Library/Fonts
```
Alternatively, you can build Fira Code using Docker:
```bash
# install dependencies in a container and build the font files
make
# package the font files from dist/ into a zip
make package
2019-05-21 17:21:07 +03:00
```
2019-04-04 23:05:55 +03:00
2022-03-08 14:33:10 +03:00
If you want to *permanently enable* certain style sets or character variations, maybe because your editor of choice does not allow you to toggle these individually, you can provide the desired features as a comma separated list to the build script via the `-f / --features` flag.< br > Default: none.
To separate different versions of your font you can specify the desired font family name with the `-n / --family-name` flag. The special value 'features' will append a sorted, space separated list of enabled features to the default family name.< br > Default: "Fira Code"
You can also limit the font weights that will be created with the `-w / --weights` option.< br > Default: "Light,Regular,Retina,Medium,SemiBold,Bold"
```bash
# locally in your shell
./script/build.sh --features "ss02,ss08,ss10,cv03,cv07,cv14" --family-name "Fira Code straight" --weights "Regular,Bold"
# or via a docker container (creates the family name 'Fira Code cv01 cv02 cv06 cv31 onum ss01 ss03 ss04 zero')
docker run --rm -v "${PWD}":/opt tonsky/firacode:latest ./script/build.sh -f "cv01,cv02,cv06,ss01,zero,onum,ss03,ss04,cv31" -n "features"
2023-04-27 01:10:41 +03:00
# in Git Bash from Git for Windows, or any other MSYS2 based shell, you might need to disable path conversion
MSYS2_ARG_CONV_EXCL="*" docker run --rm -v "${PWD}":/opt tonsky/firacode:latest ./script/build.sh -f "ss02,ss03,ss04,ss05,ss06,ss07"
2022-03-08 14:33:10 +03:00
```
2014-11-11 22:47:04 +03:00
### Credits
2016-04-16 18:16:36 +03:00
- Author: Nikita Prokopov [@nikitonsky ](https://twitter.com/nikitonsky )
- Based on: [Fira Mono ](https://github.com/mozilla/Fira )
2018-09-20 07:04:12 +03:00
- Inspired by: [Hasklig ](https://github.com/i-tu/Hasklig )