PDF and image viewer for the Linux framebuffer.
  • C++ 81.5%
  • CMake 8.9%
  • Shell 5.6%
  • Python 4%
Find a file
smallsolar bfabc2fb9b
Some checks failed
build / Fedora 42 aarch64 (push) Has been cancelled
build / Fedora 43 aarch64 (push) Has been cancelled
build / Debian Bookworm amd64 (push) Has been cancelled
build / Debian Bullseye amd64 (push) Has been cancelled
build / Ubuntu Jammy amd64 (push) Has been cancelled
build / Debian Bookworm arm64 (push) Has been cancelled
build / Debian Bullseye arm64 (push) Has been cancelled
build / Debian Trixie arm64 (push) Has been cancelled
build / Debian Bookworm armhf (push) Has been cancelled
build / Debian Bullseye armhf (push) Has been cancelled
build / Debian Trixie armhf (push) Has been cancelled
build / Debian Bookworm i386 (push) Has been cancelled
build / Debian Bullseye i386 (push) Has been cancelled
build / Debian Trixie i386 (push) Has been cancelled
build / Arch Linux x86_64 (push) Has been cancelled
build / Ubuntu Noble amd64 (push) Has been cancelled
build / Debian Trixie amd64 (push) Has been cancelled
build / Fedora 43 x86_64 (push) Has been cancelled
build / Fedora 42 x86_64 (push) Has been cancelled
build / E2E tests (Debian Trixie amd64) (push) Has been cancelled
build / Full source package (push) Has been cancelled
added simple touch control using tslib and assigning areas to the keyboard as commands
2026-08-07 07:40:49 +00:00
.github/workflows Update goldens for MuPDF 1.27. 2026-04-24 20:28:54 -07:00
cmake Use system openjpeg. 2020-06-03 17:17:32 -07:00
doc Add GIFS to README. 2026-06-17 16:47:40 -07:00
packaging Fix build output permissions and add clean script. 2026-04-23 23:44:14 -07:00
src added simple touch control using tslib and assigning areas to the keyboard as commands 2026-08-07 07:40:49 +00:00
tests Update goldens for MuPDF 1.27. 2026-04-24 20:28:54 -07:00
vendor Update to MuPDF 1.27.2. 2026-04-24 08:57:30 -07:00
.clang-format Apply clang-format. 2018-10-18 20:18:29 -07:00
.gitattributes Use system openjpeg. 2020-06-03 17:17:32 -07:00
.gitignore E2E screenshot tests via QEMU. 2026-04-23 17:16:26 -07:00
.gitmodules Add mupdf v1.17.0 as git submodule. 2020-05-13 22:55:32 -07:00
CMakeLists.txt Bump version to 0.7.0 2026-04-24 22:02:17 -07:00
README.md Update README. 2020-05-25 22:52:16 -07:00

JFBVIEW

GitHub Workflow Build Status

jfbview is a PDF and image viewer for the Linux framebuffer. Features include:

  • Zoom and rotation
  • Table of Contents (TOC) viewer
  • Interactive text search

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

Screenshots

Scroll & zoom

Table of contents

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 13 "trixie": amd64, i386, arm64 (ARMv8), armhf (ARMv7)
  • Debian 12 "bookworm": amd64, i386, arm64, armhf
  • Debian 11 "bullseye": amd64, i386, arm64, armhf
  • Ubuntu 24.04 LTS Noble: amd64
  • Ubuntu 22.04 LTS Jammy: amd64

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.

Fedora

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

  • Fedora 43: x86_64, aarch64 (ARMv8)
  • Fedora 42: x86_64, aarch64

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.