How to open .HPUB files on Linux

To open .HPUB files on Linux, open it with an installed HPub-capable reader/creator app if available.

Step-by-step instructions

  1. Open it with an installed HPub-capable reader/creator app if available.
  2. If your desktop environment doesn’t recognize .hpub, use an archive manager/unzip tool to extract it and open the HTML files in a browser.
  3. If you manage MIME associations, ensure your system’s shared-mime-info database includes (or is extended to include) the application/prs.hpub+zip type for *.hpub.

Alternative methods

  • Open .HPUB in a browser-based viewer if desktop apps fail.
  • Try opening .HPUB on Linux with a secondary app to rule out app-specific issues.
  • Convert .HPUB only with trusted tools when direct opening is not possible.

Common issues

The .hpub file won’t open in any app

Many systems don’t ship with a dedicated HPub reader/creator, so the file may appear “unknown” even though it’s valid.

  1. Use an HPub-capable app (IANA lists example applications such as hReader and hCreator).
  2. If you can’t install a reader, extract the file as a ZIP archive and open the included HTML content in a browser.

Extraction fails or reports a corrupted archive

HPub is ZIP-based; if the download or transfer was interrupted, the ZIP container may be incomplete.

  1. Re-download or re-transfer the file and try extracting again.
  2. If possible, compare file size against the sender’s value or source listing to confirm it is complete.

It extracts, but the publication doesn’t work as expected

HPub content relies on a required book.json manifest and a specific folder/file structure; missing files can break navigation or reading flow.

  1. Check that the extracted package contains book.json (required by the HPub specification).
  2. Try opening the .hpub in a dedicated HPub reader instead of manually opening individual HTML files.

Linux file manager doesn’t recognize the file type

Linux desktop type detection typically depends on the shared-mime-info database and installed MIME definitions for application/prs.hpub+zip.

  1. Update your system MIME database packages and retry.
  2. If you administer the system, add or install a MIME definition mapping *.hpub to application/prs.hpub+zip (per shared-mime-info practices).

Security note

.hpub is a ZIP container and can include arbitrary files; extract it to a new folder and review contents before opening anything unfamiliar.

Back to .HPUB extension page