edr1412/epub-plugins

OS X Spotlight / Quick Look plugins for EPUBs

EPUB Plugins

The EPUB Plugins project contains the OS X Spotlight and Quick Look plugins for EPUBs. By installing these plugins, you can search and preview EPUBs.

System requirements

macOS 12+

Download and install plugins

To download plugins, go to Releases page and click download links in “Downloads” section.

To install plugins, unzip downloaded files and copy them to the following path:

EPUB.mdimporter (Spotlight plugin)

• ~/Library/Spotlight (only for current user) or
• /Library/Spotlight (for all users)

EPUB.qlgenerator (Quick Look plugin)

• ~/Library/QuickLook (only for current user) or
• /Library/QuickLook (for all users)

OS X recognizes these plugins after copying them to appropriate path. However, if the system doesn't recognize the plugins, run commands as follows:

$ mdimport -r /path/to/EPUB.mdimorter
$ qlmanage -r

or, simply reboot.

Spotlight importer

The EPUB metadata are assigned to OS X metadata as follows:

EPUB metadata	OS X metadata
title	kMDItemTitle
creator	kMDItemAuthors
subject	kMDItemKeywords
description	kMDItemDescription, kMDItemHeadline
publisher	kMDItemPublishers, kMDItemOrganizations
contributor	kMDItemContributors
identifier	kMDItemIdentifier
language	kMDItemLanguages
coverage	kMDItemCoverage
rights	kMDItemCopyright, kMDItemRights
date	kMDItemContentCreationDate
last modified date	kMDItemContentModificationDate
Body text	kMDItemTextContent
Number of content documents in EPUB	kMDItemNumberOfPages
EPUB specification version	com_genjiapp_Murasaki_mdimporter_EPUB_EPUBVersion

Quick Look generator

Thumbnail	Preview
Cover image of EPUB	Loading limit: about 50MB