Cleave — Support

On-device EPUB metadata editor for iPhone and iPad.

Contact: support@whidbeylabs.app
Reply time: usually within a couple of days.

Quick start

  1. Open an EPUB in the Files app, long-press, and pick Share → Cleave.
  2. The editor opens with auto-cleaned metadata and enriched cover candidates.
  3. Edit anything you want. Tap a candidate cover to stage it.
  4. Tap Save. Cleave writes the cleaned EPUB to your chosen folder — or asks where to put it.

FAQ

Where do my books go after saving?

Wherever you pick in the save dialog. If you set a default folder in Settings → Save destination, Cleave writes there directly. Choose any folder in Files — iCloud Drive, On My iPhone, or a folder exposed by another app like Calibre Companion, KOReader, or Yomu.

Does Cleave modify my original file?

No. Cleave always writes a new EPUB with your changes; the original is untouched unless you overwrite it by saving to the same path with the same filename.

Why doesn't the share extension open the Cleave app for me?

iOS 26 blocks share extensions from launching their host app. Tap the share-sheet confirmation, then tap the Cleave icon on your home screen — Cleave will pick up the file automatically when it opens.

How do I import multiple books at once?

Select all the EPUBs in Files, share to Cleave. Cleave processes them as a batch with a "Book X of N" counter. Skip, edit, and save each one individually.

How do I clear stale imports?

Open Cleave → Settings → Diagnostics → Delete all Inbox files.

Can I use my own cover images?

Yes. In the editor's Cover section, tap Photos to pick any image from your library. Cleave re-encodes it as JPEG at full resolution.

Does Cleave work offline?

Mostly. Editing, auto-cleaning, watermark-page stripping, and saving all work offline. Cover enrichment and web metadata lookup need a network connection; if you're offline, those sections just show empty results — no errors.

What's the Google Books API key for?

Optional. If you provide one in Settings → Cover sources → Google Books, Cleave uses Google Books as a third metadata/cover source in addition to Apple Books and Open Library. A key is free from console.cloud.google.com (enable the Books API, create a key, paste it in).

What devices does Cleave support?

iPhone and iPad running iOS 17 or later.

How do I request a feature or report a bug?

Email support@whidbeylabs.app with the build number (Settings → Diagnostics) and a description. If the bug is reproducible, a copy of the problem EPUB (one Cleave crashes on) helps a lot.

Known limitations

Privacy

Cleave collects nothing. Full privacy policy.