diff options
Diffstat (limited to 'content/blog/kobo_clara-plato.md')
| -rw-r--r-- | content/blog/kobo_clara-plato.md | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/content/blog/kobo_clara-plato.md b/content/blog/kobo_clara-plato.md new file mode 100644 index 0000000..b7de110 --- /dev/null +++ b/content/blog/kobo_clara-plato.md | |||
| @@ -0,0 +1,129 @@ | |||
| 1 | +++ | ||
| 2 | title = "Kobo Clara HD Notes for Plato (and KSM)" | ||
| 3 | date = 2021-03-27 | ||
| 4 | +++ | ||
| 5 | |||
| 6 | These are my notes for getting Plato on the Kobo Clara HD from scratch | ||
| 7 | as well as some notes for getting KSM to work, but I now boot directly | ||
| 8 | into Plato instead of through KSM. | ||
| 9 | |||
| 10 | Previously, I didn't really like using KOReader because it was kind of | ||
| 11 | slow and was written in Lua. At the time of using Plato, it seemed nice | ||
| 12 | but it didn't cover thumbnails for books, which while it is a minor | ||
| 13 | detail, I find books easier to be recognized with a cover thumbnail in | ||
| 14 | addition to their title. This was added in release 0.9.10 but as an | ||
| 15 | optional feature which I didn't somehow see until recently when I | ||
| 16 | retried it. HOWEVER again, I didn't like using k/fmon as I had to still | ||
| 17 | use Nickel to get back into KOReader/Plato/whatever alternate reader | ||
| 18 | when I wanted to go away from using Nickel. | ||
| 19 | |||
| 20 | <ignore> | ||
| 21 | That was when I found out about KSM and how there was a working version | ||
| 22 | for the Clara HD. KSM is like an alternate bootloader for the Kobo | ||
| 23 | readers and it apparently doesn't work very well with newer models like | ||
| 24 | the Clara HD and up, but someone got it to work with those devices. | ||
| 25 | [KSM 09](https://www.mobileread.com/forums/showthread.php?s=c34e41df391c61810a6b06f991c29168&t=293804) is apparently not maintained anymore and I'm not sure if KSM | ||
| 26 | 10 is being developed or not since I'm pretty sure it's closed source. | ||
| 27 | |||
| 28 | > Development and support for KSM stopped some time ago. Therefore, do | ||
| 29 | > not use it! | ||
| 30 | |||
| 31 | "That sign can't stop me because I can't read!" - Me imitating D.W. | ||
| 32 | from the PBS Kids cartoon Arthur on Mar. 26, 2021 when I saw that it | ||
| 33 | can be used on my Kobo | ||
| 34 | |||
| 35 | The latest firmware version that KSM sort of supports is v4.25.15875 | ||
| 36 | but it can probably work with a newer version like v4.26+ that would | ||
| 37 | likely only need a couple changes to /etc/init.d/rcS, if any changes | ||
| 38 | were needed at all. I'll be using v4.26 for the rest of this | ||
| 39 | article/guide. | ||
| 40 | </ignore> | ||
| 41 | |||
| 42 | Recently, after seeing how my Kobo boots into KSM and Nickel through | ||
| 43 | the rcS file, I realized that I could've instead just booted directly | ||
| 44 | into Plato, and plato.sh (the script that runs Plato) has a standalone | ||
| 45 | option that supports just that! The KSM notes are still going to be | ||
| 46 | here in case someone still wants to use KSM. | ||
| 47 | |||
| 48 | ## Installing Plato (or probably any other reader like KOReader) | ||
| 49 | This part probably applies to any other reader other than Plato like | ||
| 50 | KOReader but I haven't personally tested them. All you have to do is | ||
| 51 | [get the latest release](https://github.com/baskerville/plato/releases/latest) at Plato's repo and unzip it's contents into | ||
| 52 | a folder called plato in /path/to/kobo/mount/.adds, the latter folder | ||
| 53 | of which should have already been created by KSM if you are using that. | ||
| 54 | If you are using KSM, there should be a new option below "start nickel" | ||
| 55 | called "start plato" when you have rebooted the device. Read below if | ||
| 56 | you aren't using KSM. | ||
| 57 | |||
| 58 | ## Loading Plato on Boot | ||
| 59 | Since I don't want to load Nickel only to load into another reader like | ||
| 60 | the recommended options in Plato's forum thread (kfmon, fmon, and | ||
| 61 | NickelMenu) suggest, I noticed that I could have booted into Plato | ||
| 62 | directly. The only requirements for doing this having access to the | ||
| 63 | rootfs, so either through a telnet/ssh session, or having the sd card's | ||
| 64 | root/first partition mounted to your computer, or just ftp/rsyncing the | ||
| 65 | files to your Kobo. | ||
| 66 | |||
| 67 | First I suggest making a copy of rcS if you haven't already in case an | ||
| 68 | update overwrites it. My copy is named custominit.sh. Next you'll want | ||
| 69 | the Kobo's /etc/inittab to boot with custominit.sh instead of rcS: | ||
| 70 | /etc/inittab: | ||
| 71 | |||
| 72 | ``` | ||
| 73 | #::sysinit:/etc/init.d/rcS | ||
| 74 | ::sysinit:/etc/custominit.sh | ||
| 75 | ``` | ||
| 76 | |||
| 77 | The rest of the lines don't need to change. Then you should open | ||
| 78 | custominit.sh in your favourite editor to add the lines at the bottom | ||
| 79 | but before hindenburg is executed: | ||
| 80 | |||
| 81 | ``` | ||
| 82 | cd /mnt/onboard/.adds/plato # or whereever Plato is | ||
| 83 | PLATO_STANDALONE=1 ./plato.sh | ||
| 84 | ``` | ||
| 85 | |||
| 86 | You would probably also want to remove the lines where Nickel-specific | ||
| 87 | programs/scripts are running like nickel, hindenburg, pickel, sickel, | ||
| 88 | etc. | ||
| 89 | |||
| 90 | Now on subsequent boots, Plato should automatically have been loaded. | ||
| 91 | Boot times may also be slightly faster! :D | ||
| 92 | |||
| 93 | ## Installing KSM 09 (not doing anymore) | ||
| 94 | First you would want to [download the Clara HD version of KSM 09](https://www.mobileread.com/forums/attachment.php?s=902078ac2e6fe8ff7a0947b56cbcade6&attachmentid=166556&d=1538176531) and | ||
| 95 | [the fix for v4.25](https://www.mobileread.com/forums/attachment.php?s=902078ac2e6fe8ff7a0947b56cbcade6&attachmentid=184756&d=1610745905). Then, you would want to unzip the KoboRoot.tgz | ||
| 96 | with separate filenames so they don't replace each other and we would | ||
| 97 | untar those into the same directory. After that, we would cd into the | ||
| 98 | directory and tar it's contents into a new KoboRoot.tgz and place it in | ||
| 99 | /path/to/kobo/mount/.kobo/. | ||
| 100 | |||
| 101 | An example of what I did after downloading and unzipping the files are | ||
| 102 | below: | ||
| 103 | |||
| 104 | ``` | ||
| 105 | mkdir koboroot | ||
| 106 | tar -xvf KoboRoot-main.tgz -C koboroot | ||
| 107 | tar -xvf KoboRoot-v4.25-darkmodefix.tgz -C koboroot | ||
| 108 | cd koboroot | ||
| 109 | tar -czvf ../KoboRoot.tgz . | ||
| 110 | cd .. | ||
| 111 | rm -r koboroot | ||
| 112 | ``` | ||
| 113 | |||
| 114 | After your Kobo untars it and you wait a while, you should be presented | ||
| 115 | with KSM's main screen :D ksm09's main screen running on the kobo clara | ||
| 116 | hd | ||
| 117 | |||
| 118 | ## Auto-Boot into Plato instead of Nickel via KSM (not doing anymore) | ||
| 119 | First make sure USB support is enabled in KSM and then mount your Kobo | ||
| 120 | to your computer. Once mounted, go to | ||
| 121 | /path/to/kobo/mount/.adds/kbmenu_user/confoptions and edit | ||
| 122 | ksm_ini_options.txt in your favourite editor. You should see many | ||
| 123 | options that are listed but the one that we're interested in is | ||
| 124 | ksmAutoselectoption which may have start_nickel and start_koreader | ||
| 125 | already and what we want to do is add ksmAutoselectoption=start_plato. | ||
| 126 | After a quick restart to reload the options file, you should be able to | ||
| 127 | see the new option in KSM's settings under [general] and add item if it | ||
| 128 | wasn't already added. Now Plato should auto-boot on subsequent | ||
| 129 | powerons. | ||
