App::termpub - Epubreader for the terminal
termpub file
termpub aims to be a full features epub reader for the terminal. It supports internal and external links, skips the front matter and will display images with an external viewer. Your reading position will be saved and restored.
Many text movement commands are compatible with less(1).
The text will be hyphenated if the hyphenation patterns from hunspells libhyphen are installed.
Hyphenate text. Defaults to true.
Set the language used for hyphenation. Defaults to the books language or 'en-US' if not specified.
Set screen width. Defaults to 80.
Display help screen.
Go to the next chapter.
Go to the previous chapter.
Jump to the table of contents.
Followed by any lowercase letter, marks the current position with that letter.
Followed by any lowercase letter, returns to the position which was previously marked with that letter. Followed by another single quote, returns to the position at which the last "large" movement command was executed.
Set pager width to num.
Go to a line N percent into the chapter.
Go to line num in the chapter, defaults to 1.
Go to line num in the chapter, default to the end of the chapter.
Open link num. termpub calls xdg-open with the url as first argument if the link references an external ressource.
Cancel numeric prefix num argument.
Scroll one line down.
Scroll one line up.
Scroll forward one window.
Scroll backward one window.
Go to the beginning of the current chapter.
Go to the ned of the current chapter.
Go back or forward in the chapter history.
Quit.
Quit without saving the current reading position.
When termpub is invoked, it will attempt to read a configuration file named .termpubrc in your home directory. If this file does not exist termpub will try to read $XDG_CONFIG_HOME/termpub/termpubrc.
The configuration file consists of a series of commands. Each line may only contain one command. The hash mark is used as a comment character. All text after the comment character to the end of the line is ignored. The file is expected to be utf8 encoded.
The following commands are defined:
Enables or disabled hyphenation
Set the language used for hyphenation.
Set screen width to num.
If you have cpanminus installed, you can simply install this program by calling
$ cpanm .
Otherwise you can build a standalone script with
$ ./build-standalone
and copy the generated script termpub somewhere in your path. In this case you need to installed the dependencies yourself. Termpub depends on the perl modules Mojolicious, Curses and Archive::Zip. On Debian the following command will install these packages.
$ apt-get install libmojolicious-perl libcurses-perl libarchive-zip-perl
Copyright 2019 Mario Domgoergen <mario@domgoergen.com>
<mario@domgoergen.com>
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
To install App::termpub, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::termpub
CPAN shell
perl -MCPAN -e shell install App::termpub
For more information on module installation, please visit the detailed CPAN module installation guide.