GREEN - A light weight PDF reader

NAME

green - a lightweight PDF reader for the Framebuffer using libpoppler

SYNOPSIS

green [options] <PDF file 1> [PDF file 2] ...

DESCRIPTION

green is meant to be a light PDF reader for the Linux Framebuffer. However, it can also be used inside a graphical X11 Session like GNOME or MATE.

green features:

uses libpoppler for PDF reading
uses SDL to support various frontends (including framebuffer)
multiple documents
single page mode
fit width, height or page
zooming
goto page
search function
scheme support

OPTIONS

-fit= with one of none, width, height or page tp select the program wide page fitting mode. -width= with an integer greate equal zero (in pixels) to specify the startup width of the window. -height= with an integer greate equal zero (in pixels) to specify the startup height of the window. -fullscreen= startup in fullscreen mode. -nofullscreen= startup in window mode. -config= with a file name of a configuration file. -scheme= with an <id list> (see below) to select a different scheme.

PROGRAM OPERATION

<TAB> - Go to the next open document.
<F<n>> - Go to the n-th document.
ESC - Escape current input mode.
q - Quit

NAVIGATION INSIDE A DOCUMENT

<h, left arrow> - Scroll left.
<l, right arrow> - Scroll right.
<j, down arrow> - Scroll down.
<k, up arrow> - Scroll up.
<pg up> - Go to previous page.
<pg dn> - Go to next page.
<g<n>RETURN> - Go to page n.
<+,-> - Zoom in, Zoom out.
c - close document.

FITTING

fn - disable page fitting mode. fw - fit page width. fh - fit page height. fp - fit whole page.

SEARCHING

s<X><RETURN> - Start search for string X. n - Show next result.

OTHER STUFF

When starting green in Framebuffer console you might see an error regarding the mouse. If you don't need mouse in the console:

SDL_NOMOUSE=1 ./green

Should work around the problem. Other wise you should be able to use the mouse in the Framebuffer as none root user. On Debian based distributions:

Create new file /etc/udev/rules.d/99-input.rules:

# file /etc/udev/rules.d/99-input.rules
KERNEL=="mice", NAME="input/%k", MODE="664", GROUP="input"
KERNEL=="mouse*", NAME="input/%k", MODE="664", GROUP="input"

Then issue:

groupadd input
usermod -a -G input [your_username]

Restart your computer and you should be able to use the mouse with SDL.

FILES

$(HOME)/.green.conf
Per user configuration file.

/usr/local/etc/green.conf
The system wide configuration file.

AUTHOR

The Green source code may be downloaded from http://github.com/schandinat/green/.
Green is Licensed under GNU GPL version 3.
This man page was written for the Debian GNU / Linux System by Oz Nahum nahumoz@gmail.com.

myrfa/green