Rationale

See [Possible problem spaces](_docs/presearch/product/Possible problem spaces.md)

Usage

The intended use is you can leave this app running and process pdfs as from email or scanners as they come in.

You can also drag and drop any files you want processed.

Your badly-named pdfs will be automatically renamed like: yyyy-mm-dd ${title} [${addressee}].pdf and optionally, lower-cased.

eg., scan0001.pdf -> 2025-07-01 pacifc gas and electric bill details [trevor].pdf

Configuration

You need to set your OpenAI key in the settings before File Wrangler can run.

Alternatively, you can use Ollama (local models). Refer to their website for instructions on getting set up.

You also should configure the folder File Wrangler watches for .pdfs to your liking.

Releases

Releases will be available in this repo here.

Development

This program is developed using Electron.

To start the development server:

npm install
npm start

To publish, you need to set GITHUB_TOKEN in .env following .env.example

You'll also need to set up Apple Developer credentials. Refer to these instructions.

Notarization

See also: Official docs

To create notary credentials:

xcrun notarytool store-credentials "notarytool-credentials"
               --apple-id "<AppleID>"
               --team-id <DeveloperTeamID>
               --password <secret_2FA_password>

To check the status of the credentials:

xcrun notarytool history --keychain-profile "notarytool-credentials"