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

This is a fork for the reMarkable.

Also see darvin's work of porting plato to the reMarkable 2 years ago. ( I read nice mangas with his port. :) )

Install on reMarkable

Using an existing build

• Go the releases and get the latest build (attached file with "dist" in the name).
• Copy the unpacked contents that file to your device to a folder of your choice (e.g. using scp or an sftp client like Filezilla or WinSCP)
• SSH into your reMarkable and run the file plato.sh. E.g. /home/root/plato/plato.sh
• Add it to draft for easier launching without SSH-ing.

By default files are used from the empty media folder you got in the release. You can change this in the Settings.toml.

Notes: The software automatically recognizes the running UI (xochitl) and kills it. If it did so, you'll only have the option to "Quit to Xochitl", which will automatically start xochitl again when quitting. Should the software crash (had one case with a bad czb file) the screen will seem frozen. Either launch draft again, or hold the power button for about 10 seconds (= poweroff) and then hold it again to start the device again.

Compiling yourself

You need rust (nightly) the a toolchain for compiling code for an arm system (e.g. search for a package that provides commands like "arm-linux-gnueabihf-gcc").

After that, you can build the software using build.sh and create the same directory as attached using dist.sh (folder dist/).

Or just look at the file make_remarkable.sh which checks the above condition and runs a full clean build for you. Documentation: GUIDE, MANUAL and BUILD.

 

reMarkable 2 support

The reMarkable 2 is supported as well. Some features were initially added with the rM 1 in mind and may therefore have deminishing functionaility on the rM 2. An example are the refresh modes, which will not be that granular due to the reduced access to the framebuffer.

Otherwise everything should work fine.

Environment variables for this port

• PLATO_DISABLE_BUILTIN_SWTFB_CLIENT=1: Legacy. Now just sets LIBREMARKABLE_FB_DISFAVOR_INTERNAL_RM2FB=1
• LIBREMARKABLE_FB_DISFAVOR_INTERNAL_RM2FB=1: On the reMarkable 2, RM2FB will be used directly by default (removing the need to invoke the shim). This behavior can be unwanted sometimes and is disabled by this env being set. It results in this application treating the framebuffer like a reMarkable 1 one (expecting a shim e.g. by setting LD_PRELOAD or running through rm2fb-client. Otherwise crashes).
• PLATO_ALLOW_HW_ROTATION=1: Allows the rM 1 to use hardware rotation instead of software one. Hardware roation can be faster, but causes issues with launchers that never expect the framebuffer to be hw rotated before taking over. Used to be enabled default in prior versions of this plato port.

Supported firmwares

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

Supported devices

• Libra Colour.
• Clara Colour.
• Clara BW.
• 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