Swapped Metadata Fixer
A calibre plugin that fixes books in which the
Title and Author are swapped
(and often missing their accents) — a corruption that is baked
inside the
.epub's own internal metadata. It is common in some book
compilations, but the tool itself is general-purpose.
It bundles
three tools: (1) repair the calibre library, (2) repair the
Title/Author
inside the .epub file, and (3) detect record<->epub mismatches —
each selectable from a "What do you want to do?" drop-down.
Code:
WRONG -> Title: "AA. VV." Author: "A Delightful Christmas"
RIGHT -> Title: "A Delightful Christmas" Author: "AA. VV."
The plugin reads each book's
internal .epub metadata (it does not trust only
the calibre record, which is exactly what is wrong), proposes the correction (with
accents recovered when possible), shows you a reviewable table, and applies only
what you tick. Nothing is changed until you press Apply.
What it does — three operations- Repair calibre library — the normal one: fixes the Title/Author you see in
calibre (writes via calibre's API, so the sort is regenerated automatically and it
works with calibre open). Optional checkbox to also fix the inside of the .epub.
- Repair inside the .epub — rewrites Title/Author inside the file itself
(useful for e-readers or sharing). It backs up each .epub before touching it.
- Detect record<->epub mismatches (advanced) — lists books whose calibre
record does not match the .epub; you choose per row which side wins. In a normal
library this shows many legitimate differences (subtitles, manual edits...), so it
is informational, not a "select all and apply" mode.
Features- Reviewable table: per-book checkbox, edit any proposal (double-click), an ID
column, a search/filter box, copy cells (Ctrl+C) to paste into calibre's search.
- Robust detection that avoids false positives on tricky cases: biographies titled
with a person's name, EpubLibre collection codes like [DIPUB 2], multi-author books,
editors/illustrators listed as creators, punctuation/accents, and "AA. VV."
anthologies whose full author list lives in the OPF file-as.
- Mismatch mode niceties: per-row direction (epub->DB or DB->epub), per-field
colour cues (title in blue, author in orange), bulk select + set direction, and on
"Title & Author" rows you can click the Note cell to apply both / only title / only
author.
- Scope the check by whole library, by publisher, by date (any format), or by ID
(one or several) — handy to review a single book instantly.
- Parallel .epub reading with a live progress counter and a Stop button; works with
calibre open (uses the calibre DB API).
- Bilingual UI: English, or Spanish if calibre's interface language is Spanish.
Requirements- calibre 6.0 or newer (it uses the Qt6 "qt.core" API).
- Windows, macOS or Linux.
Installation- Manual: download the attached .zip (do not unzip it) ->
Preferences -> Plugins -> "Load plugin from file" -> choose the .zip -> restart
calibre.
- If you don't see the button on the toolbar: Preferences -> Toolbars & menus ->
"The main toolbar" -> add "Swapped Metadata Fixer".
- Once it is added to the plugin index, you will also be able to install/update it
from Preferences -> Plugins -> "Get new plugins".
Usage
Click the toolbar button, keep "Repair calibre library", choose the scope, and press
"Check". Only the books that are wrong are listed. Review (double-click to edit;
yellow rows come unticked), then press "Apply selected". There is a built-in Help
button (full explanation of every option) and a CSV export.
Safety- Nothing is changed until you press Apply.
- When rewriting an .epub it first saves a copy of the original under
"_backups_SwappedMetadataFixer" inside your library.
- Please make your own backup of the library the first time, just in case.
License: free to use. Feedback and example books welcome — if you hit a case
it does not detect or a wrong proposal, post the real title and author and I will
look into it.
Version history- 4.36 — current release. Undo: every Apply now saves a per-session backup (original .epub and/or the previous record title/author); a "Backups"
button lets you Restore a session or Delete a backup when you're done.
- 4.33-4.34 — toolbar button uses the plugin's actual name (easier to find in the toolbar list); toned-down read-only report prompt; readable cell
highlighting on dark themes; progress bar moves during the preparing phase too.
- 4.30-4.32 — defensive optional imports (loads even if a Qt class is missing in some calibre builds); optional EpubLibre helper (if an EPL-Id
custom column exists, EPL books default to DB->epub; libraries without it are unaffected).
- 4.29 — optional diagnostic Log (records the exact .epub path and where each value comes from) with a "View log" button; sort by clicking a
column header.
- 4.26 — only recover authors from the OPF file-as when it is in display form (avoids reversed "Lastname, First" results); fixes false author
mismatches.
- 4.2x — mismatch mode: per-row direction, per-field colours, bulk select/direction, click Note to apply only title or only author; recover the
full author list from the OPF file-as for "AA. VV." anthologies; scope by ID; Close button; description lists the three tools.
- 4.1x — false-positive hardening, ignore collection codes / multi-author / editors / punctuation / accents, ID column + search, parallel scanning
with Stop, bilingual EN/ES UI, renamed to "Swapped Metadata Fixer".
- 4.0 — first plugin release (it was a standalone app before).