Guide

Auto-tag your ebook library by what's inside each book

Tagging hundreds of books by hand doesn't scale. GrepTag profiles turn a few keyword rules into tags, re-run them as your library grows, and can tag new books the moment you import them.

Applies to GrepTag 1.0.16 on iPhone, iPad and Mac · Updated 21 November 2026

What a profile is

A profile has three parts: a name, a list of keyword rules and an output tag. When you run it, GrepTag checks every book's text and file name against the rules. Books that match receive the output tag.

How rules are evaluated

The first rule sets the starting result: does the book contain this keyword? Each following rule then combines with the result so far:

  • AND: the book must also contain this keyword.
  • OR: the book may contain this keyword instead.
  • NOT: the book must not contain this keyword.

Rules are applied strictly from left to right, with no precedence and no brackets. So ship OR whale AND harpoon means “(ship or whale) and harpoon”. To express “ship, or both whale and harpoon”, reorder the rules: whale AND harpoon OR ship.

A GrepTag profile with AND, OR and NOT rules

A profile combines keyword rules and applies one tag to every match.

Example profiles

Example profiles. Keywords match anywhere in the text or file name, ignoring case and accents.
GoalRules (left to right)Tag
Crime and mysterydetective OR inspector OR murdermystery
Sea stories, without cookbookssail OR harbour OR harbor NOT recipesea
Grey or gray, in one rulegr?y AND wolfgrey-wolf
Books set in Kyoto京都 OR Kyotokyoto
Study listphotosynthesis AND chlorophyllbiology

Running profiles

  • Grep New checks only the books a profile hasn't scanned yet. It's the quick option after an import.
  • Grep All re-runs every profile across the whole library. Use it after you change a profile's rules.
  • Review the matches, then choose Tag All or select specific books and apply the tag.

Tag new books automatically (Pro)

With GrepTag Pro, switch on Auto-run for a profile. When you import books, GrepTag scans just the new arrivals against your auto-run profiles and applies their tags. Your library sorts itself as it grows.

Free-version limits

The free version includes unlimited scans, 2 profiles and up to 5 different tags, which is enough to try the workflow on a real library. Pro removes those limits and adds auto-run, sync and an automatic daily iCloud backup.

Keep your tags safe

Export a backup file of tags, ratings and profiles from Settings at any time, and import it on another device. Restoring matches books by file name and size.

Let your rules do the sorting.

Try two profiles for free on iPhone, iPad or Mac.