## Fira Code: free monospaced font with programming ligatures ![Fira Code](./extras/logo.svg) ### Problem 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. ### Solution 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. ### Download & Install Fira_Code_v6.1.zip - December 3, 2021 - 2.9 MB Then: - [How to Install](https://github.com/tonsky/FiraCode/wiki) - [Troubleshooting](https://github.com/tonsky/FiraCode/wiki#troubleshooting) - [News & Updates](https://twitter.com/FiraCode) ### Support Sponsor 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! ### What’s in the box? Left: ligatures as rendered in Fira Code. Right: same character sequences without ligatures. 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! Fira Code is not only about ligatures. Some fine-tuning is done for punctuation and frequent letter pairs. Fira Code comes with a few different character variants, so that everyone can choose what’s best for them. [How to enable](https://github.com/tonsky/FiraCode/wiki/How-to-enable-stylistic-sets) Some ligatures can be altered or enabled using stylistic sets/character variants: Being a programming font, Fira Code has fantastic support for ASCII/box drawing, powerline and other forms of console UIs: Fira Code is the first programming font to offer dedicated glyphs to render progress bars: In action: 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: ### How does it look? ### Editor compatibility list | Works | Doesn’t work | |-------|----------------| | **Abricotine** | **Arduino IDE** | | **Android Studio** (2.3+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | **Adobe Dreamweaver** | | **Anjuta** (unless at the EOF) | **Delphi IDE** | | **AppCode** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | Standalone **Emacs** ([workaround](https://github.com/tonsky/FiraCode/wiki/Emacs-instructions)) | | **Atom** 1.1 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/Atom-instructions)) | **Godot** ([issue](https://github.com/godotengine/godot/issues/9961)) | | **BBEdit/TextWrangler** (v. 11 only, [instructions](https://github.com/tonsky/FiraCode/wiki/BBEdit-instructions)) | **gVim** (Windows [workaround](https://github.com/tonsky/FiraCode/issues/462)) | | **Brackets** (with [this plugin](https://github.com/polo2ro/firacode-in-brackets)) | **IDLE** | | **Chocolat** | **KDevelop 4** | | **CLion** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | **Monkey Studio IDE** | | **Cloud9** ([instructions](https://github.com/tonsky/FiraCode/wiki/Cloud9-Instructions)) | **UltraEdit** | | **Coda 2** | | **CodeLite** | | **CodeRunner** | | **CotEditor** | | **Eclipse** | | **elementary Code** | | **Geany** (1.37+) | | **gEdit / Pluma** | | **GNOME Builder** | | **GoormIDE** ([instructions](https://github.com/tonsky/FiraCode/wiki/GoormIDE-Instructions)) | | **IntelliJ IDEA** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | | **Kate, KWrite** | | **KDevelop 5+** | | **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** | | **MATLAB** ([instructions](https://github.com/tonsky/FiraCode/wiki/MATLAB-for-Windows-Instructions)) | | **Meld** | | **Mousepad** | | **NeoVim-gtk** | | **NetBeans** | | **Notepad** (Windows) | | **Notepad++** (with a [workaround](https://github.com/notepad-plus-plus/notepad-plus-plus/issues/2287#issuecomment-256638098)) | | **Notepad3** ([instructions](https://github.com/rizonesoft/Notepad3/issues/361#issuecomment-365977420))| | **Nova** | | **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)) | | **QOwnNotes** (21.16.6+) | | **QtCreator** | | **Rider** | | **RStudio** ([instructions](https://github.com/tonsky/FiraCode/wiki/RStudio-instructions)) | | **RubyMine** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | | **Scratch** | | **Scribus** (1.5.3+) | | **SublimeText** (3146+) | | **Spyder IDE** (only with Qt5) | | **SuperCollider 3** | | **TextAdept** (Linux, macOS) | | **TextEdit** | | **TextMate 2** | | **VimR** ([instructions](https://github.com/qvacua/vimr/wiki#ligatures)) | | **Visual Studio** (2015+, [instructions](https://github.com/tonsky/FiraCode/wiki/Visual-Studio-Instructions)) | | **Visual Studio Code** ([instructions](https://github.com/tonsky/FiraCode/wiki/VS-Code-Instructions)) | | **WebStorm** (2016.2+, [instructions](https://github.com/tonsky/FiraCode/wiki/Intellij-products-instructions)) | | **Xamarin Studio/Monodevelop** | | **Xcode** (8.0+, otherwise [with plugin](https://github.com/robertvojta/LigatureXcodePlugin)) | | **Xi** | | Probably work: **Smultron, Vico** | Under question: **Code::Blocks IDE** | ### Terminal compatibility list | Platform | Works | Doesn’t work | |----------------|-------|--------------| | macOS | Hyper (see [#3607](https://github.com/vercel/hyper/issues/3607))
iTerm 2
Kitty
Terminal.app
ZOC | Alacritty | | Windows | Hyper (see [#3607](https://github.com/vercel/hyper/issues/3607))
Mintty
Token2Shell
Windows Terminal | Alacritty
Cmder
ConEmu
PuTTY
Windows Console
ZOC | | Linux | Hyper (see [#3607](https://github.com/vercel/hyper/issues/3607))
Kitty
Konsole
QTerminal
Termux
st ([patch](https://st.suckless.org/patches/ligatures/)) | Alacritty
GNOME Terminal
libvte-based terminals ([bug report](https://bugzilla.gnome.org/show_bug.cgi?id=584160)): mate-terminal
rxvt
terminology
xterm | ChromeOS | crosh ([instructions](https://github.com/tonsky/FiraCode/wiki/ChromeOS-Terminal)) | | ### Browser support ```html ``` ```css /* CSS */ @import url(https://cdn.jsdelivr.net/npm/firacode@6.1.0/distr/fira_code.css); ``` ```css /* Specify in CSS */ code { font-family: 'Fira Code', monospace; } @supports (font-variation-settings: normal) { code { font-family: 'Fira Code VF', monospace; } } ``` - IE 10+, Edge Legacy: enable with `font-feature-settings: "calt";` - Firefox - Safari - Chromium-based browsers (Chrome, Opera) - ACE - CodeMirror (enable with `font-variant-ligatures: contextual;`) ### Projects using Fira Code - [CodePen](https://codepen.io/) - [Blink Shell](http://www.blink.sh/) - [Klipse](http://app.klipse.tech/) - [IlyaBirman.net](http://ilyabirman.net/) - [EvilMartians.com](https://evilmartians.com/) - [Web Maker](https://webmakerapp.com/) - [FromScratch](https://fromscratch.rocks/) - [PEP20.org](https://pep20.org/) ### Alternatives Free monospaced fonts with ligatures: - [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) - [Mono Lisa](https://www.monolisa.dev/) ### Building Fira Code locally In case you want to alter FiraCode.glyphs and build OTF/TTF/WOFF files yourself, this is the setup I use on macOS: ```bash # install all required build tools ./script/bootstrap_macos.sh # build the font files ./script/build.sh # install OTFs to ~/Library/Fonts 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 ``` ### Credits - Author: Nikita Prokopov [@nikitonsky](https://twitter.com/nikitonsky) - Based on: [Fira Mono](https://github.com/mozilla/Fira) - Inspired by: [Hasklig](https://github.com/i-tu/Hasklig) ## Which font? ### TL;DR * Pick your font family and then select from the `'complete'` directory. * If you are on Windows pick a font with the `'Windows Compatible'` suffix. * This includes specific tweaks to ensure the font works on Windows, in particular monospace identification and font name length limitations * If you are limited to monospaced fonts (because of your terminal, etc) then pick a font with the `'Mono'` suffix. * This denotes that the Nerd Font glyphs will be monospaced not necessarily that the entire font will be monospaced ### Ligatures By the *Nerd Font* policy, the variant with the `'Mono'` suffix is not supposed to have any ligatures. Use the non-*Mono* variants to have ligatures. ### Explanation Once you narrow down your font choice of family (`Droid Sans`, `Inconsolata`, etc) and style (`bold`, `italic`, etc) you have 2 main choices: #### `Option 1: Download already patched font` * download an already patched font from the `complete` folder * This is most likely the one you want. It includes **all** of the glyphs from all of the glyph sets. Only caution here is that some fonts have glyphs in the _same_ code point so to include everything some had to be moved to alternate code points. #### `Option 2: Patch your own font` * patch your own variations with the various options provided by the font patcher (see each font's readme for full list of combinations available) * This is the option you want if the font you use is _not_ already included or you want maximum control of what's included * This contains a list of _all permutations_ of the various glyphs. E.g. You want the font with only [Octicons][octicons] or you want the font with just [Font Awesome][font-awesome] and [Devicons][vorillaz-devicons]. The goal is to provide every combination possible in this folder. For more information see: [The FAQ](https://github.com/ryanoasis/nerd-fonts/wiki/FAQ-and-Troubleshooting#which-font) [vim-devicons]:https://github.com/ryanoasis/vim-devicons [vorillaz-devicons]:https://vorillaz.github.io/devicons/ [font-awesome]:https://github.com/FortAwesome/Font-Awesome [octicons]:https://github.com/primer/octicons [gabrielelana-pomicons]:https://github.com/gabrielelana/pomicons [Seti-UI]:https://atom.io/themes/seti-ui [ryanoasis-powerline-extra-symbols]:https://github.com/ryanoasis/powerline-extra-symbols [SIL-RFN]:http://scripts.sil.org/cms/scripts/page.php?item_id=OFL_web_fonts_and_RFNs#14cbfd4a