fonts README

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

Powerline fonts

This repository contains pre-patched and adjusted fonts for usage with the Powerline <https://github.com/powerline/powerline>_ statusline plugin.

Installation

Run ./install.sh to install all Powerline Fonts or see the documentation_ for details.

.. _documentation: https://powerline.readthedocs.org/en/latest/installation/linux.html#fonts-installation

Quick installation

If you are running a Debian or Ubuntu based Linux distribution, there should be a package available to install the Powerline Fonts with the following command: :: sudo apt-get install fonts-powerline

For fedora (tested on 28) or redhat based Linux distribution, there should also be a package available to install with the following command: :: sudo dnf install powerline-fonts On other environments, you can copy and paste these commands to your terminal. Comments are fine too. :: # clone git clone https://github.com/powerline/fonts.git --depth=1 # install cd fonts ./install.sh # clean-up a bit cd .. rm -rf fonts

Uninstall

Run ./uninstall.sh to uninstall all Powerline Fonts. You can also copy the quick installation commands changing only the line ./install.sh to ./uninstall.sh.

In both cases, please make sure you are working with the exact same version of Powerline fonts you had checked out while installing.

Font Families

======================================= ========================= ==================================== Powerline Font Family Formerly Known As License ======================================= ========================= ==================================== 3270 3270 BSD/CCAS 3.0 Anonymice Powerline Anonymous Pro SIL Open Font License, Version 1.1 Arimo Powerline Arimo Apache License, Version 2.0 Cousine Powerline Cousine Apache License, Version 2.0 CPMono_v07 CPMono_v07 Attribution 3.0 Germany (CC BY 3.0 DE) D2Coding for Powerline D2Coding SIL Open Font License, Version 1.1 DejaVu Sans Mono for Powerline DejaVu Sans Mono DejaVu Fonts License, Version 1.0 Droid Sans Mono for Powerline Droid Sans Mono Apache License, Version 2.0 Droid Sans Mono Dotted for Powerline Droid Sans Mono Dotted Apache License, Version 2.0 Droid Sans Mono Slashed for Powerline Droid Sans Mono Slashed Apache License, Version 2.0 Fira Mono for Powerline Fira Mono SIL OPEN FONT LICENSE Version 1.1 Go Mono for Powerline Go Mono Go's License Hack Hack SIL OFL, v1.1 + Bitstream License Inconsolata for Powerline Inconsolata SIL Open Font License, Version 1.0 Inconsolata-dz for Powerline Inconsolata-dz SIL Open Font License, Version 1.0 Inconsolata-g for Powerline Inconsolata-g SIL Open Font License, Version 1.0 Input Mono Input Mono Input’s license <http://input.fontbureau.com/license/>_ Liberation Mono Powerline Liberation Mono SIL Open Font License, Version 1.1 ProFontWindows ProFont for Powerline MIT License Meslo for Powerline Meslo Apache License, Version 2.0 Source Code Pro for Powerline Source Code Pro SIL Open Font License, Version 1.1 Meslo Dotted for Powerline Meslo Dotted Apache License, Version 2.0 Meslo Slashed for Powerline Meslo Dotted Apache License, Version 2.0 Monofur for Powerline Monofur Freeware Noto Mono for Powerline Noto Mono SIL Open Font License, Version 1.1 Roboto Mono for Powerline Roboto Mono Apache License, Version 2.0 Symbol Neu Powerline Symbol Neu Apache License, Version 2.0 Terminess Powerline Terminus SIL Open Font License, Version 1.1 Tinos Powerline Tinos Apache License, Version 2.0 Ubuntu Mono derivative Powerline Ubuntu Mono Ubuntu Font License, Version 1.0 Space Mono for Powerline Space Mono SIL Open Font License, Version 1.1 ======================================= ========================= ====================================

iTerm2 users need to set both the Regular font and the Non-ASCII Font in "iTerm > Preferences > Profiles > Text" to use a patched font (per this issue__).

__ https://github.com/Lokaltog/powerline-fonts/issues/44

Fontconfig

In some distributions, Terminess Powerline is ignored by default and must be explicitly allowed. A fontconfig file is provided which enables it. Copy this file <https://github.com/powerline/fonts/blob/master/fontconfig/50-enable-terminess-powerline.conf>_ from the fontconfig directory to your home folder under ~/.config/fontconfig/conf.d (create it if it doesn't exist) and re-run fc-cache -vf.

fonts (powerline/fonts)

Searching Database…

26.3K ·GitHub
What is this?A collection of pre-patched fonts (Powerline symbols already added) for use with the Powerline vim/shell status line plugin, so you don't have to patch fonts yourself.
Is this a font or a plugin?It's just font files (TTF/OTF) plus install scripts; Powerline itself (the status line plugin) is a separate project.
How do I install the fonts?Clone the repo and run './install.sh', or install individual fonts from their subfolders, then select the patched font (e.g. 'Terminess Powerline') in your terminal's profile/font settings.
Do I need anything besides cloning the repo?No build tools needed; just git and a shell to run the install script. On some Linux distros you additionally need to register the font with fontconfig.
Is a patched font enough, or are there extra steps?On some distributions the Terminess Powerline font is ignored by default and must be explicitly allowed via a provided fontconfig file, then you need to re-run 'fc-cache -vf' to refresh the font cache.
Does this work on Linux and macOS terminals?Yes, it includes install/setup instructions for both Linux (via fontconfig) and macOS terminal profiles.
What is Powerline, and why do I need special fonts for it?Powerline is a status line plugin (for vim, tmux, shells) that displays special arrow and separator glyphs; regular fonts don't include those glyphs, so you need a font that has been 'patched' with Powerline's symbol set.
Can I patch my own favorite font instead of using the ones here?Yes, this repo is just a convenience collection of already-patched popular fonts; the actual patching tool lives in the separate powerline-fonts/fontpatcher project if you want to patch a custom font yourself.
Will this fix the broken arrows and symbols I see in my prompt?Yes, once you install a patched font from this repo and select it in your terminal, the Powerline separator/arrow glyphs will render correctly instead of showing as boxes or missing characters.
Creator
powerline
Size
20.7 MB
Stars
26.3K
Age
13y
Commits · 90 Days