# Install bookloupe with Homebrew

List common formatting errors in a Project Gutenberg candidate file. Version 2.0 via Homebrew; verified 2026-05-19.

## Install

```sh
sudo av install brew:bookloupe
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install bookloupe
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:bookloupe
- **Package manager:** Homebrew
- **Version:** 2.0
- **Source summary:** List common formatting errors in a Project Gutenberg candidate file
- **Homepage:** <http://www.juiblex.co.uk/pgdp/bookloupe/>
- **Last updated:** 2026-05-19T13:03:28-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- bookloupe (alias)
- loupe-test (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.0
## Project history and usage

bookloupe is a small proofreading helper for Project Gutenberg and Distributed Proofreaders workflows. It scans candidate text files for common formatting mistakes rather than acting as a general prose linter.

### Project history

The supplied official homepage and documentation identify bookloupe with Project Gutenberg candidate-file checking. Its Mercurial repository URL in the current curation points to the author's project host, which fits the older small-tool pattern of a personal website plus lightweight source-control browser.

### Adoption history

Adoption appears narrow and community-specific. The input package metadata lists Homebrew as the only package manager, suggesting that bookloupe is packaged mainly for users who already know the Project Gutenberg proofreading workflow and want the CLI available on macOS.

### How it is used

Users run bookloupe on a candidate text file to list likely formatting errors. The current curation records an ini-file search path that starts in the working directory and program directory, then falls back to XDG-style Unix config paths or a Windows local application-data file.

### Why package nerds care

bookloupe is interesting as a preservation-workflow package: a tiny, domain-specific CLI that exists because a volunteer text-production process needed repeatable local checks. Its package-manager footprint is small, but that is exactly the kind of niche tool package indexes keep discoverable.

### Timeline

- Unknown: Project originated as a Project Gutenberg or Distributed Proofreaders formatting checker.
- Unknown: Official documentation and Mercurial repository hosted under juiblex.co.uk.
- Current input: Homebrew packages bookloupe with the `bookloupe` and `loupe-test` executables.

### Related projects

- Project Gutenberg is the target publication ecosystem named in the package description.
- Distributed Proofreaders is implied by the official pgdp homepage path and the candidate-file proofreading workflow.

### Sources

- current_curation.config-file-location
- current_curation.repo
- source_facts.description
- source_facts.executables
- source_facts.homepage
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: bookloupe.ini in the current working directory, bookloupe.ini in the directory containing the bookloupe program, $XDG_CONFIG_HOME/bookloupe.ini, ~/.config/bookloupe.ini
- Windows: bookloupe.ini in the current working directory, bookloupe.ini in the directory containing the bookloupe program, %LOCALAPPDATA%\bookloupe.ini

## Combined YAML source

View the package source record on GitHub. [combined/bookloupe.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bookloupe.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph