Handbook X Content Aggregation Tool Manual

3. Mac: Installation and startup

3.1 Getting started with the menu bar app

The Mac version is distributed as a DMG. Copy the app into your Applications folder before use.

Downloading the installer

Download the latest DMG installer (AggregationTool.dmg) from the URL below. Double-click the DMG to mount it, then drag the app into the Applications folder to complete installation.

https://download.handbookx.com/release/mac/AggregationTool.dmg

On first launch the app may ask for administrator privileges (sudo) to install the background service. If Gatekeeper blocks the app, right-click it in Finder and choose Open to confirm.

Using the menu bar app

After installation, treat the menu bar icon (top-right of the screen, or open the app from Launchpad so the icon appears there) as your main place for day-to-day tasks. From its menu you can:

Sync work runs in a background service. You can rely on the menu bar app—you do not need the command line for normal use.

3.2 Background service and file locations

This section is for troubleshooting or IT staff who need the on-disk layout. Installation may require administrator rights (sudo).

After installation, verify:

http://localhost:8089/api/ping

You should see a response such as Handbook X Content Aggregation Tool is running.

Database and application logs

The local database handbookXSync.db and daily application logs are created under the service working directory (the install path above). If you back up or delete files, consider the impact on sync state with Coordinator.

Uninstall (general outline)

Follow your distributor’s procedure. It commonly includes:

  1. Stop and unload the service
  2. Remove com.asteria.handbookx.aggregationtool.plist
  3. Remove /Library/Application Support/HandbookXAggregationTool