baskerville / plato

Document reader

Plato is a document reader for Kobo's e-readers.

Documentation: GUIDE, MANUAL and BUILD.

Supported firmwares

Any 4.X.Y firmware, with X ≥ 6, will do.

Supported devices

• Elipsa 2E.
• Clara 2E.
• Libra 2.
• Sage.
• Elipsa.
• Nia.
• Libra H₂O.
• Forma.
• Clara HD.
• Aura H₂O Edition 2.
• Aura Edition 2.
• Aura ONE.
• Glo HD.
• Aura H₂O.
• Aura.
• Glo.
• Touch C.
• Touch B.

Supported formats

• PDF, CBZ, FB2, MOBI, XPS and TXT via MuPDF.
• ePUB through a built-in renderer.
• DJVU via DjVuLibre.

Features

• Crop the margins.
• Continuous fit-to-width zoom mode with line preserving cuts.
• Rotate the screen (portrait ↔ landscape).
• Adjust the contrast.
• Define words using dictd dictionaries.
• Annotations, highlights and bookmarks.
• Retrieve articles from online sources through hooks (an example wallabag article fetcher is provided).

Donations

plato's Issues

[feature]: internationalization (i18n) support

a big Thank you to @baskerville for plato and other great contributions to free software. Thanks again.

I would like to know if you are going to support translations anytime soon. Not a big deal to have the ui in english but it would be great.

Doesn't work on the Kobo Aura Version 2

See title, upon launch of plato (using fmon) it displays an Oops! This document couldn't be opened.

Adding Applications

Beforehand, thank you for a great software. Compiles clean, installs clean, smooth. My favorite reader on the kobo glo HD.

Applications are also great. 'Sketch' is very useful, and works better than an equivalent on my iphone 7+!

Was wondering: do you plan on adding new applications?
A reversi for instance ...?

Could try to make one myself, even if I'd have to translate my c++ knowledge to rust... which requires some time!

some issues about non-latin languages

Your plato-reader is fluency, but I met some issues with the recent version:
I'm a Chinese reader, Chinese words are not split by blank char, so one paragraph only displays the top several words, and the following is "..." in one line (eg: XXXXXXXX...), but the English books seem to be fine. So I supposed that the code may splits the paragraph to lines by blank. Is it possible to fix that?
(my font is Droid sans fallback, my device is H2O. The font in screenshot picture is another one. Japanese or Korean might have similar problems)
Thanks.

I'm glad to give assistance on test or translation if in need.

Old books still visible. Method to "reset" library?

Hi,

I recently deleted all books from my device (not with any sort of factory reset--just by deleting files). I then readded them with a new and improved folder structure. Now, Plato lists duplicate entries for many books, with one entry that actually opens the book, and the other which does nothing when tapped. Presumably, Plato's database has entries pointing to both the "old" and "new" file paths?

Is there a way to purge/reset Plato's database, such that the old books/paths are removed from the list?

Thank you!

MuPDF unbounded memory growth

When reading a PDF, scanned pages of a book, I got a crash saying: thread 'main' panicked at 'no entry found for key'. If I remember correctly I was browsing it, which is slow, it went unresponsive and I tried to get back to the shelf by touching the center of the screen. After a few second it rebooted.
I wasn't able to reproduce it.

while asleep the screen still rotate

With a Kobo Forma, when the device is "Seeping" the screen continue to rotate when it is moved around.

Edit: It also happen when connected to a computer, in "Shared" mode.

Enhancement: search in series

I've just noticed that you can search for author, title, and category but not for series...

Kobo Clara HD

The correct touch settings aren't currently there for the Clara HD.

Suggestion: Select extensions to be parsed

Plato seems like it has a lot of potential. However I am not ready to ditch nickel anytime soon, so it'd need to coexist with it.

Would it be possible to have a configuration file or menu with tick items in which we can select the extensions that will be included in plato? I'd like to exclude plain text files, html, etc., but keep epub/kepub/pdf/djvu.

Thanks et Bon Travail!

Ability to adjust text contrast like in KOReader

Please add the ability to adjust the text contrast like in KOReader.
I really prefer Plato for its speediness and clear interface, however that feature is a much-needed one especially for pdf's which have a greyish font.

Thank you in advance.
Great app

Installation instructions

Do you have any? Run cargo and put the bin somewhere?

[feature] Adding an eraser pen in Sketch

Currently we can only erase the whole page (with the "New" tab).

Do you think it's possible to add in Sketch the ability to erase only parts of the note ?
(Instead of writing lines, we erase what we touch).

It is currently partially doable using the white color pen over whatever we draw but the lines are still a little visible.

Thank you for your amazing job !

How to test on desktop

Hi,

I was wondering if you have a setup to test the application on a desktop? Or do you always run it on the kobo?

Regards,
Iwan

Japanese characters show up as blank characters on the menu.

I skimmed the other issues, but I don't think this was addressed: all Japanese characters show up as blank squares for me.

Plato seems noticeably faster than nickel, and I'm considering switching to it, but titles like 盾の勇者の成り上がり #3 show up as □□□□□□□□□□ #3 on the menu. I thought this was due to missing glyphs in the fonts available to plato, so I added IPAGothic.ttf to both /fonts and /.adds/plato/fonts in hopes that it'd fallback to the glyphs on that font. It didn't, the issue persists.

while searching physical buttons browse page by page

When searching in a book, pressing the physical buttons backward and forward flips through the books even if the next or previous page doesn't contain a match. It seems to me that it should flips trough the results of the search instead, skipping non matching pages, like it already does when touching the left/right ear or with the arrows of the search bar.

Revert to default suspend screen if selected book cover is deleted

At present, if you select a book cover as the suspend screen and then delete that book, Plato shows a blank screen when suspended, instead of the default image.

It would be better if Plato could revert to using the default suspend image when a book being used for the screen is deleted.

Unable to start plato on aura 2

Hi,
plato is correctly shown in ksm 09 but when selecting it, the ui blinks and nothing starts...

Any ideas why ?

Thanks !

Using "Go to page" increases font size after hitting "ALT" on the keyboard

Playing around with plato over the holidays, I've encountered a strange behaviour which might be an actual bug (I still see it with version 3.0.0):

• open the menu and decrease the font size
• then touch the "Page X of Y" at the bottom -> "Go to page" dialogue opens
• hit ALT to get to the keymap page with numbers and special characters -> font size increases significantly (that shouldn't happen, I think)

BTW, would it make sense to open the keyboard on the third (numbers etc) page? I think you have to use a number in the "Go to page"...

Ampersand in metadata (title) not supported

First off, great job on making a slick UI (koreader can learn a thing or three from this).

I don't think ampersands are supported in the summary view - I get the HTML reference for ampersand instead (&).

Here's the title I grabbed from Sigil's metadata editor: Prometheus: Up & Running

I'm happy to share the epub privately if it will help.

Table support for ePub

Does Plato support tables in epub? The tables in the epub from this website are just flattened: http://www.bottomupcs.com/

Go to previous chapter only goes back to the beginning of the current chapter

Hi,

First (and I know this is weird in a bugreport): thanks and bravo for Plato! It has become my new daily driver on a Kobo Aura 2: it is snappy, UI makes a lot of sense (and is super elegant) plus it has everything needed to do the job (read books) while keeping things simple. Great stuff!

Now for the bug :/ the "go to previous chapter" (long tap on the left ear) only works when I am in the middle of a chapter - it goes back to the beginning of the curent chapter as expected. However it doesn't allow me to move further on to the chapter before - as it is possible to do with the "go to next chapter".

Let me know if this makes sense (or not) and again: thanks for Plato!

with warm fronttlight getting to sleep make a blue flash

Getting the device to sleep when the frontlight is used with a warmth setting generates a blue "flash". As if the warmth setting was unset before the frontlight was turned off. This doesn't happen in Kobo's software.

By the way I wanted to thanks you for all your awesome software (plato, sxhkd and bspwm) I have been using day-to-day for several years now, their user interface are very well thought out!

[wishlist] add thumbnail previews in the book list

It would be great to have thumbnail previews in the book list (as in nickel, I guess it is a reduced version of the first page).

./plato: /lib/libc.so.6: version `GLIBC_2.18' not found (required by ./plato)

I installed plato-0.6.3 with KSM09, but whenever I touch the menu entry "start plato" nothing happens except for the screen flashing. A crash.log appears with this:
./plato: /lib/libc.so.6: version `GLIBC_2.18' not found (required by ./plato)

Broken USBMS behavior in Nickel

This appears to be new to FW >4.8, and I've seen it happen on an H2O, but given a recent report from a Forma user, I'd say it's everywhere (and was 100% reproducible on my end: start koreader or plato, exit -> nickel freaks out).

In short, while everything appears to work properly in Nickel, onboard is never actually unmounted on the device side, which obviously leads to fun FS shenanigans... Until you restart the device.

I think I fixed it in KOReader with koreader/koreader@cc5b96b, but I couldn't say exactly which bit did the trick....

I'd go with the PWD one, because that's vaguely relevant, at least ;).

Enhancement: add DOI to metadata/importer?

It seems that metadata.rs includes placeholders for ISSN and ISMN identifiers. Would it make sense to add DOI (http://www.doi.org/) one day to retrieve metadata for articles from e.g. scientific journals? Not sure if something like Crossref's REST API https://github.com/CrossRef/rest-api-doc and rcrossref https://github.com/ropensci/rcrossref could be used to request the metadata.

Build error: linking with `arm-linux-gnueabihf-gcc` failed: exit code: 1

I was trying to first build plato on Ubuntu LTS 12.04 32-bit, then I got this error:

linking with arm-linux-gnueabihf-gcc failed: exit code: 1

I have already installed gcc-4.6-arm-linux-gnueabihf. What should I do now?

P.S. When follow your building document, I couldn't find the config file so I created one in ~/.cargo and add the linker as well as rustflag. Might it be a problem?

mobi support?

Hi,
Thanks for this great project!
Is it on the road map to support mobi file format?

Include link to doc/ in readme

There should probably be a link to the guide or build instructions in README.md. I spent a few minutes looking around here and on mobileread before realizing there is a doc/ folder.

Can't change zoom mode to fit to width in non multi-touch devices (Glo)

Kobo Glo does not support multitouch, it seems there is no way to change zoom mode without it

Enhancement: universal typography settings

I'm not sure if I'm missing something, but neither koreader nor plato seems to have a feature that allows setting the font size, margins, etc. once and having it apply to all books by default. An easy way of implementing this would be to allow changing the default settings.

Some pages are skipped in epub

When reading an epub I have find out that some pages are skipped when going forward. Going backward after the skipped page displays it but the page number is not updated when on the skipped page. The issue isn't present when using Kobo software.

A picture is worth a thousand words

It happen at several places in the book.

Position off by a few pages after changing font size

Affected: Plato 0.3.0
How to reproduce:

• open a document in Plato (in my case it was an epub)
• go to the beginning of a chapter (not necessary but easier to see)
• open the top menu
• increase the font size with the slider -> position in the book is now off by a few pages
  or:
• decrease the font size with the slider -> position in the book is now also off by a few pages

Porting to Remarkable

Hello!

I wanna port your reader to Remarkable tablet. We got a full functional RUST toolchain:

https://github.com/rampantmonkey/remarkable.rs

(default pdf viewer is hella slow)
Got any caveats/recommendations/advice before I dig in?

Does it support format txt and multibyte charactors?

In readme, there is only
PDF, ePUB and CBZ via mupdf.
DJVU via djvulibre.

Is txt OK?
Is multi language possible?
Or is there something that can set up fonts and languages?

add plato-import in releases assets

It would be nice to have plato-import in the release assets as a statically link binary for at least the most popular x86_64.

I'm struggling to build plato on NixOS for non arm platform (ie. without running ./build fast) either through ./build slow and with Nix specific tools.

How are you syncing your content?

Would be great to embed a web client / browser or even better an ssh server (e.g. dropbear) for syncing content.
How are u syncing at the moment? Surely not over USB?

Where does plato search for files?

I'm running plato on a non-Kobo device (reMarkable). I've glanced through the source but I can't seem to figure out in what paths plato searches for documents. Any tips?

Enhancement: Peaceful coexistence with koreader - blacklisting .sdr directories and metadata files

If Plato imports files in a directory that is also used by koreader, metadata lua files and sdr directories are are also shown in Plato's file manager (as well as other non-ebook files). Would it be possible to "blacklist" these files (or to whitelist known ebook file extensions)?

How to install via KSM?

I downloaded the KSM version of plato, and I added the plato folder to .adds.

But how do I start it? It doesn't show up in the KSM like koreader does.

Does often not remember current page (Kobo Clara HD w/ KFMon

When powering off and on again the current page/progress is lost. The current page is, I am asuming, written when exiting a book to the main menu. This means when powering off or crashing Plato looses the progress since last exiting to the menu.
In case there is no good reason against it i would suggest saving the current page on a pageturn event instead.

Automatically go into "shared" mode when plugged in

To make the process of transferring files as quick as possible, it would be nice to have a setting in the Settings.toml file to automatically go into shared mode when the Kobo is plugged into an usb port. The dialog box seems a bit superfluous, given that the only reason that I can think of now for plugging in the device is going into shared mode. Additionally, there really is no way I will accidentally plug my Kobo into my PC.

Not sure if you're open to tiny "feature creep" like this, but it fits the minimal character of plato imo.
Excellent work btw! Can't wait on what the future will hold.

[wishlist] add text-alignment setting

The actual settings are great, but there is no text-alignment setting. It would be great to add this!

Crash on specific epub

This ebook (http://lise-henry.github.io/books/trpl2.epub) always crashes my Plato out to KSM. The source to generate the epub is here (https://github.com/lise-henry/books/blob/master/README.md). I'm using a Kobo Touch.

[FR] limit auto-rotation angles

It would be great to have a setting to limit the auto-rotation to some angles, similar as what smartphones are doing. Either disabling it totally or limiting rotations to some set of angles: 0°, 90°, 180° and 270°. That way you can force the page orientation to stick to portrait (0°, 180°) or landscape (90°, 270°).

Superscript not supported in ePub

In http://www.bottomupcs.com/ (epub) (Table 2.1) the superscripts are rendered as normal text.

Enhancement: add case-insensitive search

For book titles in my collection, I can find both title-casing and sentence-casing. Since searches in plato are case-sensitive I sometimes have to type in both variants to find a certain book. Using case-insensitive search (by default or as an added option) would save some time.
I might have already seen a TODO in the code concerning case-insensitive search?

Abbreviating long tags

Small UX suggestion; I have some really long tags in my book collection. As it stands, it takes the whole width of the screen so I can't easily see another tag to filter by. Could we abbreviate tags to some smaller default (7 characters or something customizable)? Thanks.

The fontsize or brightness controls act non-intuitively

Using v0.3.7 on a Kobo Aura H2O Edition 2. If you drag the sliders from their current position to a new position, they will ultimately come back to their previous state. However, if you tap the new setting, the setting will be successfully applied and they will stay in position.