# 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
- **Package manager page:** <https://formulae.brew.sh/formula/bookloupe>
- **Version:** 2.0
- **Source summary:** List common formatting errors in a Project Gutenberg candidate file
- **Homepage:** <http://www.juiblex.co.uk/pgdp/bookloupe/>
- **Repository:** <http://project.juiblex.co.uk/hg/bookloupe>
- **Upstream docs:** <http://project.juiblex.co.uk/hg/bookloupe/raw-file/tip/doc/bookloupe.txt>
- **License:** GPL-2.0-only
- **Source archive:** <http://www.juiblex.co.uk/pgdp/bookloupe/bookloupe-2.0.tar.gz>
- **Last updated:** 2026-05-19T13:03:28-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

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

## Dependencies

- gettext
- glib

## Build dependencies

- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.0
- Package-manager updated: 2026-05-19
- Local data: ok
- Upstream repository: http://www.juiblex.co.uk/pgdp/bookloupe/
- info: Release/tag comparison is only available for GitHub repositories.
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** bookloupe
- **Version Scheme:** 0
- **Revision:** 1
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Web development packages](https://www.automicvault.com/pkg/web-dev-tools/) - Matched web development metadata.
- [gettext](https://www.automicvault.com/pkg/brew/gettext/) - Runtime dependency declared by Homebrew.
- [glib](https://www.automicvault.com/pkg/brew/glib/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [blazeblogger](https://www.automicvault.com/pkg/brew/blazeblogger/) - Shares av.db curated category or tags: cli, productivity, publishing.
- [faircamp](https://www.automicvault.com/pkg/brew/faircamp/) - Shares av.db curated category or tags: cli, productivity, publishing.
- [asciidoc](https://www.automicvault.com/pkg/brew/asciidoc/) - Shares av.db curated category or tags: cli, productivity, text-processing.
- [aspell](https://www.automicvault.com/pkg/brew/aspell/) - Shares av.db curated category or tags: cli, productivity, text-processing.
- [extract_url](https://www.automicvault.com/pkg/brew/extract-url/) - Shares av.db curated category or tags: cli, productivity, text-processing.
- [ispell](https://www.automicvault.com/pkg/brew/ispell/) - Shares av.db curated category or tags: cli, productivity, text-processing.
- [opendetex](https://www.automicvault.com/pkg/brew/opendetex/) - Shares av.db curated category or tags: cli, productivity, text-processing.
- [par](https://www.automicvault.com/pkg/brew/par/) - Shares av.db curated category or tags: cli, productivity, text-processing.

## Combined YAML source

View the package source record on GitHub. [combined/bookloupe.yml](https://github.com/automic-vault/db/blob/main/combined/bookloupe.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
