https://github.com/jichu4n/jfbview

PDF and image viewer for the Linux framebuffer.
https://github.com/jichu4n/jfbview

framebuffer image-viewer pdf pdf-viewer

Last synced: about 17 hours ago
JSON representation

PDF and image viewer for the Linux framebuffer.

• Host: GitHub
• URL: https://github.com/jichu4n/jfbview
• Owner: jichu4n
• Created: 2012-11-10T05:57:00.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2021-10-19T15:51:02.000Z (about 3 years ago)
• Last Synced: 2023-04-01T14:57:57.231Z (almost 2 years ago)
• Topics: framebuffer, image-viewer, pdf, pdf-viewer
• Language: C++
• Size: 1.23 MB
• Stars: 95
• Watchers: 11
• Forks: 16
• Open Issues: 10
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
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](https://github.com/jichu4n/jfbview/workflows/build/badge.svg)

[![Travis CI Build Status](https://travis-ci.org/jichu4n/jfbview.svg?branch=master)](https://travis-ci.org/jichu4n/jfbview)

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](https://github.com/jichu4n/jfbview/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](#source-code) section below, then see

[`packaging/build-package-deb.sh`](https://github.com/jichu4n/jfbview/blob/master/packaging/build-package-deb.sh).

### CentOS / Fedora

See [Releases](https://github.com/jichu4n/jfbview/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](#source-code) section below, then see

[`packaging/build-package-rpm.sh`](https://github.com/jichu4n/jfbview/blob/master/packaging/build-package-rpm.sh).

### Installing from source

#### Dependencies

  - [NCURSES](https://invisible-island.net/ncurses/ncurses.html)

  - [libjpeg](http://libjpeg.sourceforge.net/) or [libjpeg-turbo](https://libjpeg-turbo.org/)

  - [OpenJPEG / openjp2](https://github.com/uclouvain/openjpeg)

  - [FreeType](https://www.freetype.org/)

  - [HarfBuzz](https://www.freedesktop.org/wiki/Software/HarfBuzz)

  - [zlib](https://www.zlib.net/)

Build-time dependencies:

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

  - [CMake](https://cmake.org/) 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](https://github.com/jichu4n/jfbview/releases) for

full source code archives including all transitive dependencies

(`jfbview--full-source.zip`).

#### Build & install

```

cmake -H. -Bbuild

cd build

make

make install

```

DOCUMENTATION

-------------

See [jfbview man page](https://htmlpreview.github.io/?https://github.com/jichu4n/jfbview/blob/master/doc/jfbview.1.html).

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.