README.rst
1Powerline fonts
2===============
3
4This repository contains pre-patched and adjusted fonts for usage with
5the `Powerline <https://github.com/powerline/powerline>`_ statusline plugin.
6
7Installation
8------------
9
10Run ``./install.sh`` to install all Powerline Fonts or see the documentation_ for details.
11
12.. _documentation: https://powerline.readthedocs.org/en/latest/installation/linux.html#fonts-installation
13
14Quick installation
15------------------
16
17If you are running a Debian or Ubuntu based Linux distribution, there should
18be a package available to install the Powerline Fonts with the following command:
19::
20 sudo apt-get install fonts-powerline
21
22For fedora (tested on 28) or redhat based Linux distribution, there should also be a package available to install with the following command:
23::
24 sudo dnf install powerline-fonts
25
26On other environments, you can copy and paste these commands to your terminal. Comments are fine too.
27::
28 # clone
29 git clone https://github.com/powerline/fonts.git --depth=1
30 # install
31 cd fonts
32 ./install.sh
33 # clean-up a bit
34 cd ..
35 rm -rf fonts
36
37Uninstall
38---------
39
40Run ``./uninstall.sh`` to uninstall all Powerline Fonts. You can also copy
41the quick installation commands changing only the line ``./install.sh`` to
42``./uninstall.sh``.
43
44In both cases, please make sure you are working with the exact same version
45of Powerline fonts you had checked out while installing.
46
47Font Families
48-------------
49
50======================================= ========================= ====================================
51 Powerline Font Family Formerly Known As License
52======================================= ========================= ====================================
53 3270 3270 BSD/CCAS 3.0
54 Anonymice Powerline Anonymous Pro SIL Open Font License, Version 1.1
55 Arimo Powerline Arimo Apache License, Version 2.0
56 Cousine Powerline Cousine Apache License, Version 2.0
57 D2Coding for Powerline D2Coding SIL Open Font License, Version 1.1
58 DejaVu Sans Mono for Powerline DejaVu Sans Mono DejaVu Fonts License, Version 1.0
59 Droid Sans Mono for Powerline Droid Sans Mono Apache License, Version 2.0
60 Droid Sans Mono Dotted for Powerline Droid Sans Mono Dotted Apache License, Version 2.0
61 Droid Sans Mono Slashed for Powerline Droid Sans Mono Slashed Apache License, Version 2.0
62 Fira Mono for Powerline Fira Mono SIL OPEN FONT LICENSE Version 1.1
63 Go Mono for Powerline Go Mono Go's License
64 Hack Hack SIL OFL, v1.1 + Bitstream License
65 Inconsolata for Powerline Inconsolata SIL Open Font License, Version 1.0
66 Inconsolata-dz for Powerline Inconsolata-dz SIL Open Font License, Version 1.0
67 Inconsolata-g for Powerline Inconsolata-g SIL Open Font License, Version 1.0
68 Input Mono Input Mono `Input’s license <http://input.fontbureau.com/license/>`_
69 Liberation Mono Powerline Liberation Mono SIL Open Font License, Version 1.1
70 ProFontWindows ProFont for Powerline MIT License
71 Meslo for Powerline Meslo Apache License, Version 2.0
72 Source Code Pro for Powerline Source Code Pro SIL Open Font License, Version 1.1
73 Meslo Dotted for Powerline Meslo Dotted Apache License, Version 2.0
74 Meslo Slashed for Powerline Meslo Dotted Apache License, Version 2.0
75 Monofur for Powerline Monofur Freeware
76 Noto Mono for Powerline Noto Mono SIL Open Font License, Version 1.1
77 Roboto Mono for Powerline Roboto Mono Apache License, Version 2.0
78 Symbol Neu Powerline Symbol Neu Apache License, Version 2.0
79 Terminess Powerline Terminus SIL Open Font License, Version 1.1
80 Tinos Powerline Tinos Apache License, Version 2.0
81 Ubuntu Mono derivative Powerline Ubuntu Mono Ubuntu Font License, Version 1.0
82 Space Mono for Powerline Space Mono SIL Open Font License, Version 1.1
83======================================= ========================= ====================================
84
85iTerm2 users need to set both the Regular font and the Non-ASCII Font in
86"iTerm > Preferences > Profiles > Text" to use a patched font (per `this issue`__).
87
88__ https://github.com/Lokaltog/powerline-fonts/issues/44
89
90Fontconfig
91----------
92
93In some distributions, Terminess Powerline is ignored by default and must be
94explicitly allowed. A fontconfig file is provided which enables it. Copy `this
95file <https://github.com/powerline/fonts/blob/master/fontconfig/50-enable-terminess-powerline.conf>`_
96from the fontconfig directory to your home folder under ``~/.config/fontconfig/conf.d``
97(create it if it doesn't exist) and re-run ``fc-cache -vf``.
98