Librerator is a fork of KindlePDFViewer. I forked it after PR no.616 was merged, a little bit before version 2012.11 of KPV was released. I merged most of PRs after no.616, but not all.
Before forking, I contributed a number of changes to KPV which ended up in KPV 2012.11. Most notable ones are:
Comics mode (renamed to Align the viewport to top/bottom in 2012.11 and made default). In fit-to-content-width zoom mode, it always fills screen with page content, aligning the bottom of the page to the bottom of the screen, thus preventing situation when you have only 3 or so last lines of the page on top of the screen, and the rest of it blank. I also added overlap support for this mode in 2012.11. (Comics mode was first introduced in 2012.10, and overlap was not working then, since it was originally meant for reading manga. I later realized it could be useful for books too). On by default, it can be turned off by pressing “C”. Its state is saved per book.
Right-To-Left mode - for reading manga and languages that are written right to left. Fully supported in 2 column mode too. Off by default, it can be turned on pressing “U”. Its state is saved per book.
Page/viewport mode - change the behaviour of page forward/page backward keys. When in viewport mode, these keys will move viewport in “smart” zoom modes - Fit-to-content-width and 2 column mode, showing you the part of the same page that was not on the screen before pressing them, and when in page mode, they will immediately display the next/previous page. Default is viewport mode, but it can be changed pressing “P”. Its state is saved per book.
Using symbolic defines for most configurable parameters and moving them to a file defaults.lua, making changes of default configuration much easier for the user.
Force portrait mode on opening KPV and closing documents - both to avoid a bug that caused crashes in previous versions, and because FileChooser is not very usable in landscape mode on K2/K3/KDX.
Changes listed bellow are specific to Librerator and are not part of KPV 2012.11:
Name change, together with change of launchpad shortcut, to differentiate from KPV, and allow potential users to have both of them installed separately. Open Last documents shortcut from launchpad is removed to simplify things - a user can just press “L” after the FileChooser is shown. I believe that only a few power users would use this, and they would know how to add it back themselves..
Bookmark added and bookmark already exists still conveyed to the user through InfoMessage, because I don’t like the new style on top of the screen. However, I made it configurable - you can have them the way KPV 2012.11 does it if you set DKPV_STYLE_BOOKMARKS in defaults.lua to true.
Added separate setting for Info Messages delay for toggles in defaults.lua, because I don’t like having to watch at them for full 1.5 sec. If you want them to last longer, you can specify the value DINFO_TOGGLES in defaults.lua.
Changed some defaults to my liking:
option KPV Librerator DRCOUNTMAX 0 10 DSHIFT_Y 50 100 DSTEP_MANUAL_ZOOM 16 25 DUNIREADER_SHOW_OVERLAP_ENABLE true false DUNIREADER_SHOW_LINKS_ENABLE true false DDJVUREADER_SHOW_OVERLAP_ENABLE true false DKOPTREADER_SHOW_OVERLAP_ENABLE true false
Changed keybindings for Zoom modes - most frequently used ones are usable without Shift now. Info (on Menu key on KPV) is now on Alt-Menu.
Changed the way manually set BBox works - now it doesn’t display a ruler and Q-P shortcuts. Instead, it’s a lot cleaner with only crosshairs displayed, and the step of moving them can be adjusted pressing “Q” for big, “A” for normal, “Z” for small - all configurable through defaults.lua. Using small step, BBox can now be set much more precisely. InfoMessage will now also show if it’s an odd or an even page. If someone doesn’t like this new style, the old one can be brought back uncommenting some lines, and commenting some other at the end of unireader.lua. It’s clearly marked in the code, so it shouldn’t be too difficult. However, in that case step cannot be adjusted - it will always use the value set as DBBOX_STEP_NORMAL in defaults.lua.
Simplified handling of BBoxes internally - only the values for odd and even pages are kept now. No specific settings per page.
Removed legacy crop commands (Z and Alt-Z). Shift-Z modified to remove manually set BBoxes.
Forcing portrait mode on start and document close made configurable through defaults.lua
The way screen rotation is handled has been changed. Now, “K” will rotate the screen to landscape with keys on the left, and “J” will rotate it with the keys to the right. When in landscape mode, both “J” and “K” will return it to the normal portrait mode. If someone doesn’t like it this way, it can be reverted to the old way setting DPREVENT_UPSIDE_DOWN to false in defaults.lua
Rotation by 10 degrees has been removed, because it’s mostly useless. However, if someone really needs it (highly doubtful, but...), I just commented them out in unireader.lua, so you can easily add them back.
In lists (Table of Contents, Highlights, Bookmarks) and FileChooser you can now use Shift-Up/Shift-Down to move 5 items up or down. Using shift will not move to the next/previous page of the list, so it can be used to quickly get to the last/first item. The number of items to move up/down is configurable through defaults.lua, DSM_SHIFT_UP_DOWN for lists, and DFC_SHIFT_UP_DOWN for FileChooser. Also, pressing up/down (without Shift) will not change page anymore - pressing up on first item will go to the last item on the same page and vice versa. Use page turn buttons to change page. The user can also change default fonts and sizes for lists by editing corresponding options in defaults.lua.
Removed Q-P etc. shortcuts in lists (Table of Contents, Highlights, Bookmarks, Menu), because I like more space for the actual entry better. However, if you absolutely cannot live without them, you can put them back setting DKPV_STYLE_LISTS to true in defaults.lua.
Highlights line colour, line width and style made configurable through defaults.lua
Completely redesigned InputBox. Apart from the new look, it now supports typing with only FiveWay keys. To make it usable on K4NT, up/down don’t change the layout anymore, and Menu key opens a layout selection. Switching between English/National layout was moved to Aa. You can fully edit long filenames now too.
New set of bigger icons for FileChooser, and new icons in dialogs
The way manual zoom is calculated is changed. It now adds the step to the global 100%, not to the current zoom state. Manual zoom is now also available through the Main Menu.
Most options are now accessible via Menu.
Changed the way Gamma is changed. It now adds/decreases the value defined in DGAMMA_STEP (initially 0.2).
Added setting of first page offset. This is useful when you have a book that starts page numbering with e.g. i, ii, iii, iv etc (for preface, table of conents pages etc), and the real page 1 is actually page 17 (for example). Without setting first page offset, every time you read “see page 128” you’ll have to remember to add 17 to that when you use Goto command. When you use first page offset command, you get a “First page is page no.” dialog. Enter 17 there. Now, you just have to enter 128 in that Goto dialog, and it will lead you to the right page. Real page numbers will be reported when you add bookmarks too. I suggest you set first page offset first time when you open the book and never change it. If you do, bookmarks will not lead to the right pages anymore. If you need to jump to the pages bellow 1, you can use Goto with negative numbers. This is also usefull when your document is a part of a book, for example it has pages 41-100. In this case, you should set first page offset to -41.
Alt-back will now only close book. Alt-Home will close the application (even when you have a book opened. No need to first close the book, then application like before)
- librerator-prerelease.1.zip released
fixed bugs reported by Iñigo, that prevented it working on K4NT out-of-the-box
Added full support for CREReader (epub/fb2 files). You should now be able to change font, font size, line spacing, add bookmarks, use goto etc.
fixed crashes with options like bbox when used in reader they're not supposed to be used with. Now it just reports that the option is not supported for that document type.
- librerator-prerelease.2.zip released
- librerator-R1.zip, first official release released
- librerator-R2.zip released