Moji documentation

Moji is a terminal font finder for people and scripts. It searches enabled providers concurrently, normalizes font filenames, ranks likely matches, and downloads through a validation pipeline.

Install and find a font

Start with the guided tutorial.

Solve a specific task

Use focused how-to guides.

Convert font formats

Convert TTF or OTF to WOFF2, or restore a WOFF2 font.

Look up a command

Read the complete CLI reference.

Understand the design

Learn how providers, ranking, and downloads fit together.

Install

Choose the package manager you already use:

npm install -g @microck/moji
pnpm add -g @microck/moji
bun add -g @microck/moji

All three commands install the same npm-registry package. It includes binaries for Linux, macOS, and Windows on x64 and arm64.

On macOS or Linux, the repository-owned Homebrew formula installs the native binary from that same release archive:

brew tap microck/moji https://github.com/Microck/moji
brew install microck/moji/moji

Two ways to work

Run a search in a terminal to open the live interface:

moji

Type a family and press enter, or jump directly to results:

moji "Futura"

Use get for a non-interactive search, selection, and download:

moji get "Futura bold"

Use --dry-run before downloading and --json when another program will read the result.