Skip to content

Metadata

YourMJK edited this page Apr 26, 2021 · 8 revisions

Table of Contents

Supported Metadata

Prologue Tag Name FFmetadata MP4 atom Mp3tag ID3v2
Book title Title title ©nam TITLE TIT2
Book title (multi-file) Album album ©alb ALBUM TALB
Chapter title (multi-file) Title title ©nam TITLE TIT2
Book sort-title Sort-title sort_name (title-sort) sonm TITLESORT TSOT
Book sort-title (multi-file) Sort-album sort_album (album-sort) soal ALBUMSORT TSOA
Chapter number (multi-file) Track number track trkn TRACK TRCK
Author Artist artist ©ART ARTIST TPE1
Author (optional override) Album artist album_artist aART ALBUMARTIST TPE2
Narrator Composer composer ©wrt COMPOSER TCOM
Genre Genre genre ©gen GENRE TCON
Release date * Date date ©day YEAR TDRC/TYER
Description Description description (MP4)
TIT3 (MP3)
desc SUBTITLE TIT3

* When being as precise as possible the ISO 8601 format of the string is yyyy-MM-ddTHH:mm:ss (in UTC), but the precision may be reduced by removing as many time indicators as wanted.
Hence valid timestamps are yyyy, yyyy-MM, yyyy-MM-dd, yyyy-MM-ddTHH, yyyy-MM-ddTHH:mm and yyyy-MM-ddTHH:mm:ss.

Chapters

There are two ways of adding chapters to your audiobooks, that Prologue supports: embedding chapter metadata into a media file or having an album with one media file for each chapter.

Embedded Chapters

Some file formats like MP4 (.m4b) and MP3 support embedded chapters, i.e. storing chapter information like title and timestamps inside the media file.
This means you can have one file per audiobook without losing any chapter information.

While this method has many advantages (like reducing redundant metadata), there are some technical details to look out for in order for Prologue to correctly identify the chapter information, as described in the following sections.

M4B / MP4

TODO: nero vs. qt

MP3

TODO: CTOC required

Using FFmpeg / FFmetadata

TODO

Chapters through multiple files

If your audiobook consists of multiple media files that together form an album (like on MP3-CDs), Prologue will also recognise each individual file as a chapter.
Make sure to manage the metadata of every file accordingly, see "(multi-file)" tags under Supported Metadata.

Prologue also supports nested chapters (subchapters)!
By embedding chapters in your multi-file-audiobook's tracks, you can further subdivide your chapters into subchapters. This can be useful for:

  • Books that are structured into acts which also have chapters
  • Grouping multiple books of a series's season into a single audiobooks while still preserving the individual books' chapters

Cover artwork

There are many tools which allow you to embed an image into your media file, which can be automatically displayed in Plex and Prologue as your book's cover.
TODO: more info; supported image formats/dimensions

iTunes / Apple Music on macOS

  • Make sure "Copy files to iTunes Media folder when adding to library" option under Preferences > Advanced is disabled.
  • Add media file to library (drag&drop)
  • Edit > Song Info (⌘I) > Artwork
  • Add artwork (drag&drop) and press OK
  • (Remove media file from library again)

FFmpeg

ffmpeg -i <media file> -i <cover file> -map 0:a -map 1 -c copy -disposition:1 attached_pic <new media output file>

Replace <media file>, <cover file> and <new media output file> with their respective file paths.
This command will create a new file containing the first audio stream and all* metadata from the original media file plus the specified cover image, without re-encoding (i.e. without any quality loss). Previous embedded cover images will be replaced.

* Some special metadata tags like sort-title/sort-album may be lost.
At best, perform this step before adding metadata or confirm afterwards that none is missing.

AtomicParsley

Note: AtomicParsley will sometimes (unnecessarily) rescale images with higher resolutions and/or DPIs different from 72.

AtomicParsley <media file> --artwork REMOVE_ALL --artwork <cover file> --output <new media output file>

Replace <media file>, <cover file> and <new media output file> with their respective file paths.
This command will create a copy of the media file additionally containing the specified cover image, without re-encoding (i.e. without any quality loss). Previous embedded cover images will be replaced (--artwork REMOVE_ALL).

TODO: add more tools