epub-tools: Command line utilities for working with epub files

[ application, console, program ] [ Propose Tags ]

A suite of command-line utilities for creating and manipulating epub book files. Included are: epubmeta, epubname, epubzip


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 1.0.0.0, 1.0.0.1, 1.1.0, 1.1.1, 1.1.2, 2.0.0, 2.1.0, 2.1.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 2.10, 2.11, 3.0, 3.1, 3.2
Change log changelog.md
Dependencies base (>=3 && <5), bytestring, directory, epub-metadata (>=4.0), filepath, mtl, parsec, process, regex-compat, zip-archive [details]
License BSD-3-Clause
Copyright 2008-2014 Dino Morelli
Author Dino Morelli
Maintainer Dino Morelli <dino@ui3.info>
Category Application, Console
Home page http://ui3.info/d/proj/epub-tools.html
Source repo head: darcs get http://ui3.info/darcs/epub-tools/
Uploaded by DinoMorelli at 2014-04-04T18:26:47Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables epubzip, epubname, epubmeta
Downloads 31973 total (75 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2016-12-15 [all 7 reports]

Readme for epub-tools-2.5

[back to package description]

epub-tools

Synopsis

Command line utilities for working with epub files (Haskell)

Description

A suite of command-line utilities for creating and manipulating epub book files. Included are: epubmeta, epubname, epubzip. This software uses the epub-metadata library, also available on Hackage.

epubmeta

epubmeta is a command-line utility for examining and editing epub book metadata. With it you can export, import and edit the raw OPF Package XML document for a given book. Or simply dump the metadata to stdout for viewing in a friendly format.

Here's an example of epubmeta output:

$ epubmeta Kelly_Kessel_Lethem-NinetyPercentOfEverything.epub

package
   version: 2.0
   unique-identifier: calibre_id
identifier
   id: calibre_id
   scheme: calibre
   text: b1026732-69a5-4a05-a8d9-a1701685f6fa
identifier
   scheme: ISBN
   text: 1-590620-00-3
title: Ninety Percent of Everything
language: en-us
contributor
   text: calibre (0.5.1) [http://calibre.kovidgoyal.net]
   file-as: calibre
   role: bkp
creator
   text: James Patrick Kelly
   file-as: Kelly, James Patrick
   role: aut
creator
   text: John Kessel
   role: aut
creator
   text: Jonathan Lethem
   role: aut
date: 2001-03-25T00:00:00
publisher: www.Fictionwise.com
subject: Science Fiction/Fantasy

epubname

epubname is a command-line utility for renaming epub ebook files based on their OPF Package metadata. It tries to use author names and title info to construct a sensible name.

Using it looks like this:

$ epubname poorly-named-book.epub

poorly-named-book.epub -> WattsPeter-Blindsight_2006.epub

$ epubname another-poorly-named-book.epub

another-poorly-named-book.epub -> Kelly_Kessel_Lethem-NinetyPercentOfEverything.epub

epubzip

epubzip is a handy utility for zipping up the files that comprise an epub into an .epub zip file. Using the same technology as epubname, it can try to make a meaningful filename for the book.

Getting source

And once you have it, building the usual way:

$ cabal configure --enable-tests
$ cabal build
$ cabal test
$ cabal install

Installing

Build and install with cabal-install: $ cabal update ; cabal install epub-tools

Contact

Dino Morelli <dino@ui3.info>