Using HerdPrint
Quick start
1. Add documents
Drop PDFs, JPEGs, PNGs, or HEIC and HEIF photos onto the HerdPrint window, or choose Add Files… or Add Folder… from the File menu. You can add several files at once — invoices, receipts, contracts or any scan can share one list. Photos from a phone import without conversion, and the thumbnail, the preview, the printout and the export all keep the orientation the camera recorded.
2. Arrange the batch
HerdPrint decides each document’s date in this order: the document itself (turn on “Read the date from document content” in Settings → General), the folder name, the file name, then the file’s date. The list groups by those dates, and a folder that names no single day becomes a group named after the folder. Click a group title to change the whole group’s date, and double-click the “Documents” count at the top of the list to collapse or expand every group at once.
Select a document to inspect it, reorder the list, and remove files you do not need. Open Page layout… from the toolbar beside the preview to set how many documents share a sheet and whether the paper runs portrait or landscape; A4 or US Letter stays in Settings. Six preset arrangements are available, from one per page to a nine-slot grid, and a custom layout can divide the sheet your own way; the sections below say what each one holds. One per page suits larger pages; several per sheet saves paper when the content allows it.
When only one document needs a page of its own, there is no need to switch the whole layout: mark it as “Print on Its Own Sheet” in the list’s context menu, or select it and press ⇧⌘M. Removing a document only takes it out of the batch; the file on disk is not deleted.
3. Check the preview
Use the page controls and zoom tools to check the complete batch. Adjust scale, printable area, and margins when necessary.
4. Export or print
Use Export Layout PDF… to save a PDF in the selected paper size to a location you choose, or use Print… to send the layout to a printer. When a workflow needs image files, use Export as Images…: every document is exported page by page, as a ZIP or straight to AirDrop.
Turn on “Mark each document with its group name” in Settings → Layout and every document prints its group name in a reserved strip inside its own slot, in one of four corners. The colour of the mark shows how that date was decided, which makes sorting the printed sheets much faster.
5. Import from mail when needed
Configure a QQ, NetEase, Gmail, or Custom IMAP account in Settings. Search the date range, select only the attachments you want, and import them into the current local batch. Use an app password when your provider requires one. See the mail setup guide for provider-specific steps and server settings.
Page layout
Six preset arrangements sit under “Items per sheet” in the page layout panel, and any saved custom layout joins them as a card of its own. The page count above the preview follows the choice.
| Arrangement | Per sheet | How the sheet is divided |
|---|---|---|
| 1 per page | 1 | The whole printable area |
| Two stacked | 2 | Two full-width rows |
| Two side by side | 2 | Two full-height columns |
| Three side by side | 3 | Three full-height columns; a last sheet with two documents widens to two columns |
| Adaptive Side by Side | 4 | Two rows, up to two documents per row, with each row split by the documents’ aspect ratios |
| Nine per Sheet | 9 | A fixed 3 × 3 grid, filled left to right, then top to bottom |
Adaptive Side by Side is for a batch whose documents disagree about shape. A 1.5:1 invoice beside a 0.5:1 phone screenshot takes about three quarters of the row and one quarter, so both reach the same height instead of the invoice shrinking into a narrow column. A row holding a single document uses the full width.
Nine per Sheet turns nine confirmations into one sheet. A cell on portrait A4 measures roughly 61 × 90 mm, about a business card, and a full page scaled into it lands near 29%, which puts 10.5 pt text at about 3 pt on paper. Keep contracts, barcodes you need to scan, and anything with fine print out of this arrangement.
A short last sheet keeps the cell size it started with. Nine per Sheet does not stretch three documents across three wide columns, and Adaptive Side by Side does not inflate a lone document.
Nine per Sheet, Adaptive Side by Side and a custom layout all fill in list order. While one of them is on, the calendar buttons above the list turn off and documents appear in plain file order, because the arrangement has to know which files share a row or a region. Returning to a uniform arrangement brings the date groups back.
Changing the layout partway through a batch
“Apply layout to” at the top of the panel decides where a choice takes effect.
- Entire Batch gives every document the same arrangement. Choosing one clears the layout starts you set earlier and offers an Undo; choosing a paper orientation clears the orientation starts the same way.
- From Selection starts a new sheet at the selected document. Layout and paper orientation start separately: a landscape start on document 5 keeps working after you give document 8 a nine-per-sheet layout, and each rule continues until its own next start.
The list’s context menu offers the same two moves, “Layout from This Item” and “Set Orientation from Here”. A document carrying a start shows a flag beside its name, and its second row names the start, for example “Layout starts here: Nine per Sheet”.
With starts in place, the arrangement popup reads “Mixed Layout”. Reopen the panel with that document selected to remove one later, using “Remove Layout Start” or “Clear Orientation Start”. If the document leaves the list, its start moves to the next one rather than leaving a gap.
Custom layouts
A custom layout divides the sheet into regions you draw yourself, for a batch no preset fits: a wide invoice across the top, two receipts stacked beside it, a full-width strip for a payment screenshot at the bottom.
Open Page layout… and choose Edit Custom Layout. Rulers appear along the top and left edges of the sheet. Select a region, hover over a ruler, and double-click to split it: Split Vertically cuts left and right, Split Horizontally cuts top and bottom. Drag the line that appears to move the division, and the position shows on the ruler while you drag. Remove Divider merges the two regions beside the selected line, and only works while neither side is divided again. Undo steps back through the edits, and Reset returns the sheet to a single region.
A page holds up to nine regions, each at least 14 mm on a side. Documents fill the regions in list order: top to bottom, and left to right within a row. When the batch runs to several sheets, the page arrows move between them; a sheet holding only documents marked “Print on Its Own Sheet” cannot be edited.
A custom layout applies to the whole batch, so choosing one clears the layout starts you set earlier. Documents marked “Print on Its Own Sheet” keep their own sheet, and the summary sheet keeps its own arrangement. Each division is stored relative to the region it cuts, so changing the paper size or orientation keeps the shape of the layout. If a region falls outside the current printer’s printable area, HerdPrint says so before printing.
Apply to Batch uses the arrangement for this batch without saving it. Save Layout… asks for a name first, and Save & Apply stores the template: it then appears as a card under Items per sheet in later batches, ready to click. Right-click a saved card to remove it, and a name you already used offers Replace & Apply instead.
Companion invoice data in 1.1.4
For a PDF with companion XML, select both files together or import their folder. The PDF remains the document you preview and print; matching XML can supply the amount and issue date. Mail import can also retrieve companion XML or ZIP data from the same message. Unsupported or ambiguous companion data does not stop PDF import. Date grouping still follows your content-date setting and any dates you have confirmed by hand.
Full-page watermark
Choose Watermark… from the Preview menu or the tool rail to the right of the preview, type the watermark text, and adjust density, angle, size and opacity. The watermark covers the whole sheet; the preview, the printout and the exported layout PDF carry the same watermark, and your original files stay unchanged. The text and style are kept in local preferences, and the watermark starts switched off after a relaunch.
Print masking
When a document carries details that should not appear on paper, choose Print masking from the Preview menu or the tool rail: use Draw box to cover an area by hand, or Recognize text to click the words you want covered. With Smart on, HerdPrint picks out common sensitive text — names, ID numbers, phone numbers, bank cards and company details — on this Mac for you to choose from; it never masks anything by itself.
Masks apply to the current print only. Your originals stay unchanged, and removing the document or closing the workspace clears its masks. Exported PDFs and images do not include masks, and HerdPrint says so before it exports.
Group marks: the date printed on the document
Turn on “Mark each document with its group name” in Settings → Layout, or click the mark button on the toolbar to the left of the preview. Pick the corner in the same panel; the default is top right. With several documents per sheet, each one prints its own group name inside its own slot.
The colour of the mark says how that document’s date was decided:
- Purple: a date in the folder name
- Green: a date in the file name
- Blue: the day the expense happened, read from the document content (travel, stay, rental)
- Yellow: only the invoice’s own issue date could be read
- Cyan: the folder names no date, so its name becomes the group name
- Red: a date you changed by hand
- Grey: only the file time or the mail arrival time was available
That colour is what lets you tell, on paper, which dates were read, which you corrected, and which simply came from a folder. Settings lists the whole legend; on a black-and-white printer the colours become shades of grey and are harder to tell apart.
Amounts and checking a claim
Click the amount button on the preview toolbar (or press ⇧⌘T) to open the amount column. HerdPrint reads each amount from the receipt and shows it on the row; a receipt whose amount cannot be read with confidence is marked pending rather than filled in with a guess. Double-click an amount to correct it, and HerdPrint remembers where that kind of receipt keeps its total. Everything it has learned is listed under Settings → Learning, and any rule can be taken back.
Some invoices state their amount in machine-readable form. German e-invoices (Factur-X, ZUGFeRD, XRechnung) carry their figures in an XML document inside the PDF, and HerdPrint reads that first; the amount panel then says the number came from the embedded data, which is what the invoice itself declares. Where the invoice also prints a gross total and a prepayment, the panel names both, because the payable amount is smaller than the largest number on the page. Reading these invoices is written up in a note.
With the amount column open, each date group in the sidebar shows its own subtotal. Starting with 1.1.4, the summary appears and is selected automatically when amount reading finishes. Removing it returns to the first page and keeps the amounts. To make the printed batch checkable too, turn on the summary sheet in Settings → Layout or press ⇧⌘G: it becomes page 1 of the document, one row per date with the receipt count and subtotal, the batch total underneath, and a footnote naming what the total leaves out (pending, unread, other currencies). Turn it off in the same place.
When a document belongs in the batch but not in the arithmetic, right-click it in the list and choose Exclude from Amounts. Its row reads Excluded, the date-group subtotal and the summary sheet leave it out, and the printed sheet keeps it exactly where the layout put it. HerdPrint confirms the count and offers Undo, and Include in Amounts brings a document back. The amount summary sheet states how many documents were excluded, and says so plainly when every document has been excluded.
A privacy-minded workflow
HerdPrint processes the files you import on your Mac. When you use mail import, it connects to the provider you choose and downloads only the selected attachments. Never share your mail password or private documents in a support request.
