MobileRead Forums - View Single Post

Development and support for KSM stopped some time ago. Therefore, do not use it!
If you want to install it nonetheless and you are using a more recent firmware, change first of all the Kobo eReader.conf as stated here. Be aware that you are installing KSM at your own risk (as ever), and the newer your Kobo the greater the chance KSM will not work.

If you need help with KSM, please describe your problem in this thread. I visit this forum still once in a while and check also this thread. But I almost never log in and therefore don't see private messages.

Update: Mel-kior prepared a version of KSM for fw v4.25, see the following posts:
https://www.mobileread.com/forums/sh...&postcount=850
https://www.mobileread.com/forums/sh...&postcount=864
https://www.mobileread.com/forums/sh...&postcount=868

Spoiler:

KSM 09 is supposed to work under FW 2.6.0 to 4.11.11911 and likely higher. However, avoid FW 3.16.10 and 3.17.0 if you can because of the sickel issue.

Concerning Clara HD and Forma, read the information in the news box below, BEFORE installing KSM.

Quote:

News

Clara HD is supported by a special version of KSM 9 (including also the "changed start script for Plato 0.4.1+"), which is available here. Thank you to CH23 for testing and uploading the package. Note: Do not install any of the currently available KSM updates (and also not KBStartMenu_09_restore.zip) over this package, since they are not designed for this version.
Elim Garak prepared a version of KSM 9 for Forma. You can get it from here. Note: Do not install any of the currently available KSM updates (and also not KBStartMenu_09_restore.zip) over this package, since they are not designed for this version.
Until update 3 becomes available, please install the changed start script for Plato 0.4.1+ (Edit: I do not think there will every be an update.)

Quote:

Concering H2O2 version 2
Do not install KSM 09 on your device. Go to this thread and run the test that is described there to help make KSM work on H2O2 version 2.
How do you know whether you H2O2 is version 2? See this thread. However, once there is a firmware update available, the installed firmware version cannot be used as an indicator (but this is only one of several indicators mentioned in this thread). Another way to find out whether yours is version 2, is to install KSM 09. If it is unresponsive to touch, your H2O2 is version 2.

One new feature of KSM 09 is how it behaves at start up (by default):

It starts a server and provides access to the device via a webinterface. This is an attempt to give the user some control over the device, when difficulties arise, for instance spontaneous screen rotations, unresponsiveness to touch, broken screen.
It enables USBnet in order to allow sending requests to the server.
It enables wifi in order to allow sending requests to the server, when USBnet for some reasons cannot be used.
When there was no request sent to the server during the first minute after start, the server shuts down and USBnet will be disabled. (Note that you have to take care of wifi yourself.)
There are options to prevent wifi, usbnet, and the server from being enabled at start up. You can also prevent control over the device via wifi, even when the server is running.
If you are interested have a look at Playing with the KSM 09 webinterface

Prepare your device for installation:

Spoiler:

Choose a propitious moment for installing KSM. If you have just done other modifications to your device, or loaded some books on it, give it some time to settle down and see whether everything works fine.
Make sure your reader can connect to your wifi network.
Configure your pc to use the Kobo reader as an usb network device (at least if there is already an earlier version of KSM running on your device, otherwise it might be to complicated) [...]
Back up any files that you would desperately miss. (If you are not sure which files you might need, you may consider making a copy of the whole user partition.)
Deinstall any version of KSM (On KSM 08 select "tools" > "ksm diverse.msh" > "del KSM.sh")
Make sure there is sufficient free disk space on your device (KSM will need roughly 80 KB on the user partition, in addition to the size of the KoboRoot.tgz).
Make sure that the battery of your device is sufficiently charged.

With the exception of the last two points, these steps are not absolutely required, but may prevent problems, or might be helpful in case problems arise.

Installation (consists of 2 steps):

Spoiler:

Download the archive KBStartMenu_09_plus_update_001.zip (or higher when available) to your pc and extract the content.

Step 1

connect the Kobo to the PC
copy the folder kbmenupngs to the root of the device (e.g. K:\)
eject safely and disconnect
check that all images (exit_nickel.png, switchtokoreader.png, etc.) are listed in the library and their thumbnails are displayed there. Open each of them, so that they appear at least once as tiles on the home screen. Only then proceed to step two.

Step 2

connect the Kobo device to the PC
copy KoboRoot.tgz to the folder .kobo of the device
eject safely and disconnect
wait until the update is finished (Do not interrupt it, even if it takes some time. The installation of KSM 09 will certainly need more time than did previous versions. In the last phase you will see a white screen for some time. In case the screen remains in this (white) state for at least several minutes, power the device down by holding the power button in the off position for 25 seconds or so, and then power the device on again.

Note: If from an earlier installation of KSM the folder kbmenupngs with its contents is still there, and the pngs known to nickel, you can skip step 1.

Consult also the helpful guide Adding alternative readers using Kobo Start Menu by Ken Maltby, which however is partly outdated, so be careful.

Recommendations:

Spoiler:

Prepare your pc for USBNet if you did not do it already before you installed KSM 09.
Disable wifi on start up by selecting: "tools" > "ksm diverse.msh" > "auto enable wifi off.sh".
Prevent command over the device via wifi: set with "configure" the value of "[general]allowRmcViaWifi" to false.

Note: enabling wifi on start up may slow starting KSM considerably.

Webinterface:

Spoiler:

With the default configuration, you have about one minute to connect to the reader by webinterface. Note that wifi is switched off as soon as nickel starts. For the moment it might be best to test whether you can connect, but do not yet try the offered commands (I will give some explanations later.)
To connect to your device type http://{The ip of your device}:8087/rmc_test.html into the navigation bar of your browser and press enter.
In the case of USBNet the line is: http://192.168.2.101:8087/rmc_test.html.
In the case of wifi, the line is something like: http://10.0.0.3:8087/rmc_test.html.

For further information cf. the threads to previous versions of KSM:

Spoiler:

Kobo Start Menu 08
Kobo Start Menu 07
Kobo Start Menu (3-6)

Some minor things that have changed:

KSM 09 does only accept the folders koeader, vlasovsoft, plato, when they are located in .adds (.kobo is not supported any longer).
"handle update" has changed, read the info in place on the device, and see also Installing files with the help of KoboRoot.tgz.

The voice remote control package that I provided for Ecallan is not compatible with this version of KSM. If there is some need, I can adjust it.

Note: koreader, plato, and vlasovsoft/pbchess/coolreader are not included in this package. You have to install them separately. The installation is the same for all three packages: Copy the main folder of each package, that means the folder koreader, respectively plato, respectively vlasovsoft, into the folder .adds that you will find on your device after KSM has been installed.

koreader: I would recommend that you install one of the recent builds that you can find here. Choose a package that has "kobo" in its name. H202 is supported since nightly build 1546-gd0130ae (06-Mar-2018, and requires KSM 09, update 2.
vlasovsoft: see here.
plato: see here. Currently, you have to install an updated start script for plato version 0.4.1+

Miscellaneous:
alternative set of kbmenupngs icons by DobermanS
alternative set of kbmenupngs icons by sbaguz
uninstall, deactivate, disable, etc. KSM

##

The package contains materials provided by Sergey (Qt libraries), Cecell3000 (modified Qt mouse/touch driver), NiLuJe (FBGrab), KevinShort (Frontlight control), NiLuJe (rsync), Frostschutz (pngshow), Baskerville (fmon)

How to install KSM updates:

copy the KSM09_updateXXX.zip (as it is, do not unzip) into .adds\kbmenu_user
safely eject the device, select "usb disable.sh" (of course only, when you connected via usb enable.sh), and disconnect the device from the pc
(from KSM home) select "handle KSM update"
check the displayed capacity of the battery and decide whether to continue at this point or charge the device
select "install KSM update"
wait (some seconds)
read the information that appears on the screen, tap on the middle of the screen to open the bottom menu, press "close" and wait until the device has restarted. When pressing "close", you will not see an effect immediately, but only after the device has rebooted, so be patient.

If KBStartMenu_09_plus_update_001.zip is already installed, there is no need to additionally install KSM09_update001.zip, since in this case this update is already included. You can see the update history of your device by selecting

(KSM home) "tools" > "explore" > "explore kbmenu.msh" > "updatehistory.txt"

I thank boriar, nook_nerd, and taos for helping create update 1.
For changes in update 2, see this post.

When you happen to allow a firmware update to disable KSM, you can restore it again:

extract KoboRoot.tgz from KBStartMenu_09_restore.zip, and copy it into .kobo.

USE THIS PACKAGE AT YOUR OWN RISK!