---
title: Moji documentation
description: Find, inspect, and safely download fonts from the terminal.
icon: Search
---

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.

<Cards>
  <Card title="Install and find a font" href="/docs/tutorial" description="Start with the guided tutorial." />
  <Card title="Solve a specific task" href="/docs/how-to/search-and-filter" description="Use focused how-to guides." />
  <Card title="Convert font formats" href="/docs/how-to/convert-font-formats" description="Convert TTF or OTF to WOFF2, or restore a WOFF2 font." />
  <Card title="Look up a command" href="/docs/reference/cli" description="Read the complete CLI reference." />
  <Card title="Understand the design" href="/docs/explanation/architecture" description="Learn how providers, ranking, and downloads fit together." />
</Cards>

## Install

Choose the package manager you already use:

```sh
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.

## Two ways to work

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

```sh
moji
```

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

```sh
moji "Futura"
```

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

```sh
moji get "Futura bold"
```

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