hasezoey/koreader_on_tolino.md

## koreader_on_tolino.md

      
    Raw
  

              koreader_on_tolino.md
            
          
    Install KOReader on a Tolino Device

Tolino Debug Menu codes

For KOReader (or any other APK) to be installed on a Tolino device, the debug menu has to be enabled:

if the tolino is on system version 14, search for code 124816 source
if the tolino is on system version 15, search for code 1123581321 source
if the tolino is on system version 16, search for code 112358132fb source

Note: "searching" as in the search for books on the tolino itself (the magnifying glass in the top bar)
Enable Debug-Menu Settings

Once in the Debug Menu, do the following things (may be named differently based on software version):

Change the Environment to prod (debuggable) (optional)
Change usb debugging to be enabled (enables ADB)
if not wanting to ever put the debug code ever in again, enable show debug dialog quick access button (the button can be found in the search when not having put in anything yet)

Additional Notes about the debug menu:

On a separate page the AOSP Settings can be accessed, through which WIFI, APPs and Developer settings can be accessed (like a normal phone)

Note: the pages in the Debug Menu can be switched by swiping the direction you want or clicking either < or > in the top of the dialog
Install

Install the APK through the Debug menu

When wanting to install the KOReader APK without ADB, then follow these steps:

connect your tolino with your PC
put the koreader (or any other apk) directly in the root directory for the tolino device (make sure the file end in .apk)
switch the page in the debug menu until seeing Next, Install & Uninstall buttons
select the APK you want to install with Next if not already selected
install the APK with Install

Note: if the APK does not show up, try restarting the tolino and try again
Install through ADB

When wanting to install the KOReader APK through ADB, then follow these steps:

ensure you have ADB installed on your PC
connect your tolino with your PC
run adb devices to check that the tolino is visible
if any Allow this device dialog shows up on the tolino, accept it
run adb install ./koreader.apk (replace ./koreader.apk with the path to the APK)
wait for the command to finish and KOReader is installed

Tolino System Updates while KOReader is installed

Due to how Tolino is set-up (at least in Vision 5), there are 2 important partitions:

System, ~500mb - stores the system and extra apps
Data, ~5GB (on a Vision 5)

Tolino's base system consumes ~200mb and update packages are commonly ~100-170mb only are getting downloaded to the system partition, but this can get close to the limit already, but with KOReader installed and unpacked which is around ~40mb apk size and ~100mb unpackaged extra size, this can result in too low space for a update, so the workaround is to Clean Data of KOReader App before installing. This will not delete any configuration or books (with default paths) and will only delete the unpacked files from KOReader.
Extra Notes


it is recommended to install a separate APK for a Home Screen, because KOReader itself is not a Home Screen and Tolino does not start other apps, so the only other way would be through ADB
it is recommended to install a separate APK for Buttons, because the tolino system does not have the android navigation buttons enabled (and can also not be done through settings on system 15)
F-Droid could once also be installed on the tolino as a APK, but currently (September 2022) it seems like F-Droid upgraded the version requirement and so cannot be installed on the android 4.4 versions anymore that tolino (Vision 5 and below) use

Bricked System

In case there should ever be a bricked tolino, you can go to https://mytolino.de/software-updates-tolino-ereader/ and download the version for your device and fully reset your system through recovery.
The steps would be as follows:

shutdown your tolino while having it connect to a PC OR use adb reboot recovery
run watch -n 1 adb devices in a terminal on your PC (or run adb devices manually until a device shows up)
hold the POWER-button on the Tolino device until the command from watch (or manual commands) show a device in recovery
if the output should not show anything related to recovery or the device should start-up normally, re-try from step 1
run adb sideload ./path/to/update.zip
wait for it to finish and reboot the device (for example with adb reboot)

Note: the USB has to be connected while shutting down, because otherwise the device will start itself up again on connection (like it unlocks / starts the lockscreen just by plugging it into power)

  
## personal_notes.md

      
    Raw
  

              personal_notes.md
            
          
    The guide above is meant to be generally generic, and in this file i will provide some things i had done for myself:
As the extra apps i have used:

for a Home Screen: SmartLauncher
for the buttons: ButtionSavior (non root)

Personally i have also enabled the runtime ART in developer-settings and think the performance is better than before, though i dont have any comparison.

Note that switching to ART will reboot the device (or at least require a reboot) and the next boot can take very long, for me it took ~30 minutes.
Rooting is also possible (at least adbd rooting), though it requires a custom adb and i have personally only used it for debugging and would not recommend to go through the hassle.
I had also wrote the guide for users wanting to customize their tolino without having to scavenge forums (especially when most are german) and outdated information, so i tried to include the most important information for various versions and devices.
If there should be any questions or outdated information, i will try to keep this updated, though i only have a Vision 5 and it seems unlikely to change much anymore, seeing that a Vision 6 is released with a upgraded system.