UserGuideEn - natowi/prs-plus GitHub Wiki

Overview of Options

PRS+ is a custom firmware that enhances the existing firmware on your Sony Reader. PRS+ does not replace the original Sony firmware; rather, it adds further customization options to enhance your reading experience. Below you will find an overview of the many customization options available with PRS+. (Note: Some options are only available with certain models and are so noted with the appropriate model numbers, eg., "350/650/950.")

Key Bindings

Key bindings allow you to (re-)assign various functions to the hardware buttons. Separate functions can be assigned to a short press and long press (hold for 3-5 seconds). For example, you might re-assign the Home button so that it opens the Table of Contents with a short press or puts the Reader to sleep with a long press.

Key functions are context specific. There are 3 different contexts:

  • Global - works everywhere (this makes sense for actions like "take a screenshot")
  • When in Menu - works only when you are in the main menu
  • When Reading Book - works only when you are reading a book

See also Actions.


Menu Customizer

Menu Customizer allows you to customize the main menu. Some menu items ("slots") belong to the system and cannot be replaced; these are referred to as "fixed slots." Slots are numbered as follows:

300/505 600* 350/650/950
http://wiki.prs-plus.googlecode.com/hg/img/um20/menu-slots-300-505.jpg http://wiki.prs-plus.googlecode.com/hg/img/um20/menu-slots-600.jpg

*This doesn't look logical, but it's how they are numbered internally.

Book History

Book History

Book History allows you to choose how many recently read books are remembered. Select "Disabled" to switch it off. The "Disabled" option can also be used to reset the list.

Skip book menu (300/505)

This option allows you to skip the book menu when opening books via Book History.
Entering book Skip book menu when entering a book
Exiting book Skip book menu when exiting a book
Always Always show book menu
Always Never show book menu

Browse Folders

Browse Folders allows you to browse your books by folder.

Sorting Mode

Sorting Mode allows you to choose how books are sorted when you use Browse Folders. Note: Sorting is always case sensitive.
By Title Sort by book title
By author then title Sort by book author, then title
By filename Sort by filename (shows book title and author)
By filename shown as comment Sort by filename (shows book title and filename; author is not shown)

Internal Memory Root folder

This option allows you to set the default (root) folder that first opens when you use Browse Folders. For instance, if you choose "/books" as your root folder then put all your books in a folder called "books" in the root directory of your Reader, then whenever you select Browse Folders, you will be taken directly to your "books" folder. This saves you at least one click. (Sony software normally puts books into "/database/media/books")

NOTE: Folder names are case sensitive. If your books are in a folder named "BOOKS" or "Books" and you select "/books" as your startup folder, it will lead to problems.

Favorite folders

This is an advanced feature that allows further customization of the starting view in Browse Folders. See folders.cfg for more details.
Enabled "Browse Folders" will use the configuration defined in folders.cfg located in /database/system/PRSPlus/ in your Reader's internal memory
Disabled folders.cfg will be ignored

".." (prev folder element)

If enabled, this option will show ".." in the Browse Folders view. Pressing on ".." has exactly the same effect as pressing on "<-" (back arrow) button.

Show File Size & Type in Comment

If enabled, this adds the file size and type information to book comments.

SD/MS Card Scan

This option controls how MS/SD cards are handled on startup.
Enabled MS/SD cards are scanned on startup. As with the standard firmware, if you have a huge number of books your MS/SD card, startup will take a very long time.
Disabled MS/SD cards are ignored at startup. Startup will be quick, but files on MS/SD cards will be visible only via Browse Folders, where you'll get options to copy books to Internal Memory and open them from there.
Disabled (load cache) This is a compromise setting that disables scanning, but allows you to open books directly from the SD/MS card. If you don't understand how the cache works, please read How Card Scan And Cache Work before using this option. Otherwise, results may be unexpected.

Use Mount with SD/MS

If you enable this option, you'll see 2 ways to access SD/MS cards in Browse Folders: normal and "via mount."

The standard firmware uses an unusual way to access SD/MS card content. Unfortunately it is buggy, but mostly affects users using non-Latin characters (e.g. Chinese, Cyrillic, Georgian). Users who cannot (or do not want to) rename folders and files on an SD/MS card could use this option. In this case, the standard Unix "mount" command is used to access cards. The downside of "mount" is that it is a bit slower, and it is no longer possible to open books directly from cards. (If you try to open a book "via mount" you'll see options to copy it to internal memory and open it from there.)

Book Viewer (350/600/650/950)

Don't Mask Overlap (350/650/950)

When reading in landscape mode, this option shows a mask over the part of the text that belongs to the next/previous half-page, which is standard for the 505/300/600 models.

While the name of this option may cause some confusion, it is taken from some internal code. Therefore: If set to "true," the mask is not drawn, and the Reader follows the standard behavior of the unaltered firmware. If set to "false" (the default), a mask of white dots will be drawn to gray-out the parts of the text which belong to the next/previous half-page.

Note: This option doesn't avoid the overlap, it merely obscures it.

No Dictionary with Double-Tap

If set to true, double-tapping no longer activates the dictionary.

Close Pop-up Menu by Page Tap

This option allows you to close the pop-up menu in books (which appears when you double-tap a word or select text) by tapping anywhere on the page above it.

Border Color

This option lets you change the color of the "canvas" shown around some PDFs from grey to white.

No Page Turn with Gestures

This option does exactly what the option's name says. If enabled/set to true, a gesture/swipe will no longer trigger a page turn. Please note that this does not disable touch functionality completely. Only page turns are affected. All other touch features are still accessible.

There is also a "key-bindable" action to toggle page turn by gestures on/off.

Page Turn by Single Tap

This option lets you turn pages by single-tapping specific areas of the page. You can choose to tap anywhere on the page for Next Page, or you can set it so that tapping one half of the page triggers Next Page, while the other half triggers Previous Page.

Panning While in Zoom Lock

This option allows you to 'drag' a page while in Zoom Lock mode (350/650/950) or Zoom mode (350/600/650/950), so that you can easily navigate to different areas of the page.

Custom View Settings (350/650/950)

These options allow you to bind your own values to the 'custom' setting of the 'Adjust View' option available in books. Use the first two options to set your own custom & brightness levels, and the third to activate them. Now when you are viewing a book, go to 'Adjust View', and press the box next to 'custom'. If you now press the Restore Button, it activates the contrast & brightness levels you set earlier.
Custom Contrast Allows you to set custom contrast
Custom Brightness Allows you to set custom brightness
Bind to Restore Button If set, pressing "restore" triggers custom settings

User EPUB Style (CSS File)

This feature allows you to use your own CSS file to specify custom fonts, font-size, line-height, and other CSS formatting. To use this feature, simply copy your custom CSS files into the folder /database/system/PRSPlus/epub

For more information on adding custom CSS files, and especially on using custom fonts, see
Ana Mardoll's blog and multiple threads on Mobile Read, such as this one.


LRF Text Scale

This feature allows you to set zoom levels in LRF. You must understand how cache works in order to use this feature. LRF Text Scale only works correctly on books that are not in cache (i.e., books that haven't been opened yet with a custom zoom level); otherwise, it leads to formatting errors, such as missing text/extra space at the bottom).


Screenshot

This feature allows you to take a screenshot. To use this feature, you need to bind this action to a key (see key bindings).


Scrollbar Alphabet

This option lets you select the alphabet used in the scrollbar (e.g., Latin, Cyrllic, etc.).


Standby Image

Standby Image Type

This option allows you to select the standby image.

System default For 505/300/600, a random image from /database/system/PRSPlus/wallpaper will appear. For 350/650/950 series, the standby image will be whatever you've set under the standard Sony system settings.
Current Book Cover Displays first page of the current book. If page 1 is an image of the book cover, then the book cover will appear. If page 1 contains only text, then that text will appear.
Current Screen The currently displayed screen will appear indefinitely. "Sleeping.." text will be shown on the right side of the status bar, replacing the clock (if the clock is enabled)

Dither Image

This option will additionally "dither" the wallpaper/bookcover. Dithering is a technique to reduce compression artifacts by adding noise. On monochrome displays (such as e-ink), this usually, gives the image a "crisper" overall look.


Book Management (350/650/950)

Customize Home Menu Booklist

Book Selection

This setting allows you to change which books are shown in the Home menu. In addition, there is an action (which you can bind to a key) which cycles through this setting's options.
Last Added Books (default) Shows the books last added to the device.
Last Opened Books Shows the last opened books, based on Book History.
Books by Same Author Shows books by the same author as the current book.
Next Books in Collection Shows the next books in the same collection as the current book. Using corresponding action, you can also cycle through collections, if the current book appears in more than one collection.
Random Books Shows randomly chosen books.

Ignore Memory Cards

This setting can be used to ignore SD and Memory Stick cards when compiling the Home menu booklist.

Show Reading Progress

These options display how far you are in each book. It is available for the current book (shown in the Home menu instead of 'Last Read' date/time) and for thumbnails (shown in the Home menu and all thumbnail views).
Show for Current Book Shows reading progress for the current book
Format for Current Book Allows you to select which format to use (e.g., Page 5 of 100, 5/100, 5%)
Show for Thumbnails Shows reading progress in all thumbnail views
Format for Thumbnails Allows you to select which format to use
Only show from page Sets a minimum page you have to reach before reading progress is shown. Example: If you choose "only show from page 10," you can open a book and browse through the first 9 pages without triggering reading progress. Reading progress will only appear once you've reached page 10.

Hide Default Collections

These options allow you to hide the three built-in collections and the "Add New Collection" option.
Hide Unread Books
Hide Unread Periodicals
Hide Purchased Books
Hide Add New Collection

Treat Periodicals as Books

This feature causes periodicals to appear in the books and collections lists. With this setting enabled, periodicals don't get any special treatment. It disables both notifications in the Home menu and the special navigation interface shown when reading a periodical.

TIP: Overall performance can be improved by enabling this setting, since it disables the periodicals filter used by the home menu booklist.

Set New Flag Manually

When you add a new book to your Reader, it automatically gets a "New" flag or badge. Normally this flag disappears once the book is opened, even if only for a second. By enabling this option, the "New" flag remains until you manually remove it using an on/off toggle in the Options menu. You can also manually restore the "New" flag if you change your mind.


Status Bar

Clock

Clock Style

24-hour example: 17:45
12-hour example: 5:45pm

Clock Mode

Always shown Clock is visible everywhere except in games and utilities
Shown only in menu Clock is shown only in main menu
Shown only when reading Clock is shown only when reading a book
Off Clock is never shown

Page Index

This feature allows you to choose the style for the page index in books, e.g. 1 of 259 (0%).
Supported modes are:
Always shown Index will always be shown
Not shown on single pages Not shown in "1 of 1" situations
Never shown Index is disabled

Actions

Utilities

Book History Jumps to the corresponding list
Browse Folders Jumps to the corresponding list
Take a Screenshot Takes a screenshot in jpg format, saving it either to internal memory or an external card, depending on the settings
Page Turn with Gestures on/off Toggles page turn gestures on and off (available only on readers with touch screen)

Games

Launches corresponding game.

Other

Shutdown Completely powers off the reader
Sleep mode Puts reader into sleep mode
Rotate Counter-Clockwise Rotates screen counter-clockwise
Rotate Clockwise Rotates screen clockwise
Rotate 0° -
Rotate 90° Rotates screen 90°
Rotate 180° Rotates screen 180°
Rotate 270° Rotates screen 270°
Next Song Jumps to the next song in the list
Previous Song Jumps to the previous song in the list
Cycle Home Menu Booklist Switches between book list modes (last added, last opened, etc)

Book

Next/Previous Page Jumps to the next or previous page (works only when reading books)
Next/Previous in History Jumps to the next/previous page in history. This is very handy in books with links as it allows you to jump "back" to the starting position, after clicking a link.
Continue Reading Jumps to the current book
Open Options Opens option menu
Search Opens search menu (350/650/950)
Previous Menu (Back / Up) Executes "back" action (same as holding "options" menu on 350/600/650/950 or "menu"/"back" buttons on 505/300
Size Opens font size menu (350/650/950)
Go to Home Jumps to main/Home menu
Open TOC Opens the current book's Table of Contents (works only when reading a book)
Open Notes List Jumps to notes
Zoom Page Opens zoom menu

Advanced topics

How Card Scan and Cache Work

Every time you disconnect your Reader from the USB port on your computer, or restart/reset it, or (re-)insert an SD/MS card, the Reader scans the SD/MS card looking for books/images, and reads the metadata (author, title, etc.) for each new book. Book metadata (along with information like bookmarks and current page) is then stored in the "Sony Reader" folder, which is created as a result of the scanning process. The scanning process also removes references to books that were deleted (or moved/renamed).

Scanning an SD/MS card is slower than scanning internal memory (which is also scanned, but its cache files are located in a different folder called "database"). This is due to the way the Reader accesses the card (for tech savvy users: mtools like utility).

The most important consequence of using the "Disabled (load cache)" option is that if you delete a book (which was opened and hence appears in the cache file) from the SD card using your PC, the Reader will not know that you've done so and will still show the book in a book list. If you try to open the book, it will result in an "invalid book" message. It is safe to delete the cache (in the "Sony Reader" folder) on SD/MS cards as long as you don't care about bookmarks and "current page" information. (This only affects books on the corresponding card.)

folders.cfg

When Favorite folders is enabled, Browse Folders will use the configuration defined in the folders.cfg file below.

The file format is: <name> <tab character> <path>
Any line that starts with "#" is treated as a comment.

Sample file (note that path to internal memory is "/Data/" not "/"):
# If "MyBooks" folder exist in internal memory, 
# it will be displayed as "My Books" and open
# /MyBooks folder, if selected
My Books /Data/MyBooks
# If memory stick is present, it will be
# shown as "MS Card" and open "books" folder
# on memory stick, if selected
MS Card a:
# If SD card is present, it will be shown
# as "SD Card" and open "books" folder on memory
# stick, if selected
SD Card b:

prsp.sh

If this file is present in /database/system/PRSPlus, it is executed during PRS+ boot. (Note that the path to internal memory is "/Data/" not "/")

Replacing LRF Fonts

For information on replacing LRF fonts, please check the How To Custom Fonts wiki page on the PRS+ project site.

CSS in epubs

For information on adding custom CSS files and especially on using custom fonts, see
Ana Mardoll's blog and multiple threads on Mobile Read, such as this one.
⚠️ **GitHub.com Fallback** ⚠️