README.md (5696B)
1 # Spleen 2 3 Spleen is a monospaced bitmap font available in 6 sizes: 4 5 - 5x8 6 - 6x12 7 - 8x16 8 - 12x24 9 - 16x32 10 - 32x64 11 12 Each size is provided in the Glyph Bitmap Distribution Format (BDF), and 13 release tarballs contain the fonts in the following formats: `PCF`, `PSF` 14 (for the Linux console), and `OTF`. 15 16 All font sizes contain all ISO/IEC 8859-1 characters (Basic Latin and Latin-1 17 Supplement Unicode block), Latin Extended-A characters, as well as Box Drawing, 18 Block Elements, and Braille Patterns Unicode blocks, except for the 5x8 and the 19 6x12 versions. 20 21 Due to character size constraints, the 5x8 version only contains printable 22 ASCII characters, the Braille Patterns Unicode block, and light Box Drawing 23 characters. Please also note that there is no OpenType version for this size. 24 25 As of Spleen 1.8.0, there is now a 6x12 version containing the same Unicode 26 blocks as the 5x8 version and the Latin-1 Supplement Unicode block. 27 28 Spleen also has support for Powerline symbols out of the box. 29 30 The font name is a reference to Baudelaire. 31 32 ## Screenshots 33 34 The following screenshots show Spleen 16x32 displaying code and prose. 35 36 ![Spleen - Hello][1] 37 38 ![Spleen - L'etranger][2] 39 40 ASCII characters for all sizes: 41 42 Spleen 5x8: 43 44 ![Spleen - ASCII characters - 5x8][3] 45 46 Spleen 6x12: 47 48 ![Spleen - ASCII characters - 6x12][4] 49 50 Spleen 8x16: 51 52 ![Spleen - ASCII characters - 8x16][5] 53 54 Spleen 12x24: 55 56 ![Spleen - ASCII characters - 12x24][6] 57 58 Spleen 16x32: 59 ![Spleen - ASCII characters - 16x32][7] 60 61 Spleen 32x64: 62 ![Spleen - ASCII characters - 32x64][8] 63 64 ## XLFD font names 65 66 ``` 67 -misc-spleen-medium-r-normal--8-80-72-72-c-50-iso10646-1 68 -misc-spleen-medium-r-normal--12-120-72-72-c-60-iso10646-1 69 -misc-spleen-medium-r-normal--16-160-72-72-c-80-iso10646-1 70 -misc-spleen-medium-r-normal--24-240-72-72-c-120-iso10646-1 71 -misc-spleen-medium-r-normal--32-320-72-72-c-160-iso10646-1 72 -misc-spleen-medium-r-normal--64-640-72-72-c-320-iso10646-1 73 ``` 74 75 ## Packages 76 77 Packages are available for the following operating systems: 78 79 - [OpenBSD][9] 80 - [NetBSD][10] 81 - [FreeBSD][11] 82 - [Arch Linux][12] 83 - [Void Linux][13] 84 - [Nix][14] 85 - [Debian][15] 86 - [Ubuntu][16] 87 88 ## Manual installation 89 90 ### *BSD and Linux 91 92 Clone the repository, convert the files to the Portable Compiled Format 93 (PCF) using **bdftopcf** and run **mkfontdir** in the directory. 94 95 Alternatively, release tarballs provide PCF files for each size. 96 97 ### macOS 98 99 macOS users should use the `.otf` files provided in the release tarballs. 100 101 Since version 1.7.0, `.dfont` files are not generated anymore. 102 103 ### Windows 104 105 Windows users should use the `.otf` files provided in the release tarballs. 106 107 ## Usage 108 109 ### *BSD and Linux 110 111 Update the font path to include **Spleen**: 112 113 xset +fp /usr/local/share/fonts/spleen/ 114 115 Update **.Xdefaults** and add one of the following directives: 116 117 xterm*faceName: spleen:pixelsize=8:antialias=false 118 xterm*faceName: spleen:pixelsize=12:antialias=false 119 xterm*faceName: spleen:pixelsize=16:antialias=false 120 xterm*faceName: spleen:pixelsize=24:antialias=false 121 xterm*faceName: spleen:pixelsize=32:antialias=false 122 xterm*faceName: spleen:pixelsize=64:antialias=false 123 124 Launch **xterm**. 125 126 Ubuntu has bitmap fonts support disabled by default, instructions to enable 127 it are available [here][17]. 128 129 ### Linux console 130 131 Release tarballs provide PSF files for each size, `setfont` can be used 132 to load and set the desired font. 133 134 ### NetBSD console 135 136 NetBSD has .fnt files for each size which can be loaded using wsfontload(8). 137 138 For example, to load Spleen 16x32: 139 140 wsfontload -N spleen-16x32 -w 16 -h 32 /usr/share/wscons/fonts/spleen-16x32.fnt 141 wsconsctl -dw font=spleen-16x32 142 143 ### FreeBSD console 144 145 The FreeBSD package contains .fnt files which can be loaded using 146 vidcontrol(1). 147 148 For example, to load Spleen 16x32: 149 150 vidcontrol -f /usr/local/share/fonts/spleen/spleen-16x32.fnt 151 152 ### OpenType versions 153 154 Spleen release tarballs now contains OTF versions generated automatically 155 from the BDF files, using [bdf2sfd][18]. Each font has a different name, 156 allowing them to be installed alongside. 157 158 They should be used in the exact size specified below, with anti-aliasing 159 disabled. 160 161 - Spleen 6x12: 9 Pt (12 pixels) 162 - Spleen 8x16: 12 Pt (16 pixels) 163 - Spleen 12x24: 18 Pt (24 pixels) 164 - Spleen 16x32: 24 Pt (32 pixels) 165 - Spleen 32x64: 48 Pt (64 pixels) 166 167 ## License 168 169 Spleen is released under the BSD 2-Clause license. See `LICENSE` file for 170 details. 171 172 ## Author 173 174 Spleen is developed by Frederic Cambus. 175 176 - Site: https://www.cambus.net 177 178 ## Resources 179 180 GitHub: https://github.com/fcambus/spleen 181 182 183 ## Trivia 184 185 - Spleen is the default font for OpenBSD consoles since January 2019 186 - Spleen was imported in the NetBSD src tree in March 2019 187 188 [1]: https://www.cambus.net/content/2018/09/spleen-hello.png 189 [2]: https://www.cambus.net/content/2018/09/spleen-etranger.png 190 [3]: https://www.cambus.net/files/spleen/spleen-5x8.png 191 [4]: https://www.cambus.net/files/spleen/spleen-6x12.png 192 [5]: https://www.cambus.net/files/spleen/spleen-8x16.png 193 [6]: https://www.cambus.net/files/spleen/spleen-12x24.png 194 [7]: https://www.cambus.net/files/spleen/spleen-16x32.png 195 [8]: https://www.cambus.net/files/spleen/spleen-32x64.png 196 [9]: https://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/fonts/spleen/ 197 [10]: https://pkgsrc.se/fonts/spleen 198 [11]: https://www.freshports.org/x11-fonts/spleen/ 199 [12]: https://aur.archlinux.org/packages/bdf-spleen/ 200 [13]: https://github.com/void-linux/void-packages/tree/master/srcpkgs/font-spleen 201 [14]: https://github.com/NixOS/nixpkgs/tree/master/pkgs/data/fonts/spleen 202 [15]: https://packages.debian.org/search?keywords=spleen 203 [16]: https://packages.ubuntu.com/search?keywords=spleen 204 [17]: https://wiki.ubuntu.com/Fonts#Enabling_Bitmapped_Fonts 205 [18]: https://github.com/fcambus/bdf2sfd