1. Introduction
1.1 What this tool does
The Handbook X Content Aggregation Tool is a local agent that uploads and synchronizes files from folders on your PC to books and sections on Handbook X (your Coordinator server).
Typical uses:
- Import PDFs or images dropped into a shared folder into a designated book
- Map multiple local paths to different books (including overflow books)
- Inspect results and errors in the web UI or log files
It runs in the background and exposes a local web console and API on TCP port 8089 by default.
Requirements and assumptions
| Item | Details |
|---|---|
| Windows | 64-bit Windows. Data under C:\ProgramData\HandbookXAggregationTool\ |
| Mac | macOS on Apple Silicon. Distributed as a DMG; use the menu bar app to start, check status, and open the web UI. |
| Network | HTTPS connectivity to your Coordinator (cloud or dedicated server) |
| Browser | For the web UI at http://localhost:8089/ on the same machine |
Note: Your Handbook X account must meet eligibility rules (paid plan subscriber, or not a paid-plan subscriber but in a workgroup as workgroup owner or sharing administrator). See Sign-in and permissions.
Terminology
| Term | Meaning |
|---|---|
| Coordinator / server URL | Address of the management server (e.g. https://example.handbookx.com), used at sign-in |
| Sync configuration | The full set of options: which local folders map to which books, interval, etc. |
| Source folder | Local directory whose files are ingested |
| Web console | Browser UI for settings and logs (served on port 8089) |