Settings

General

Auto-rename is enabled per folder on the Folders tab — not here in Settings
Preserve file timestamps — Creation and modification dates are kept after renaming

The PCS integration settings are also located on this tab (see below).

AI Settings

Under Settings → AI you choose the active provider and configure API key and model. API keys are stored securely in the macOS Keychain. In the App Store build, only Distill Cloud is available; all other providers are available in the DMG version.

For Distill Cloud, this section also shows your current credit balance, with the “Buy more” button and (DMG build only) “Redeem code”.

API Settings

Under Settings → API you can enable the REST API server (enabled by default in the DMG build, opt-in in the App Store build), configure the port (default: 43821), and set an optional authentication token. A button opens the Swagger UI in your browser.

Status Bar

The status bar at the bottom of the window shows the active AI provider, a sparkles credit counter (Distill Cloud), folder-watch status, and the PCS connection state. All sections are clickable — the credit counter opens the paywall, the watch and history icons jump directly to the corresponding tab.

PCS Integration

If PDF Content Search is installed, Distill can use its OCR engine for improved text recognition on PDFs and images. You can find the PCS integration under Settings → General. It is enabled by default; Distill reaches PDF Content Search via the configurable port (default: 44477). A PCS token is only required if you have set one in PDF Content Search. Connection status is shown live.

Diagnostics

Distill keeps a record of what happens at startup, during folder watching, in the queue and while renaming. Use Help → Save diagnostics… or the button of the same name under Settings → General to write it to a text file you can attach to a support request.

It contains the app and system version, the database locations with their record counts, the active AI provider and the state of the REST API and the PCS integration. API keys and tokens are not included — only whether one is set.

Detailed diagnostics additionally records every single file. The log is capped at two files of one megabyte each; anything older is dropped.

Updates

The DMG edition ships with a built-in update mechanism (JKSUpdateKit). Use Distill → Check for Updates… from the app menu to check for new versions any time; if one is available it is suggested with release notes.

The App Store edition is updated via the Mac App Store.