Command line utilities for working with epub files (Haskell)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
| # 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 this software
Binaries
- epub-tools is available for Arch Linux [from the AUR](http://aur.archlinux.org/packages/epub-tools/)
- Download [binaries for Windows](http://ui3.info/d/proj/epub-tools/epub-tools-2.9-win.zip)
Building and installing from source with cabal-install:
$ cabal update ; cabal install epub-tools
Getting source for development
- Download the cabalized source package [from Hackage](http://hackage.haskell.org/package/epub-tools)
- Get the source with darcs: `$ darcs clone http://hub.darcs.net/dino/epub-tools`
- Get the source with stack: `$ stack unpack epub-tools`
- If you're just looking, [browse the source](http://hub.darcs.net/dino/epub-tools)
Once you have source, building the usual way:
$ stack build
$ stack test
$ stack haddock
## Contact
Dino Morelli <[dino@ui3.info](mailto:dino@ui3.info)>
|