Chapter Sources¶

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

• Full chapter sources: 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. Full chapter sources can also be used anywhere a title-only source is accepted.
• Title-only sources: These only have titles (no timestamps). These sources can be used as reference data during AI Cleanup, and as input when using the Apply Titles feature. They cannot be used for chapter alignment.

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

Full chapter sources¶

Audiobookshelf¶

The chapters currently set on the book in Audiobookshelf.

Embedded Metadata¶

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-only sources¶

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 source.
2. Click the Pencil icon next to the source to open the editor.
3. Type or paste your desired list of titles, one title per line. Blank lines are ignored.

Adding Chapter Sources¶

New sources can be manually added using the Add Chapter Source 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 source.