FiraCode README

The project's README from github.com/tonsky/FiraCode. As one markdown file: README.md.

Fira Code: free monospaced font with programming ligatures

Fira Code

Read in Español | 简体中文 | 日本語 | Português brasileiro

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.2.zip - December 6, 2021 - 2.5 MB

Then:

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 (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

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. Implementation detail: there is no way for programs to detect whether a font has progress bar glyphs at U+EE00, so they need to decide what to output without knowing if it will be rendered properly or not. We propose a new environment variable, UNICODE_PROGRESS_BAR=true, to use as a heuristic. If present, it’s safe to assume U+EE00..EE0B will be rendered properly.

Unicode coverage makes Fira Code a great choice for mathematical writing:

How does it look?

Editor compatibility list

Works Doesn’t work
Arduino IDE (2.0+,same instructions as vscode) Adobe Dreamweaver
Abricotine Delphi IDE
Android Studio (2.3+, instructions) Standalone Emacs (workaround)
Anjuta (unless at the EOF) IDLE
AppCode (2016.2+, instructions) KDevelop 4
Atom 1.1 or newer (instructions) Monkey Studio IDE
BBEdit (14.6+ instructions) UltraEdit (Windows)
Brackets (with this plugin)
Chocolat
CLion (2016.2+, instructions)
Cloud9 (instructions)
Coda 2
CodeLite
CodeRunner
Comma (Under: Preferences > Editor > Font)
CotEditor
Eclipse
EditPad
elementary Code
Geany (1.37+)
gEdit / Pluma
GNOME Builder
Godot
GoormIDE (instructions)
gVim (Windows, GTK)
IntelliJ IDEA (2016.2+, instructions)
Kate, KWrite
KDevelop 5+
Komodo
Leafpad
LibreOffice
LightTable (instructions)
LINQPad
MacVim 7.4 or newer (instructions)
Mancy
MATLAB (instructions)
Meld
Mousepad
NeoVim-gtk
NetBeans
Notepad (Windows)
Notepad++ (instructions)
Notepad3 (instructions)
Nova
PhpStorm (2016.2+, instructions)
PyCharm (2016.2+, instructions)
QOwnNotes (21.16.6+)
QtCreator
Rider
RStudio (instructions)
RubyMine (2016.2+, instructions)
Scratch
Scribus (1.5.3+)
SublimeText (3146+)
Spyder IDE (only with Qt5)
SuperCollider 3
TeXShop
TextAdept (Linux, macOS)
TextEdit
TextMate 2
UltraEdit (UEX) (Linux)
VimR (instructions)
Visual Studio (2015+, instructions)
Visual Studio Code (instructions)
WebStorm (2016.2+, instructions)
Xamarin Studio/Monodevelop
Xcode (8.0+, otherwise with plugin)
Xi
Probably work: Smultron, Vico Under question: Code::Blocks IDE
Zed (instructions)

Terminal compatibility list

Works Doesn’t work
crosh (instructions) Alacritty
Ghostty Asbru Connection Manager
Hyper (see #3607) Cmder
iTerm 2 ConEmu
Kitty GNOME Terminal (ticket)
Konsole gtkterm (ticket)
Mintty guake (ticket)
QTerminal LXTerminal (ticket)
st (patch) mate-terminal
Tabby PuTTY
Terminal.app rxvt
Termux sakura (ticket)
Token2Shell SecureCRT
Wez’s terminal Terminator (ticket)
Windows Terminal terminology
ZOC (macOS) Tilix
Windows Console
xfce4-terminal (ticket)
xterm
ZOC (Windows)

Browser support

<!-- HTML -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/distr/fira_code.css">
/* CSS */
@import url(https://cdn.jsdelivr.net/npm/[email protected]/distr/fira_code.css);
/* Specify in CSS */
code { font-family: 'Fira Code', monospace; }

@supports (font-variation-settings: normal) {
  code { font-family: 'Fira Code VF', monospace; }
}

Projects using Fira Code

Alternatives

Free monospaced fonts with ligatures:

Paid monospaced fonts with ligatures:

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:

# 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:

# install dependencies in a container and build the font files
make

# package the font files from dist/ into a zip
make package

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.
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.
Default: "Fira Code"

You can also limit the font weights that will be created with the -w / --weights option.
Default: "Light,Regular,Retina,Medium,SemiBold,Bold"

# 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"

# 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"

Credits

FiraCode (tonsky/FiraCode)

Searching Database…

82.1K ·GitHub
这是什么?Fira Code 是一款免费的等宽字体,专为程序员设计。它使用连字技术,把常见的多字符符号组合(如 -> 或 ==)显示为一个单独的字形,更容易阅读。
这是字体文件还是代码编辑器插件?它只是一款字体(基于 Fira Mono),需要安装到系统中。连字的显示由编辑器、终端或浏览器负责,而不是字体安装程序本身。
我该如何安装并启用它?像安装其他字体一样下载并安装,然后按照具体编辑器或终端的说明启用连字支持。许多应用需要打开类似 'calt' 或 'font-variant-ligatures: contextual' 的设置。
我用的任何编辑器或终端都能显示连字吗?不一定,支持情况差异很大。许多常用工具,如 IDLE、Dreamweaver、Alacritty、ConEmu、GNOME Terminal 和 PuTTY,根本不显示连字,所以请先查看兼容性表格。
这款字体主要面向谁?面向那些经常盯着符号密集代码看的程序员,希望常见的运算符组合能像一个整体的视觉单元那样更易读。
我可以自定义要生成哪些风格集或字重吗?可以。构建脚本支持 -f/--features 参数来指定风格集和字符变体,也支持 -w/--weights 参数来限制生成哪些字重(Light、Regular、Retina、Medium、SemiBold、Bold)。
什么是进度条功能?Fira Code 是第一款为终端界面中的进度条提供专用字形的编程字体,字形位于 U+EE00-EE0B。同时还提议了一个 UNICODEPROGRESSBAR 环境变量,作为检测方式的启发式判断。
如果 Fira Code 不适合我的需求,有没有其他替代字体?README 中列出了一些免费替代品,如 Hasklig、Iosevka、Cascadia Code 和 JetBrains Mono,还有付费选项,如 PragmataPro 和 Mono Lisa。
它在数学符号或框线字符方面表现如何?表现很好。它对 Unicode 数学符号覆盖面广,并专门支持控制台界面中使用的 ASCII、框线字符(box drawing)和 Powerline 符号。
Creator
tonsky
Size
88.5 MB
Stars
82.1K
Age
11y
Commits · 90 Days