References¶

Achew designates sets of external chapter data as References. There are two kinds:

• Chapter References: These have timestamps and titles. They drive the Realign, Regenerate Titles, and Quick Edit workflows, and serve as points of comparison during initial chapter selection in the Smart Detect workflow. Chapter References can also be used anywhere a Title Reference is accepted.
• Title References: These only have titles, no timestamps. They can be used with AI Cleanup and the Apply Titles feature. They cannot be used for chapter alignment.

References stay loaded for the duration of your session. They appear as options during workflow selection and as tabs in the editor's Add Chapter Dialog.

Chapter References¶

Audiobookshelf¶

The chapters currently set on the book in Audiobookshelf.

Embedded Chapters¶

Chapter markers stored inside the audio file's metadata.

File Data¶

Chapter data using the audio file names and durations.

Audnexus¶

Chapter data from Audnexus, the same service Audiobookshelf uses for its own chapter lookups.

JSON File¶

A .json file containing an array of objects with timestamp¹ and title fields. Achew tries to auto-detect the fields, but predictable names like start / timestamp and name / title help:

[
    {
        "timestamp": 0,
        "title": "Opening Credits"
    },
    {
        "timestamp": 18.453,
        "title": "Chapter 1: The Beginning"
    }
]

CSV File¶

A .csv file with columns for timestamps¹ and titles. Achew tries to detect the columns (even without headers), but predictable column names like start / timestamp and name / title help.

Cue Sheet¶

A standard cue sheet file (.cue).

Snapshot¶

A snapshot of the chapters you've produced inside Achew, usable only during the current session.

Title References¶

Text File¶

A plain .txt file, one title per line. Blank lines are ignored.

EPUB File¶

An .epub e-book file. Chapter titles are extracted from its Table of Contents.

Custom Titles¶

You can edit a list of custom titles directly in Achew:

1. In the Apply Titles dialog or the AI Cleanup dialog, use the appropriate dropdown to select the Custom Titles Reference.
2. Click the Pencil icon next to the Reference to open the editor.
3. Type or paste your desired list of titles, one title per line. Blank lines are ignored.

Adding Chapter References¶

New References can be manually added using the Add Chapter Reference dialog. This dialog can be accessed from Workflow Selection, the Apply Titles dialog, or the AI Cleanup dialog:

Two tabs are available: Upload File and Audnexus Search.

Upload File¶

In the Upload File tab, drop a file into the upload zone or click browse to pick one.

Supported Formats:

Audnexus Search¶

In the Audnexus Search tab, you can search the Audnexus database by book title and/or author. Changing the provider allows you to change which Audible storefront region is searched.

Each result displays relevant information that can help you decide on a good match. Use the Eye button in the top right of each result to preview its chapter list, and click the Add button to add it as a Chapter Reference.