momovu 0.8.0

Preview margins on book PDFs before publication.

Momovu

Preview margins on book PDFs before publication

Momovu is an based application for visualizing safety margins, spine widths, and dustjacket layouts on PDF documents. It helps publishers and designers ensure proper margins before sending books to print.

• https://momovu.org

• https://spacecruft.org/books/momovu

Features

• PDF Margin Visualization: Preview safety margins on any PDF document
• Multiple Document Types: Support for interior pages, covers, and dustjackets
• Interactive Navigation: Zoom, pan, and navigate through pages
• Presentation Mode: Full-screen presentation for reviewing layouts
• Configurable Margins: Customizable safety margins and spine dimensions
• Performance Optimized: Efficient rendering with caching and spatial indexing

Installation

System Requirements

• Python 3.9 or higher

Dependencies (Debian)

sudo apt install python3-pip python3-venv python-is-python3

Install from PyPi

The easiest install, suit to taste:

pip install momovu

Install from Source

git clone https://spacecruft.org/books/momovu
cd momovu/
python -m venv venv
source venv/bin/activate
pip install -U setuptools pip wheel
pip install -e .

Usage

Basic Usage

# Preview margins on a PDF
momovu document.pdf

# Specify document type and page count
momovu --document cover --num-pages 300 book.pdf

# Enable debug logging
momovu --debug document.pdf

Command Line Options

$ momovu --help
usage: momovu [-h] [-D] [-v] [-V] [-n N] [-d TYPE] [-s] [-m | --safety-margins | --no-safety-margins] [-t | --trim-lines | --no-trim-lines] [-b | --barcode | --no-barcode] [-l | --fold-lines | --no-fold-lines] [-p] [-f] [PDF_FILE]

Preview margins on book PDFs before publication.

positional arguments:
  PDF_FILE              Path to the PDF file to preview margins for

options:
  -h, --help            show this help message and exit
  -D, --debug           Enable debug logging
  -v, --verbose         Increase output verbosity (can be used multiple times)
  -V, --version         Show version and exit
  -n, --num-pages N     Set number of pages for spine calculations (must be positive)
  -d, --document TYPE   Set document type for margin calculations (interior, cover, dustjacket)
  -s, --side-by-side    Enable side-by-side dual page view mode
  -m, --safety-margins, --no-safety-margins
                        Show safety margins (default: enabled)
  -t, --trim-lines, --no-trim-lines
                        Show trim lines (default: enabled)
  -b, --barcode, --no-barcode
                        Show barcode area for cover/dustjacket (default: enabled)
  -l, --fold-lines, --no-fold-lines
                        Show fold lines for cover/dustjacket (default: enabled)
  -p, --presentation    Start in presentation mode
  -f, --fullscreen      Start in fullscreen mode

Example: momovu --num-pages 300 --document cover book.pdf

Development

For main development docs, see:

• https://momovu.org

To build and add to PyPi:

pip install -e .[dev]
python -m build
python -m twine upload dist/*

Links

• Main Website and Documentation: https://momovu.org
• Source Code: https://spacecruft.org/books/momovu
• Issues: https://spacecruft.org/books/momovu/issues
• Changelog: CHANGELOG.txt

Status

Beta - Works well. APIs may change between versions.

• Primarily tested with US Trade and Novella sizes.
• Works with most (all?) covers.
• Interior documents work.
• Covers work.
• Dustjackets work.

License

Apache 2.0 License. See LICENSE-apache.txt for details.

This is an unofficial project, not related to any upstream projects.

Copyright © 2025 Jeff Moe