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