Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

Use a True Color terminal with at least 60 columns and 22 rows. See Compatibility for platform and clipboard requirements.

Installation

Cargo

Install from crates.io with Rust 1.89 or later:

cargo install --locked asinus

Homebrew (macOS)

brew install lusingander/tap/asinus

The formula is maintained in lusingander/homebrew-tap.

Release Binaries

Download an archive from GitHub Releases, extract it, and place the asinus executable on your PATH.

Operating systemArchitectureTarget
macOSApple Siliconaarch64-apple-darwin
macOSIntelx86_64-apple-darwin
LinuxARM64aarch64-unknown-linux-gnu or aarch64-unknown-linux-musl
Linuxx86-64x86_64-unknown-linux-gnu or x86_64-unknown-linux-musl

First Steps

Start Asinus:

asinus
  1. Use ↑ / ↓ to select a theme.
  2. Press p to pin it, then select another theme and press c to compare them.
  3. Use [ / ] to switch preview samples, or / to search.
  4. Press F1 for help and Ctrl-C to quit.

Continue with Explore & Compare or try your own preview sample. See Keybindings for all controls.

Run asinus --help for command line help and asinus --version to check the installed version.