-
Notifications
You must be signed in to change notification settings - Fork 0
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
.
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.
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.
TODO: nero vs. qt
TODO: CTOC required
TODO
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
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
- 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 -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.
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