# Installation

 - [Install from release](#install-from-release)
 - [Build from source](#build-from-source)
 - [Verification](#verification)
 - [Troubleshooting](#troubleshooting)

## Install from release

 1. Grab the latest release from the
[releases](https://github.com/NerdyPepper/scientifica/releases)
page.

 2. Extract the release package:
```shell
tar xzf scientifica-v1.2.tar.gz
```

3. You may install either the `ttf`s or the `otb`s or the
`bdf`s
```shell
# ttfs are recommended
cp ttf/* ~/.local/share/fonts/

# but you may install the otbs if you want to
cp otb/* ~/.local/share/fonts

# bdfs are not recommendedk
cp bdf/* ~/.local/share/fonts
```

## Build from source

Requirements:

 - java
 - [BitsNPicas](https://github.com/kreativekorp/bitsnpicas)
 - [fontforge](https://fontforge.org)
 - python3

On Debian based distros, you can install all requirements
via:
```
sudo apt install openjdk-8-jdk openjdk-8-jre python3 fontforge
curl -o BitsNPicas.jar "https://github.com/kreativekorp/bitsnpicas/blob/master/downloads/BitsNPicas.jar"
```

1. Open `build.sh` and change variable `BNP` to the full
   path to the BitsNPicas `jar` file.
```shell
# for example.:
export BNP="/home/nerdypepper/downloads/BitsNPicas.jar"
```

2. Run `build.sh`
3. If everything went well, you will find the generated font
   files under the `build` folder.
4. Continue with step 3 of "Install from release"

## Verification

Check if your installation procedure was a success:

 1. Run `fc-list | grep sci`
 2. If the output is **not** null, congrats!
 3. Proceed to [Troubleshooting](#troubleshooting) if the output is empty

## Troubleshooting

 If your application does not recognize the font, you can
try a couple of things:

 - use `ttf` variant instead of the `otb` or `bdf`
   variants
 - run `fc-cache --really-force -v` and verify again
 - open an issue, I'd love to help you out!