[tshering]

This is NOT the most recent version, please go to the KSM 07 thread.
----------------

For FW 6.0.0 to 3.12.0; expected to run on H2O too.
Tested on Kobo Touch (mark 3, FW 6.2.0), Kobo Touch (mark 4, FW 3.8.0, 3.11.0 and 3.12.0), Kobo Glo (FW 3.8.0, 3.11.0 and 3.12.0), Mini, Aura HD, Aura, Aura H2O. On Kobo Aura H2O KSM shows some short-time disorder on the screen after an entry has been selected.

New features:

• slightly changed layout
• connect device as USB mass storage; enable USBnet (and dropbear if vlasovsoft is installed)
• handle wifi connections (rather limited; can currently handle only network names and passwords that contain only english letters and numbers)
• check for Kobo firmware updates and download them
  
  Spoiler:

  Note: After a firmware update, please run nickel at least once. Otherwise KSM cannot ascertain the current firmware version.[/SPOILER See for further information here.
• choose from several versions of koreader if available
  Spoiler:

  home: koreader additions > select koreader version
  If there are several versions of koreader on your device, you can select one of them. To have several versions of koreader, just rename the folders according to the pattern koreaderX (e.g, koreader_256). Do not use spaces in the name.
• user can define geometry (= screen position and size) of KSM applications
  
  Spoiler:

  Cf. this post
• auto start of nickel if there is no user input for 20 seconds (kind of safety net if KSM is unresponsive to touch input for some reason)
• execution of autoscript.sh as soon as it is detected on the external SD (for emergency cases)

I will provide more detailed information when I find some time.

First time installation (consists of 2 steps)

Spoiler:

Step 1

1. connect the Kobo to the PC
2. copy the folder kbmenupngs to the root of the device (e.g. K:\)
3. eject safely and disconnect
4. check that the four images (exit_nickel.png, run_test_script.png, simulate_usb_connection.png, switchtokoreader.png) are listed in the library and their thumbnails are displayed. Only then proceed to step two.

Step 2

1. connect the Kobo to the PC
2. copy KoboRoot.tgz to .kobo of the device
3. eject safely and disconnect
4. wait until the update is finished

Consult also the helpful guide to Adding alternative readers using Kobo Start Menu by Ken Maltby.

Installation on devices that have or had already KSM installed (consists of 2 [and maybe a halve] steps)

Spoiler:

Step 1

1. uninstall the previous version of KSM (use KBStartMenu_04_udate01_un_re_install.zip of this post)
2. delete the folder .kobo/kbmenu (do not delete .kobo)

Check that the folder kbmenupngs contains the necessary images. If it does not, update the folder and verify that the images appear in the library view.

Step 2

1. same as Step 2 of "First time installation"

Be aware that you cannot easily downgrade the Kobo firmware without doing a factory reset. The reason for this is that the Kobo Start Menu tries to work with all FW versions starting with 2.6.0. In order to do this it determines the currently running FW version by looking whether specific files are available on the device. After downgrading (without factory reset), these version specific files are still living on the device, and this fact results in false identification.

The package contains materials provided by Sergey (Qt libraries), Cecell3000 (modified Qt mouse/touch driver), NiLuJe (FBGrab).


KBStartMenu_06_update01b.zip
Use this update package only if KSM 06 is already running on your device!

Spoiler:

How to install:

• extract KoboRoot.tgz from KBStartMenu_06_update01b.zip, and copy it to .kobo
• select in KSM "handle update > install update"

This upadate concerns the following points

• Some bug fixes; cf. this post
• Upside down power-off screen, cf. this post.
• Problems when switching between nickel and koreader, cf. this post.
• Bezel covering parts of the viewport, cf. part two of this post, and this post.
• (Re)enable optional password check
• Version of kobomessage, which is used for showing information texts and the power-off message, without frames and scrollbars
• activate side loaded dictionaries
• activate device (circumvent official device activation; "tools > kobo diverse.msh > activate device.sh")
• improvement of update script
• notification when there is an update file in .kobo

Further items (not included in KBStartMenu_06_update01b.zip):

• identify in the same way as nickel when connecting as usb storage
• show randomly images on power off screen

Uninstall KSM

Spoiler:

In KBStartMenu_04_udate01_un_re_install.zip, which you can find here, you find a folder uninstall, which has several subfolders who's name indicate to which FW version they belong (e.g., KoboRoot_2.10.0_3.1.1 belongs to the FW versions 2.10.0 to 3.1.1). Copy the file KoboRoot.tgz of the folder that corresponds to your FW to the folder .kobo of your device. Then select in KSM "handle update > install update".
You can use KoboRoot_3.3.1_3.4.1 for all FW versions from 3.3.1 to 3.12.0.

Note: Do not use reinstall of KBStartMenu_04_udate01_un_re_install.zip, since this is meant only to be used together with KSM 04.

USE THIS PACKAGE AT YOUR OWN RISK!