Tree [r26] / cbrpager-maemo / branches / MAEMO_0_9_20 /
History



File Date Author Commit
debian 2008-11-06 bge [r26] Use built-in zip support instead of calling com...
po 2008-10-29 bge [r22]
src 2008-11-06 bge [r26] Use built-in zip support instead of calling com...
AUTHORS 2008-09-23 bge [r4] Initial Hildon release:
CONTRIBUTORS 2008-09-23 bge [r1]
COPYING 2008-09-23 bge [r1]
ChangeLog 2008-11-06 bge [r26] Use built-in zip support instead of calling com...
INSTALL 2008-09-23 bge [r4] Initial Hildon release:
Makefile.am 2008-09-23 bge [r4] Initial Hildon release:
Makefile.in 2008-10-29 bge [r22]
NEWS 2008-09-23 bge [r8] Oops, version number was wrong in NEWS file...
README 2008-09-23 bge [r5] Added Go To Page... feature (dialog + menu item...
TODO 2008-10-30 bge [r25]
acconfig.h 2008-09-23 bge [r4] Initial Hildon release:
aclocal.m4 2008-10-29 bge [r22]
autogen.sh 2008-09-23 bge [r1]
cbrpager.26.png 2008-09-23 bge [r4] Initial Hildon release:
cbrpager.40.png 2008-09-23 bge [r4] Initial Hildon release:
cbrpager.64.png 2008-09-23 bge [r4] Initial Hildon release:
cbrpager.desktop 2008-09-23 bge [r4] Initial Hildon release:
cbrpager.glade 2008-10-29 bge [r22]
cbrpager.gladep 2008-09-23 bge [r4] Initial Hildon release:
cbrpager.spec 2008-10-04 bge [r12] - Fix key handling for n810, hopefully.
config.guess 2008-09-23 bge [r4] Initial Hildon release:
config.h.in 2008-09-23 bge [r4] Initial Hildon release:
config.sub 2008-09-23 bge [r4] Initial Hildon release:
configure 2008-10-29 bge [r22]
configure.in 2008-11-06 bge [r26] Use built-in zip support instead of calling com...
depcomp 2008-09-23 bge [r1]
install-sh 2008-09-23 bge [r1]
missing 2008-09-23 bge [r1]
mkinstalldirs 2008-09-23 bge [r1]

Read Me

cbrPager for Maemo (c) 2008 John Coppens and Benoit Goudreault-Emond
--------------------------------------------------------------------

This is a port of cbrPager to the Maemo platform.  See below for the
original README file by John.

There are very few user-visible differences between the stock cbrPager
and the Maemo version. Here they are:

	 - No need to install unzip for 'cbz' archives.  You still need
	   unrar for 'cbr' because it's non-free so I can't link it in
	   without violating the license.

	 - Hard keys are mapped to something sane.  Zoom in/out work,
	   so does full screen.  Escape rotates.  Up and Down go
	   back and forward one page.  Right zooms to fit to screen
	   and Left zooms to 1:1.  Menu opens the menu (duh...)

	 - The original had the toolbar as a floating window on top
	   of the main.  For Maemo, it's a regular toolbar; it's only
	   visible when not in full screen.

	 - It uses the Maemo file picker and other built-in widgets.

Internally, Gnome dependencies were removed, which introduced quite
a few code differences.  John and I hope to be able to merge this
in the medium term.

In the meantime, you can try building it on a plain desktop by running
configure without the --enable-hildon to get access to the additional
features, but most are only accessible through hotkeys (see the
configuration dialog to see which).  I'll remedy this if there is any
interest.  But most likely you should wait for us to merge this to the
mainline.

Enjoy!

-- BGE


  cbrPager (c) 2004- - John Coppens
  --------

This is a simple pager, written out because I did not want to dedicate
the huge Java resources just to page through images.

It's released under the General Public License. The exact details are
contained in the COPYING document included.

As it is, the executable is only about 100 kB, and has the following
features:

	- It does 'cbr', 'cbz' and 'cb7' files - I haven't encountered
	  any other types of archives yet. Maybe someone will come up 
	  with cbz2?

	- It decodes 'jpg' and 'jpeg' images, and should do gifs
	  and pngs.

	- When paging, it tries to be logical, going to the top
	  of the next page and bottom of the previous page (settable).

	- You can zoom in and out

Notes:

I'm not a very great reader of comic books, I just encountered one I
liked and was then surprised that I could not locate a native reader 
for the format. It seemed a nice challenge, and some problems did
arise from unsuspected corners. Later I found that this format is 
quite usable to group scanned documents...

So, I hope it's useful to someone.

Greetings,
John


Generating RPMs
---------------
  Several people asked me to generate an RPM. My distro (Slackware) doesn't
know rpms. Emmanuel Seyman seyman[at]wanadoo.fr, sent me a specfile
which can be used to generate an rpm, using the command:

	rpmbuild -tb cbrpager-x.y.z.tar.gz

where x.y.z is, of course, the right version. Though I offered to add
an rpm to the package, according to Emmanuel, this is not as easy as it
seems, as even rpms are not the same for each distribution.



Usage
-----
  It's not too difficult to use cbrPager, I guess. At least I've tried
to keep it as simple as possible.

  Though it can be used just as a GUI for reading cbr/cbz/cb7 archives,
since 0.9.8, it can also be used as a viewer for many file managers such as
Midnight Commander or Rox, because it can now receive the name of the file
to be opened as a command line parameter.

  From that version on, it is also permitted to have a mix of image
formats inside the archive (at first, cbrPager needed all of the images
to be of the same type).