Mac-letterhead 0.1.0

A macOS PDF Service to merge letterhead with printed documents

Mac-letterhead

A macOS PDF Service that automatically merges a letterhead template with printed documents.

Installation

Install the package:

uv pip install -e .

Usage

Installing a Letterhead Service

To create a PDF Service for a specific letterhead template:

uv run mac-letterhead install /path/to/your/letterhead.pdf

This will create a new PDF Service named "Letterhead " in your PDF Services directory.

Using the Letterhead Service

1. Open any document you want to print with the letterhead
2. Choose File > Print
3. Click the PDF dropdown button
4. Select "Letterhead " from the menu
5. Choose where to save the merged PDF

Version Information

To check the current version:

uv run mac-letterhead --version

Features

• Easy installation of letterhead services
• Supports multiple letterhead templates
• Maintains original PDF metadata
• Preserves PDF quality
• Shows save dialog for output location
• Proper error handling
• Supports --version flag
• Type hints for better code maintainability

Development

To install in development mode:

uv pip install -e .

Publishing a New Release

1. Update the version in:

   • pyproject.toml
   • letterhead_pdf/init.py
   • letterhead_pdf/main.py

2. Run the release script:

./tag_release.sh

This will:

• Create a git tag for the current version
• Push the tag to GitHub
• Trigger the GitHub workflow to publish to PyPI

License

MIT License