Skip to content

jichu4n/jfbview

Repository files navigation

JFBVIEW

jfbview is a PDF and image viewer for the Linux framebuffer. It's fast and has some advanced features including:

  • Arbitrary zoom (10% - 1000%) and rotation;
  • Table of Contents (TOC) viewer for PDF documents;
  • Interactive text search for PDF documents;
  • Multi-threaded rendering;
  • Asynchronous background pre-caching;
  • Customizable multi-threaded caching.

The home page of jfbview is at https://github.com/jichu4n/jfbview.

GitHub Workflow Build Status Travis CI Build Status

INSTALLATION

Arch Linux / Manjaro

Install package jfbview from the AUR, e.g.

yay -S jfbview

Source: https://aur.archlinux.org/packages/jfbview

Debian / Ubuntu

See Releases for pre-built .deb packages for the following environments:

  • Debian 10 "buster": amd64, i386, arm64 (ARMv8), armhf (ARMv7), rpi (Raspbian on ARMv6)
  • Debian 9 "stretch": amd64, i386, arm64, armhf, rpi
  • Ubuntu 20.04 LTS Focal: amd64
  • Ubuntu 18.04 LTS Bionic: amd64, i386
  • Ubuntu 16.04 LTS Xenial: amd64, i386

To build from source, fetch the source code along with transitive dependencies as described in the Source code section below, then see packaging/build-package-deb.sh.

CentOS / Fedora

See Releases for pre-built .rpm packages for the following environments:

  • CentOS 8 and Fedora 28+: x86_64, aarch64 (ARMv8)

To build from source, fetch the source code along with transitive dependencies as described in the Source code section below, then see packaging/build-package-rpm.sh.

Installing from source

Dependencies

Build-time dependencies:

  • C++ compiler with support for C++14 (GCC 4.9+, Clang 3.5+)

  • CMake 3.3+

Source code

To fetch the source code along with all transitive dependencies with git:

git clone https://github.com/jichu4n/jfbview.git
cd jfbview
git submodule update --init --recursive

Alternatively, see Releases for full source code archives including all transitive dependencies (jfbview-<VERSION>-full-source.zip).

Build & install

cmake -H. -Bbuild
cd build
make
make install

DOCUMENTATION

See jfbview man page.

ABOUT

jfbview is written by Chuan Ji, and is distributed under the Apache License v2.

HISTORY

jfbview started as a fork of FBPDF by Ali Gholami Rudi with improvements and bug fixes, and was named JFBPDF. The JFBPDF code (in C) grew steadily more convoluted as features were added, and finally was completely rewritten from scratch in November 2012, with added support for images through Imlib2.