calibre User Manual, Release 2.56.0
The list of books in calibre is blank!
In order to understand why that happened, you have to understand what a calibre library is. At the most basic level,
acalibre library is just a folder. Whenever you add a book to calibre, that book’s files are copied into this folder
(arranged into sub folders by author and title). Inside the calibre library folder, at the top level, you will see a file
called metadata.db. This file is where calibre stores the metadata like title/author/rating/tags etc. for every book in
your calibre library. The list of books that calibre displays is created by reading the contents of this metadata.db file.
There can be two reasons why calibre is showing a empty list of books:
• Yourcalibre library folder changed its location. This can happenifit was on anexternal diskand the drive letter
for that disk changed. Orifyou accidentally moved the folder. In this case, calibre cannot findits library and so
starts up with anempty libraryinstead. To remedy this, doa right-click onthe calibre icon in the calibre toolbar
and select Switch/create library. Click the little blue icon to select the new location of your calibre library and
click OK.Ifyou don’t know the new location search your computerfor the file metadata.db.
• Yourmetadata.dbfilewas deleted/corrupted. Inthis case,youcan askcalibreto rebuild the metadata.db fromits
backups. Right click the calibre icon in the calibre toolbar and select Library maintenance->Restore database.
calibre will automatically rebuild metadata.db.
Iam getting errors with my calibre library on a networked drive/NAS?
Do notput your calibre library on a networked drive.
Afilesystem is a complex beast. Most network filesystems lack various filesystem features that calibre uses. Some
don’t support file locking, some don’t support hardlinking, some are just flaky. Additionally, calibre is a single user
application, if you accidentally run two copies of calibre on the same networked library, bad things will happen.
Finally, different OSes impose different limitations on filesystems, so if you share your networked drive across OSes,
once again, bad things will happen.
Consider using the calibre Content Server to make your books available on other computers. Run calibre on a single
computerand access it via the Content Server or a Remote Desktop solution.
If you must share the actual library, use a file syncing tool like DropBox or rsync instead of a networked drive. If you
are using a file-syncing tool it is essential that you make sure that both calibre and the file syncing tool do not try to
access the calibre library at the same time. In other words, do not run the file syncing tool and calibre at the same
time.
Even with these tools there is danger ofdata corruption/loss, so only do this if you are willingto live withthat risk. In
particular, be aware that Google Drive is incompatible with calibre, if you put your calibre library in Google Drive,
you will suffer data loss. Seethisthread
57
for details.
1.8.4 Miscellaneous
57
http://www.mobileread.com/forums/showthread.php?t=205581
1.8. Frequently Asked Questions
117
Pdf create bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
pdf reader with bookmarks; create bookmarks in pdf reader
Pdf create bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
bookmarks pdf documents; how to add bookmark in pdf
calibre User Manual, Release 2.56.0
Contents
• Iwantcalibretodownloadnewsfrommyfavoritenewswebsite. (page 118)
• Whythenamecalibre?(page 118)
• WhydoescalibreshowonlysomeofmyfontsonOSX?(page 118)
• calibreisnotstartingonWindows? (page 119)
• calibrefreezes/crashesoccasionally? (page 119)
• UsingtheviewerordoinganyconversionsresultsinapermissiondeniederroronWindows(page 120)
• calibreisnotstarting/crashingonOSX? (page 120)
• Idownloadedtheinstaller,butitisnotworking? (page 121)
• Myantivirusprogramclaimscalibreisavirus/trojan?(page 121)
• HowdoIbackupcalibre?(page 121)
• HowdoIusepurchasedEPUBbookswithcalibre(orwhatdoIdowith.acsmfiles)?(page 122)
• Iamgettinga“PermissionDenied”error? (page 122)
• CanIhavethecommentmetadatashowuponmyreader?(page 122)
• HowdoIgetcalibretousemyHTTPproxy?(page 122)
• Iwantsomefeatureaddedtocalibre.WhatcanIdo? (page 123)
• Whydoesn’tcalibrehaveanautomaticupdate?(page 123)
• Howiscalibrelicensed?(page 123)
• HowdoIruncalibrefrommyUSBstick?(page 123)
• HowdoIrunparts of calibrelike news downloadandthecontent serveronmyownlinuxserver?
(page 123)
Iwant calibre to download news from my favorite news website.
If you are reasonably proficient with computers, you can teach calibre to download news from any website of your
choosing. To learn how to do this seeAddingyourfavoritenewswebsite(page 23).
Otherwise,youcan request a particularnews site by postingin thecalibreRecipesforum
58
.
Why the name calibre?
Take your pick:
• Convertor And LIBRary forEbooks
• A high calibre product
• A tribute to the SONY Librie which was the first e-ink based ebook reader
• My wife chose it ;-)
calibre is pronounced as cal-i-ber not ca-li-bre. If you’re wondering, calibre is the British/commonwealth spelling for
caliber. Being Indian,that’s the natural spelling for me.
Why does calibre show only some of my fonts on OS X?
calibre embeds fonts in ebook files it creates. Ebook files support embedding only TrueType and OpenType (.ttf and
.otf) fonts. Most fonts on OS X systems are in .dfont format, thus they cannot be embedded. calibre shows only
TrueType and OpenType fonts found on your system. You can obtain many such fonts on the web. Simply download
the .ttf/.otf files and add them to the Library/Fonts directory in your home directory.
58
http://www.mobileread.com/forums/forumdisplay.php?f=228
118
Chapter 1. Sections
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
Bookmarks. inputFilePath = Program.RootPath + "\\" 3.pdf"; String outputFilePath = Program.RootPath + "\\" 3_optimized.pdf"; 'create optimizing options
how to add a bookmark in pdf; add bookmark pdf file
VB.NET PDF File Split Library: Split, seperate PDF into multiple
how to split a PDF file into multiple ones by PDF bookmarks or outlines Valid value for each index: 1 to (Page Count - 1). ' Create output PDF file path
split pdf by bookmark; create bookmarks pdf
calibre User Manual, Release 2.56.0
calibre is not starting on Windows?
There can be several causes for this:
• If you are on Windows XP, or on a computer with a processor that does not support SSE2 (such as AMD
processors from before 2003) try installing calibreversion1.48
59
. calibre 2.0 and newer use Qt 5 which is
known to be incompatible with Windows XP machines, and requires SSE2. Simply un-install calibre and then
install version 1.48, doing so will not affect your books/settings.
• If you get an error about calibre not being able to open a file because it is in use by another program, do the
following:
– Uninstall calibre
– Reboot your computer
– Re-install calibre. But do not start calibre fromthe installation wizard.
– Temporarily disable your antivirus program (disconnect fromthe Internet before doing so, tobe safe)
– Look inside the folderyou chose for your calibre library. Ifyou see a file named metadata.db,delete it.
– Start calibre
– From now on you should be able to start calibre normally.
• If you get an error about a Python function terminating unexpectedly after upgrading calibre, first unin-
stall calibre, then delete the folders (if they exists) C:\Program Files\Calibre and C:\Program
Files\Calibre2. Now re-install and you should be fine.
• If you get an error in the welcome wizard on an initial run of calibre, try choosing a folder like C:\library
as the calibre library (calibre sometimes has trouble with library locations if the path contains non-English
characters, or only numbers,etc.)
• Try running it as Administrator (Right click on the icon and select “Run as Administrator”)
If it still wont launch, start a command prompt (press the windows key and R; then type cmd.exe in the Run dialog
that appears). At the command prompt type the following command and press Enter:
calibre-debug -g
Post any output you see in a help message on theForum60.
calibre freezes/crashes occasionally?
There are several possible things I know of, that can cause this:
• You recently connected an external monitororTV to your computer. In this case, whenever calibre opens a new
window like the edit metadata window or the conversion dialog, it appears on the second monitor where you
don’t notice it and so you think calibre has frozen. Disconnect your second monitor and restart calibre.
• The following programs have been reported to cause crashes in calibre: If you are running any of these, close
them before starting calibre, or uninstall them: RoboForm, Logitech SetPoint Settings,Constant Guard Protec-
tion by Xfinity,Spybot,Killer Network Manager, Nahimic UI Interface.
• You are using a Wacom branded USB mouse/tablet. There is an incompatibility between Wacom drivers and
the graphics toolkit calibre uses. Try using a non-Wacommouse.
• Onsome 64 bitversions ofWindowsthere are securitysoftware/settings thatprevent64-bit calibrefromworking
properly. If you are using the 64-bit version of calibre try switching to the 32-bit version.
59
https://download.calibre-ebook.com/1.48.0/
60
http://www.mobileread.com/forums/forumdisplay.php?f=166
1.8. Frequently Asked Questions
119
C# PDF File Compress Library: Compress reduce PDF size in C#.net
Bookmarks. inputFilePath = Program.RootPath + "\\" 3.pdf"; String outputFilePath = Program.RootPath + "\\" 3_optimized.pdf"; // create optimizing options
acrobat split pdf bookmark; how to bookmark a page in pdf document
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
bookmarks in pdf reader; edit pdf bookmarks
calibre User Manual, Release 2.56.0
• Ifthe crash happens whenyou are trying to copy text fromthe calibre e-book viewer, it is most likelycaused by
some clipboard monitoring/managing application you have running. Turn it off and you should be fine.
• Ifthe crashes happen specificallywhenyou are using a file dialog,like clicking on the Add Books buttonor the
Save to Disk button, then you have some software that has installed broken Shell extensions on your computer.
Known culprits include: SpiderOak, odrive sync and Dell Backup and Recovery. If you have one of these,
uninstall them and you will be fine. You can also use theNirSoftShellExtensionViewer
61
to see what shell
extensions are installed on your system and disable them individually, if you dont want to uninstall the full
program. Rememberto use “Restart Explorer” or reboot your computerafter disabling the shell extensions.
If none of the above apply to you, then there is some other program on yourcomputer that is interfering with calibre.
First reboot your computer in safe mode, to have as few running programs as possible, and see if the crashes still
happen. If they do not, then you know it is some program causing the problem. The most likely such culprit is a
program that modifies other programs’ behavior, such as an antivirus, a device driver, something like RoboForm (an
automatic form filling app) or an assistive technology like Voice Control or a Screen Reader.
The only way to find the culprit is to eliminate the programs one by one and see which one is causing the issue.
Basically,stop a program, run calibre,check forcrashes. If they still happen,stop another programand repeat.
Using the viewer or doing any conversions results in a permission denied error on Windows
Something on yourcomputeris preventingcalibre fromaccessing its own temporary files. Mostlikelythe permissions
on your Temp folder are incorrect. Go to the folder file:C:\Users\USERNAME\AppData\Local in Windows Explorer
and then right click on the file:Temp folder, select Properties and go to the Security tab. Make sure that your user
account has full control for this folder.
Some users have reported that running the following command in an Administrator Command Prompt fixed their
permissions. To get an Administrator Command Prompt search for cmd.exe in the start menu, then right click on the
command prompt entry and select Run as Administrator. At the command prompt type the following command and
press Enter:
icacls "%appdata%\..\Local\Temp" /reset /T
Alternately,you can run calibre as Administrator,but doing so will cause some functionality,such as drag and drop to
not work.
Finally,some users have reported that disabling UAC fixes the problem.
calibre is not starting/crashing on OS X?
One common cause offailures on OS Xis theuse ofaccessibility technologies thatare incompatible with the graphics
toolkit calibre uses. Try turning off VoiceOver if you have it on. Also go to System Preferences->System->Universal
Access and turn off the setting for enabling access for assistive devices in all the tabs. Another cause can be some
third party apps that modify system behavior,such as Smart Scroll.
You can obtain debug output about why calibre is not starting by running Console.app. Debug output will be printed
to it. If the debug output contains a line that looks like:
Qt: internal: -108: Error ATSUMeasureTextImage text/qfontengine_mac.mm
then the problemis probably a corrupted font cache. You can clear the cache by following theseinstructions
62
.If that
doesn’t solve it, look for a corrupted font file on your system, in ~/Library/Fonts or the like. An easy way to check
for corrupted fonts in OS X is to start the “Font Book” application, select all fonts and then in the File menu, choose
“Validate fonts”.
61
http://www.nirsoft.net/utils/shexview.html
62
http://www.macworld.com/article/1139383/fontcacheclear.html
120
Chapter 1. Sections
C# Create PDF Library SDK to convert PDF from other file formats
file. Create and save editable PDF with a blank page, bookmarks, links, signatures, etc. Create fillable PDF document with fields.
add bookmark pdf; creating bookmarks pdf files
VB.NET Create PDF Library SDK to convert PDF from other file
Create and save editable PDF with a blank page, bookmarks, links, signatures, etc. Create fillable PDF document with fields in Visual Basic .NET application.
how to create bookmark in pdf automatically; bookmark template pdf
calibre User Manual, Release 2.56.0
Idownloaded the installer, but it is not working?
Downloading fromthe Internet can sometimes result ina corrupted download. Ifthe calibre installeryoudownloaded
is not opening,trydownloadingit again. If re-downloading itdoes not work, download itfromanalternatelocation
63
.
If the installer still doesn’t work, then something on your computer is preventing it fromrunning.
• Try temporarily disabling your antivirus program (Microsoft Security Essentials, or Kaspersky or Norton or
McAfee orwhatever). This is most likely the culprit if the upgrade process is hanging in the middle.
• Try rebootingyour computer and running a registry cleanerlikeWiseregistrycleaner64.
• Try a clean install. That is, uninstall calibre, delete C:\Program Files\Calibre2 (or wherever you
previously chose to install calibre). Then re-install calibre. Note that uninstalling does not touch your books or
settings.
• Try downloading the installer with an alternate browser. For example if you are using Internet Explorer, try
using Firefox or Chrome instead.
• If you get an error about a missing DLL on Windows, then most likely, the permissions on your temporary
folder are incorrect. Go to the folder C:\Users\USERNAME\AppData\Local in Windows explorer and
then right click on the Temp folder and select Properties and go to the Security tab. Make sure that your user
account has full control forthis folder.
If you still cannot get the installer to work and you are on Windows, you can use thecalibreportableinstall
65
,which
does not need an installer(it is just a zip file).
My antivirus program claims calibre is a virus/trojan?
The first thing to check is that you are downloading calibre from the official website: https://calibre-ebook.com/
download.Makesureyouareclickingthedownloadlinksontheleft,nottheadvertisementsontheright.calibreisa
very popular program and unscrupulous people try to setup websites offering it for download to fool the unwary.
If you have the official download and your antivirus program is still claiming calibre is a virus, then, your antivirus
program is wrong. Antivirus programs use heuristics, patterns of code that “look suspicious” to detect viruses. It’s
rather like racial profiling. calibre is a completely open source product. You can actually browse the source code
yourself(orhiresomeonetodoitforyou)to verify thatitis notavirus. Please reportthe falseidentificationtowhatever
companyyou buyyourantivirus softwarefrom. Ifthe antivirus programis preventing youfromdownloading/installing
calibre, disable it temporarily,install calibre and then re-enable it.
How do I backup calibre?
The most important thingto backup is the calibre library folder,that contains all your books andmetadata. This is the
folder you chose for your calibre library when you ran calibre for the first time. You can get the path to the library
folder by clicking the calibre icon on the main toolbar. You must backup this complete folder with all its files and
sub-folders.
You can switch calibre to using a backed up library folder by simply clicking the calibre icon on the toolbar and
choosing your backup library folder. Abacked up libraryfolderbacks up yourcustom columns and saved searches as
well as all your books and metadata.
If you want to backup the calibre configuration/plugins, you have to backup the config directory. You can find this
config directory via Preferences->Miscellaneous. Note that restoring configuration directories is not officially sup-
ported, but should work in most cases. Just copy the contents of the backup directory into the current configuration
directory to restore.
63 https://github.com/kovidgoyal/calibre/releases/latest
64 http://www.wisecleaner.com
65 https://calibre-ebook.com/download_portable
1.8. Frequently Asked Questions
121
.NET PDF SDK - Description of All PDF Processing Control Feastures
Full page navigation, zooming & rotation; Outlines, bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. Conversion. PDF Create.
how to add bookmarks to pdf document; excel hyperlink to pdf bookmark
XDoc.Word for .NET, Advanced .NET Word Processing Features
& rotation; Outlines, bookmarks, & thumbnail display; Integrated annotation; More about Web Viewer ▶. Conversion. Word Create. Create Word from PDF; Create Word
create pdf bookmarks online; bookmark page in pdf
calibre User Manual, Release 2.56.0
How do I use purchased EPUB books with calibre (or what do I do with .acsm files)?
MostpurchasedEPUB books haveDRM
66
.This prevents calibre from opening them. You can still use calibre to store
and transfer them to your ebook reader. First, you must authorize your reader on a windows machine with Adobe
Digital Editions. Once this is done, EPUB books transferred with calibre will work fine on your reader. When you
purchase an epub book from a website, you will get an ”.acsm” file. This file should be opened with Adobe Digital
Editions, which will then download the actual ”.epub” ebook. The ebook file will be stored in the folder “My Digital
Editions”, from where you can add it to calibre.
Iam getting a “Permission Denied” error?
Apermission denied error can occur because of many possible reasons, none of them having anything to do with
calibre.
• You can get permission denied errors ifyou are using an SD card with write protect enabled.
• Ifyou, orsome program you used changed the file permissions of the files in question to read only.
• If there is a filesystem error on the device which caused your operating system to mount the filesystem in read
only mode ormark a particularfile as read only pending recovery.
• Ifthe files have their owner set to a user other than you.
• Ifyour file is open in anotherprogram.
• Ifthe file resides on adevice,you mayhave reached the limit ofa maximumof256 files inthe rootofthedevice.
Inthis case you needto reformat the device/sdcardreferred to in the errormessage with a FAT32filesystem, or
delete some files fromthe SD card/device memory.
You will need to fix the underlying cause of the permissions error before resuming to use calibre. Read the error
message carefully,see what file it points to and fix the permissions on that file or its containing folders.
Can I have the comment metadata show up on my reader?
Most readers do not support this. You should complain to the manufacturer about it and hopefully if enough people
complain, things will change. In the meantime, you can insert the metadata, including comments into a “Jacket page”
at the start of the ebook, by using the option to “Insert metadata as page at start of book” during conversion. The
option is found in the Structure Detection section ofthe conversion settings. Note that for this to have effect you have
to convert the book. If your book is already in a format that does not need conversion, you can convert from that
format to the same format.
Another alternative is to create a catalog in ebook form containing a listing of all the books in your calibre library,
with theirmetadata. Click-and-hold the convert button to access the catalog creation tool. And before youask, no you
cannot have the catalog “link directly to” books on your reader.
How do I get calibre to use my HTTP proxy?
By default, calibre uses whatever proxy settings are set in your OS. Sometimes these are incorrect, for example,
on Windows if you don’t use Internet Explorer then the proxy settings may not be up to date. You can tell calibre
to use a particular proxy server by setting the http_proxy environment variable. The format of the variable is:
http://username:password@servername you should ask your network administrator to give you the cor-
rect value for this variable. Note that calibre only supports HTTP proxies not SOCKS proxies. You can see the current
proxies used by calibre in Preferences->Miscellaneous.
66
https://drmfree.calibre-ebook.com/about#drm
122
Chapter 1. Sections
calibre User Manual, Release 2.56.0
Iwant some feature added to calibre. What can I do?
Youhave two choices:
1. Create a patch by hacking on calibre and send it to me for reviewand inclusion. SeeDevelopment
67
.
2. Openabugrequestingthefeature
68
.Rememberthat while you maythinkyourfeature request is extremely
important/essential, calibre developers might not agree. Fortunately, calibre is open source, which means
you always have the option of implementing your feature yourself, or hiring someone to do it for you.
Furthermore,calibre has a comprehensive pluginarchitecture,soyou mightbe able to developyourfeature
as a plugin, seeWritingyourownpluginstoextendcalibre’sfunctionality(page 169).
Why doesn’t calibre have an automatic update?
For many reasons:
• There is no need to update every week. If you are happy with how calibre works turn off the update notification
and be on your merry way. Check back to see if you want to update once a year or so. There is a check box to
turn offthe update notification, on the update notification itself.
• calibre downloads currently useabout100TBofbandwidthamonth
69
.Implementing automatic updates would
greatly increase that and end up costing thousands of dollars a month, which someone has to pay.
• IfIimplementa dialogthatdownloads the update andlaunches it,instead ofgoingto the website as it does now,
that would save the most ardent calibre updater, at most five clicks a week. There are far higher priority things
to doin calibre development.
• Ifyou really, really hate downloading calibre every week but still want to be up to the latest, I encourage you to
run fromsource, whichmakes updating trivial. Instructions areavailablehere(page 271).
• There are third party automatic updaters for calibre made by calibre users in thecalibreforum
70
.
How is calibre licensed?
calibre is licensed under the GNU General Public License v3 (an open source license). This means that you are free
to redistribute calibre as long as you make the source code available. So if you want to put calibre on a CD with your
product, you must also put the calibre source code on the CD. The source code is availablefordownload71. You are
free to use the results of conversions from calibre however you want. You cannot use either code or libraries from
calibre in your software without making yoursoftware open source. For details, seeTheGNUGPLv3
72
.
How do I run calibre from my USB stick?
Aportable version ofcalibre is availablehere
73
.
How do I run parts of calibre like news download and the content server on my own linux server?
First, you must install calibre onto yourlinux server. If yourserver is using a modern linuxdistro,you should have no
problems installing calibre onto it.
67
https://calibre-ebook.com/get-involved
68
https://calibre-ebook.com/bugs
69
https://calibre-ebook.com/dynamic/downloads
70
http://www.mobileread.com/forums/forumdisplay.php?f=238
71
https://download.calibre-ebook.com
72
http://www.gnu.org/licenses/gpl.html
73
https://calibre-ebook.com/download_portable
1.8. Frequently Asked Questions
123
calibre User Manual, Release 2.56.0
Note: calibre needs GLIBC >= 2.13 and libstdc++ >= 6.0.17. If you have an older server, you will either need to
compile these from source, or use calibre 1.48 which requires only GLIBC >= 2.10. In addition, although the calibre
command line utilities do not need a running X server, some of them do require the X server libraries to be installed
on your system. This is because the use Qt,which links against these libraries. If you get an ImportError about some
Qt modules,you are likelymissing some Xlibraries.
You canrun the calibre server via the command:
/opt/calibre/calibre-server --with-library /path/to/the/library/you/want/to/share
You candownload news and convert it into an ebook with the command:
/opt/calibre/ebook-convert "Title of news source.recipe" outputfile.epub
If you want to generate MOBI, use outputfile.mobi instead and use --output-profile kindle.
You canemail downloaded news withthe command:
/opt/calibre/calibre-smtp
Ileave figuring out the exact command line as an exercise forthe reader.
Finally,you can add downloaded news to the calibre library with:
/opt/calibre/calibredb add --with-library /path/to/library outfile.epub
Rememberto read the commandline documentationsection ofthe calibreUser Manualto learnmore about these, and
other commands.
1.9 Tutorials
Here you will find tutorials to get you started using calibre’s more advanced features,such as XPath and templates.
1.9.1 Managing subgroups of books, for example “genre”
Some people wish to organize the books in their library into subgroups, similar to subfolders. The most commonly
provided reason is to create genre hierarchies, but there are many others. One user asked for a way to organize
textbooks by subject and course number. Another wanted to keep track of gifts by subject and recipient. This tutorial
will use the genre example forthe rest of this post.
Before going on, please note that we are not talking about folders on the hard disk. Subgroups are not file folders.
Books will notbe copied anywhere. Calibre’s library file structure is not affected. Instead,we are presenting a way to
organize and display subgroups ofbooks within a calibre library.
• Setup (page 126)
• Searching (page 128)
• Restrictions(page 128)
• UsefulTemplateFunctions(page 129)
The commonly-provided requirements for subgroups such as genres are:
• A subgroup (e.g., a genre) must contain (point to) books, not categories of books. This is what distinguishes
subgroups fromcalibre user categories.
124
Chapter 1. Sections
calibre User Manual, Release 2.56.0
• A book can be in multiple subgroups (genres). This distinguishes subgroups fromphysical file folders.
• Subgroups (genres) must forma hierarchy; subgroups can contain subgroups.
Tags give you the first two. If you tag a book with the genre then you can use the tag browser (or search) for find the
books with that genre, givingyouthe first. Many books can have the same tag(s), giving youthe second. The problem
is that tags don’t satisfy the third requirement. They don’t provide a hierarchy.
Calibre’s hierarchy featuregives you the third,the ability
to see the genres in a ‘tree’ and the ability to easily search for books in genre or sub-genre. For example, assume that
your genre structure is similar to the following:
Genre
History
.. Japanese
.. Military
.. Roman
Mysteries
.. English
.. Vampire
Science Fiction
.. Alternate History
.. Military
.. Space Opera
Thrillers
.. Crime
.. Horror
etc.
By using the hierarchy feature, you cansee these genres in the tag browser in tree form, as shown in the screen image.
In this example the outermost level(Genre)is a customcolumn that contains the genres. Genres containingsub-genres
appearwith a small triangle next to them. Clicking on that triangle will openthe item and show the sub-genres, as you
can see with History and Science Fiction.
Clicking on a genre can search for all books with that genre or children of that genre. For example, clicking on
Science Fiction can give all three of the child genres, Alternate History, Military, and Space Opera. Clicking on
1.9. Tutorials
125
calibre User Manual, Release 2.56.0
Alternate History will give books in that genre, ignoring those in Military and Space Opera. Of course, a book can
have multiple genres. If a book has both Space Opera and Military genres,then you will see that book if you click on
either genre. Searching is discussed in more detail below.
Another thing you can see from the image is that the genre Military appears twice, once underHistory and once under
Science Fiction. Because the genres are in a hierarchy, these are two separate genres. A bookcan be in one,the other,
or(doubtfully in this case) both. Forexample, the books in Winston Churchill’s “The Second World War” could be in
“History.Military”. David Weber’s HonorHarringtonbooks couldbe in “Science Fiction.Military”, and forthat matter
also in “Science Fiction.Space Opera.”
Once a genre exists, that is at least one book has that genre, you can easily apply it to other books by dragging the
books from the library view onto the genre you want the books to have. You can also apply genres in the metadata
editors; more on this below.
Setup
By now,your question might be “How was all of this up?” There are three steps: 1) create the custom column, 2) tell
calibre that the new column is to be treated as a hierarchy,and 3) add genres.
You create the custom column in the usual way, using Preferences -> Add your own columns. This example uses
“#genre” as the lookup name and “Genre” as the column heading. The column type is “Comma-separated text, like
tags, shown in the tagbrowser.”
Then afterrestarting calibre,you must tell calibre that the column is to be treatedas a hierarchy. Go to Preferences ->
Look and Feel -> Tag Browser and enter the lookup name “#genre” into the “Categories with hierarchical items” box.
Press Apply,and you are done with settingup.
126
Chapter 1. Sections
Documents you may be interested
Documents you may be interested