apvlv(1)

📦
version 0.7.0-final · 3 versions
, in debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 apvlv — bestie edition 💖

okay so welcome to apvlv(1), straight out of the General Commands Manual section 🎀 this is the page for apvlv, and trust me, if you live in a terminal and you read things, this is your moment. periodt.

✨ NAME ✨

apvlv — a PDF/DJVU/EPUB/HTML/TXT/FB2/CZW viewer with vim-like behaviour 🦋

like… it opens your documents AND it moves like vim?? it's giving main character energy fr fr 👑

🌸 SYNOPSIS 🌸

apvlv [options] [file]

💅 DESCRIPTION 💅

apvlv is a PDF/DJVU/EPUB/HTML/TXT/FB2/CZW viewer, which behaves like vim.

that's it. that's the whole vibe. you already know if this is for you 💜

🎀 OPTIONS 🎀

  • -c file — load configuration from file instead of the default ~/.apvlvrc. yes bestie, you can have a custom rc file, go off 💖
  • -h — show help message and exit 🙈
  • -v — show version and exit ✨

👑 COMMANDS 👑

The following command keys can be used inside apvlv. Some of them may be prefixed by a number (as in pressing "13G"), this is indicated by a count in their description. Unless noted otherwise, the default value for the number is 1.

  • o — display file chooser to open a PDF/DJVU/EPUB/HTML/TXT file 🍓
  • O — select a directory to display
  • t — display file chooser to open a PDF/DJVU/EPUB/HTML/TXT file in a new tab
  • T — select a directory to display in a new tab
  • R — reload the current file 🔄
  • r — rotate the document clockwise by 90 degrees
  • G — show page number count
  • gt — show next tab
  • gT — show previous tab
  • PageDown, C-f — go forward count pages
  • PageUp, C-b — go backward count pages
  • C-d — go forward count half pages
  • C-u — go backward count half pages
  • H — scroll to page head
  • M — scroll to page middle
  • L — scroll to page bottom
  • s — skip some pages count
  • C-p, Up, k — scroll up count units
  • C-n, Down, j — scroll down count units
  • Backspace, Left, h — scroll left count units
  • Space, Right, l — scroll right count units
  • / string — search forwards for string 🔍
  • ? string — search backwards for string 🔍
  • f — toggle between fullscreen and window mode
  • zi — zoom in
  • zo — zoom out
  • zw — zoom to fit window width
  • zh — zoom to fit window height
  • m char — mark the current position to char, so that it can be recalled by pressing char
  • ' char — return to the mark position char
  • '' — return to the last position
  • q — close the current window
  • ZZ — quit the viewer with ZZ, like Vim 🫡
  • c — toggle directory display

🌈 SETTINGS 🌈

These can be set in ~/.apvlvrc with "set setting [= value]".

  • fullscreen = yes/no — enable/disable fullscreen
  • width = int — default window width
  • height = int — default window height
  • fix_width = int — fixed width
  • fix_height = int — fixed height
  • defaultdir = path — default directory for the open dialogue
  • zoom = mode — set default zoom level
    • normal — the application sets the default zoom value
    • fitwidth — fit pages to window width
    • fitheight — fit pages to window height
    • float — 1.0 for 100%, 2.0 for 200%, etc.
  • continuous = yes/no — show PDF/DJVU/EPUB/HTML/TXT pages continuously or not.
  • autoscrollpage = yes/no — enable/disable scrolling the pages when hitting a page tail/head
  • noinfo = yes/no — disable/enable the usage of ~/.apvlvinfo
  • max_info = int — max file information will be saved, default is 100
  • scrollbar = yes/no — set show scrollbar or not
  • wrapscan = yes/no — set wrapscan to search text or not
  • doubleclick = action — set default double click action
    • none — selection nothing
    • word — selection a word under the cursor to clipboard
    • line — selection a line under the cursor to clipboard
    • page — selection a page under the cursor to clipboard
  • guioptions = mTsS — weather display menu, toolbar, status and status tool.
  • .pdf:engine = MuPDF/Poppler/QtPdf — which engine to render .pdf file
  • .epub:engine = MuPDF/Web — which engine to render .epub file
  • .fb2:engine = MuPDF/Web — which engine to render .fb2 file
  • ocr:lang = eng+chi_sim — pretrained languages which tesseract load to process
  • notes:dir = dir — directory to save ebook notes
  • autoreload = int — if auto reload document after some seconds
  • inverted = yes/no — if use inverted mode for pdf page
  • background = color — set background color

🦋 PROMPT 🦋

Like the COMMANDS, but prefixed with a colon :

  • :h[elp] — display the help document
  • :q[uit] — close the current window
  • :o[pen] file — open file
  • :doc file — load file into the current window
  • :TOtext [file] — translate file (or the current page) to a text file
  • :pr[int] — print the current document
  • :tabnew — create a new tab
  • :sp — horizontally split the current window
  • :vsp — vertically split the current window
  • :fp, :forwardpage [int] — go forward int pages (1 by default)
  • :bp, :prewardpage [int] — go backward int pages (1 by default)
  • :g, :goto int — go to page int
  • :z[oom] mode — set zoom to mode (see "set zoom" in SETTINGS)
  • : int — go to page int
  • :directory — toggle directory display

💜 AUTHORS 💜

apvlv was written by Alf <naihe2010@126.com>.

This manual page was originally written by Stefan Ritter <xeno@thehappy.de> for the Debian project (but may be used by others), and was rewritten more beautifully by Daniel Friesel <foobar@derf.homelinux.org>.

and that's the whole page bestie!! this one's from the Debian manual set, dated December 24, 2009 🎄 go read something cute, you got this 💖✨🫶

📦 where this page comes from