Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/funbox/beatrix
A tool to chop off useless fonts glyphs and convert TTF/OTF into WOFF & WOFF2
https://github.com/funbox/beatrix
font-converter fonttools glyphs otf subset ttf ttf2woff ttf2woff2 webfonts woff woff2
Last synced: about 1 month ago
JSON representation
A tool to chop off useless fonts glyphs and convert TTF/OTF into WOFF & WOFF2
- Host: GitHub
- URL: https://github.com/funbox/beatrix
- Owner: funbox
- License: mit
- Created: 2020-09-24T13:18:31.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-19T02:40:51.000Z (over 1 year ago)
- Last Synced: 2024-04-29T17:09:42.115Z (8 months ago)
- Topics: font-converter, fonttools, glyphs, otf, subset, ttf, ttf2woff, ttf2woff2, webfonts, woff, woff2
- Language: JavaScript
- Homepage:
- Size: 1.59 MB
- Stars: 41
- Watchers: 12
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Beatrix chops off useless fonts parts and converts TTF/OTF files into WOFF & WOFF2
## Rationale
Users spend a lot of time downloading web assets: JS, CSS, images, fonts, etc.
To reduce waiting time, developers compress the assets, gzip them, use optimized formats for images and fonts.
But sometimes the developers can go a little bit further. When they have all the rights for fonts they use,
it's possible to leave only the glyphs their website needs. Just cut off the rest ones.
That's exactly how the tool works.
## Getting Started
[По-русски](./README.ru.md)
First of all, the tool is a wrapper around Python scripts distributed as [fonttools](https://github.com/fonttools/fonttools).
You should install them and the deps they need to:
```sh
pip install fonttools zopfli brotli
```
Then you can install Beatrix:
```sh
npm install --save @funboxteam/beatrix
```
Now you're ready to optimize your fonts.
## Usage
Beatrix expects to get a path to directory with TTF/OTF files inside and the config with allowed characters listed.
E.g. if you clone this repo and install the tool, you will be able to run it like this:
```sh
beatrix --config ./example/config.js --output ./dist ./example
```
It will load `./example/config.js`, find all the TTF/OTF files inside `./example`, optimize & convert them to WOFF & WOFF2,
and put the results into `./dist`.
The output of this command
```text
$ beatrix --config ./example/config.js --output ./dist ./example
Output dir cleared.
------------------------
Start processing '/tmp/beatrix/example/Roboto/bold--italic.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 171 Kb → 33 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/bold--italic.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/bold.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 167 Kb → 32 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/bold.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/light--italic.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 173 Kb → 34 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/light--italic.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/light.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 167 Kb → 32 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/light.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/regular--italic.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 170 Kb → 33 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/regular--italic.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/regular.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 168 Kb → 32 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/regular.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/thin--italic.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 172 Kb → 34 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/thin--italic.ttf'.
------------------------
Start processing '/tmp/beatrix/example/Roboto/thin.ttf'...
Dest dir created: '/tmp/beatrix/dist/Roboto'.
TTF subset: 168 Kb → 32 Kb (−80%).
TTF created.
WOFF created.
WOFF2 created.
Completed processing '/tmp/beatrix/example/Roboto/thin.ttf'.
------------------------
Done.
```
### Config file
Config is a JS or JSON file which describes an object containing `CHARACTERS` and `LAYOUT_FEATURES`.
`CHARACTERS` is an array, where each item is a string describing one Unicode number or a range of them.
Each Unicode number is represented as 4 hex digits.
`LAYOUT_FEATURES` is an array of [OpenType features](https://docs.microsoft.com/en-us/typography/opentype/spec/featurelist) (e.g., `kern`, `liga`, `tnum`, etc.).
**Please note** that if no config provided, the [default config](lib/default-config.js) is used. If one of the options is not present in the config, the appropriate option from the default config is used.
Example:
```js
module.exports = {
CHARACTERS: [
// Unicode range from U+0020 to U+007E (including the last one).
// Contains: space, !, ", #, $, %, &, ', (, ), *, +, comma,
// -, dot, /, numbers, :, ;, <, =, >, ?, @, A-Z, [, \, ], ^,
// _, `, a-z, {, |, }, ~
'0020-007E',
// One Unicode number
// non-breaking space
'00A0',
// One more Unicode number
// ©
'00A9',
// ...
],
// Drop all the features except 'tnum' and 'kern'
LAYOUT_FEATURES: ['tnum', 'kern']
}
```
The characters and features described above will be left in the font files, all the rest will be cut off.
If you want to remove all the characters or features completely just pass an empty array.
[](https://funbox.ru)