NAME

ebk-find — select and open a book from a Calibre library

SYNOPSIS

DESCRIPTION

The ebk-find command launches a fuzzy finder program, presenting the titles, authors, and tags of all the books in the given library. Start typing to narrow down the list to the book to open. When a book has been selected, ebk-find will open the corresponding e-book file in the system default viewer for that file format.

By default, ebk-find opens the EPUB file for the selected book, if there is one; otherwise, it opens the PDF, if there is one; otherwise, it opens the first file it can find. The order of preferred formats can be changed with the -f flag.

ebk-find calls xdg-open(1) to open the selected book. If that command is not available on the system, use the -n flag and pass the printed path to a different command (see EXAMPLES below).

OPTIONS

The default behaviour can be overridden with the following option flags:

-f, --format-preference formats

comma-separated list of file extensions in order of preference (default: ‘epub,pdf’)

-h, --help

Print usage information and exit.

-l, --library path

path to the library (default: $HOME/Calibre Library)

-n, --dont-open

Print path to stdout instead of opening it.

-s, --selection-command command

command to run to select a book (default: ‘fzf --exact’)

-V, --version

Print the program version and exit.

ENVIRONMENT

The default behaviour can be changed by setting these environment variables:

EBOOKRACK_LIBRARY

path to the default library

EBOOKRACK_FIND_SELECTOR

command to run to select a book (typically a fuzzy finder)

EXIT STATUS

The ebk-find utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

Selecting and opening a book from the default library:

SEE ALSO

calibredb(1), fzf(1), xdg-open(1)

AUTHORS

Code and documentation by JA Viljoen <ebookrack@javiljoen.net>.