Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader > Kobo Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old 02-07-2014, 01:27 PM   #1
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Kobo Start Menu

This thread is outdated, please go to the KSM 09 thread.
----------------------


The Kobo Start Menu (KSM) is launched at start up and lets you
  • choose between available readers and other applications
  • manage FW packages (install, install and preserve the Kobo Start Menu, delete)
  • connect via USB
  • execute scripts from the internal and external sd
  • handle custom.css for the kepub renderer (only effective on older firmwares)
  • ...
Since larger parts of the package consist of sh files, you can modify and enlarge the functions easily.


Find some more information on the usage (most descriptions are in need of an update, but might still be useful for starters):
Spoiler:
Links to older versions:
Installation (KSM 02, consists of 2 steps )
Spoiler:

(Uninstall any version of Kobomenu and remove the whole folder kbmenu completely from the device.

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 3 images (exit_nickel.png, simulate_usb_connection.png, toggle_nightmode.png ) are listed in the library. 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


USE THIS PACKAGE AT YOUR OWN RISK!

------------------
There is a helpful guide to Adding alternative readers using Kobo Start Menu by Ken Maltby.
------------------
Attached Thumbnails
Click image for larger version

Name:	KBSM_02_usb.png
Views:	6714
Size:	25.6 KB
ID:	118812   Click image for larger version

Name:	KBSM_03_scripts.png
Views:	6369
Size:	34.6 KB
ID:	118813   Click image for larger version

Name:	KBSM_01_home.png
Views:	6175
Size:	39.2 KB
ID:	118814  

Last edited by tshering; 01-13-2018 at 02:36 PM.
tshering is offline   Reply With Quote
Old 02-07-2014, 02:30 PM   #2
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
The main menu (home)

The first entry in the main menu (home) is "info." Its icon is a white question mark on a black ball. As a convention I use this icon to indicate that if you select this menu entry, some text will be displayed. (At one place however I breach this convention, in script>tests>browse kobo.msh.) If you press this entry, a screen opens with some information. Actually, there is not much information, but it is an opportunity to introduce the message screen. The screen is divided into three tap zones, left, middle right. Left and middle will invoke page up and page down. Since the info text doesn't fill a page, you want see any change in this case. A tap on the middle tap zone opens a bar at the bottom. I contains three buttons: zoom out, close, zoom in. Press the middle button to close the message screen.
You can edit this text for better usage (telefon numbers, birthdates of your grandparents). The location of the file is .kobo\kbmenu\txt\start_info.html. You can use a subset of html tags.

The next menu entry is "handle update." This menu entry only shows, if there is actually an update file in .kobo. If you select this menu point you are presented with three options
  • install update: will install the update
  • install partial update, will install the update with the exception of ./etc/init.d/rcS and ./usr/local/Kobo/udev/usb (provided the update file has exactly the same format as the original update files; in many/most custom made KoboRoot.tgz this is not the case; maybe I should take care of this too). It is important to use this option, if you want the Kobo start menu to survive a FW update.
  • delete update: this will delete the update files.
In recent FW versions, nickel will reboot as soon as it detects an unprocessed update file. Therefore, it is advisable to install or delete any update before launching nickel.

The next entry is "start nickel." This will start the normal Kobo user interface. You can return to the menu by opening exit_nickel.png in the library.

The next three entries are "start kobolauncher, "start vlasovsoftlauncher", "start koreader," provided they are detected on the device.

The next entry is "usb." This will open a new menu. You will be informed that "USB support is currently not enabled." Press "enable usb.sh" wait until the message changes to "USB support is enabled" and connect to uhesb cable to the computer (actually you can connect already as a first step or second). After you eject the reader and disconnect the cable, press "disable usb.sh"
Please read the "info" for some details.
In this menu you can see a feature that you will meet in other sub menus too, namely "exec/read." By pressing this entry you can toggle between execution mode and reading mode. In execution mode script files will be executed (e.g. enable usb.sh and disable usb.sh), in reading mode the text of this scripts will be displayed. You can see which mode is currently active by the icon. The question mark icon indicates reading mode, the arrow icon indicates execution mode. "Return" will bring you back to the main menu (home)

The next entry is "scripts." I will say something about it at a later point.

The next entry is "sleep." Press it to make the device sleep. There is no special sleep screen, only the screen freezes. Wake the device up by sliding the power slider.

The next entry is "reboot." Again no special reboot screen. Just wait some seconds until the device is rebooted.

The next entry is "power off." A simple power off screen is presented. Currently, a short text is displayed. You can edit the content (.kobo\kbmenu\txt\poweroff_info.html). For the sub set of accepted html tags see here.

Last edited by tshering; 04-04-2014 at 03:11 PM.
tshering is offline   Reply With Quote
Advert
Old 02-08-2014, 04:22 AM   #3
paola
Wizard
paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.paola ought to be getting tired of karma fortunes by now.
 
paola's Avatar
 
Posts: 2,824
Karma: 5843878
Join Date: Oct 2010
Location: UK
Device: Pocketbook Pro 903, (beloved Pocketbook 360 RIP), Kobo Mini, Kobo Aura
nice!
paola is offline   Reply With Quote
Old 02-08-2014, 05:30 AM   #4
trekk
Terraner
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 522
Karma: 4207769
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
Nice, but after restarting on Aura HD the screen flips 180°, while the touch zones won't rotate.
trekk is offline   Reply With Quote
Old 02-08-2014, 06:37 AM   #5
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Quote:
Originally Posted by trekk View Post
Nice, but after restarting on Aura HD the screen flips 180°, while the touch zones won't rotate.
I have no idea why and how this happens. How did you manage to get out of it? Was factory reset the only way?
Did you try on the Glo too?
tshering is offline   Reply With Quote
Advert
Old 02-08-2014, 06:46 AM   #6
trekk
Terraner
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 522
Karma: 4207769
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
I got out of this by guessing the touch position, no factory reset was necessary. I'll try on the Glo and report later.

Something interesting happened when uninstalling. I guessed where to tap for "handle update", after that, the screen rotated again 180° and "install update" appeared in the correct position.

Edit: Just installed the files on the Glo. Everything is good here! I remember some issues with the Aura HD and Sergey's autostart function in previous versions of pbchess. Autostart also flipped the screen 180°, but only on the Aura HD.

Second Edit: Aura 6" works fine too. Thanks a lot tshering! Nice tool to play with

Last edited by trekk; 02-08-2014 at 07:46 AM.
trekk is offline   Reply With Quote
Old 02-08-2014, 07:48 AM   #7
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Quote:
Originally Posted by trekk View Post
I got out of this by guessing the touch position, no factory reset was necessary.
I am glad to hear this. Good that the touch position was still inside the screen.
Quote:
Originally Posted by trekk View Post
Something interesting happened when uninstalling. I guessed where to tap for "handle update", after that, the screen rotated again 180° and "install update" appeared in the correct position.
Strange indeed!
Quote:
Originally Posted by trekk View Post
Edit: Just installed the files on the Glo. Everything is good here!
Thank you for testing!
Quote:
Originally Posted by trekk View Post
I remember some issues with the Aura HD and Sergey's autostart function in previous versions of pbchess. Autostart also flipped the screen 180°, but only on the Aura HD.
Do you know whether there was a solution for this? I just downloaded and went through a number of the pbchess files. Since 1.6.32, autostart seems not to be supported, so I guess maybe not.
tshering is offline   Reply With Quote
Old 02-08-2014, 07:55 AM   #8
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Quote:
Originally Posted by trekk View Post
Second Edit: Aura 6" works fine too. Thanks a lot tshering! Nice tool to play with
Wow, you are really on the brave side. Thank you for testing.
tshering is offline   Reply With Quote
Old 02-08-2014, 08:44 AM   #9
trekk
Terraner
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 522
Karma: 4207769
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
Quote:
Originally Posted by tshering View Post
Do you know whether there was a solution for this? I just downloaded and went through a number of the pbchess files. Since 1.6.32, autostart seems not to be supported, so I guess maybe not.
IIRC, there has been no solution for the Aura HD and finally this function has been removed.
trekk is offline   Reply With Quote
Old 02-09-2014, 02:44 AM   #10
Cesco
Connoisseur
Cesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipseCesco can illuminate an eclipse
 
Cesco's Avatar
 
Posts: 52
Karma: 8236
Join Date: Jul 2013
Location: Italy
Device: Kobo Aura 2-Aura H2O-K1-LibraH2O
Installed on the Glo, but does not mount the microSD
I have tried many times to remove it and reinsert it, but it does not work, any suggestions?
I have to try with another card?
Anyway, congratulations for the work
Cesco is offline   Reply With Quote
Old 02-09-2014, 04:47 AM   #11
trekk
Terraner
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 522
Karma: 4207769
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
Remove it completely while you are still in the menu, where it says "External sd is not mounted". Then reinsert the microSD, close the menu and execute the script one more time. The micro SD should be mounted now.
trekk is offline   Reply With Quote
Old 02-09-2014, 06:27 AM   #12
xping
Connoisseur
xping has learned how to read e-booksxping has learned how to read e-booksxping has learned how to read e-booksxping has learned how to read e-booksxping has learned how to read e-booksxping has learned how to read e-booksxping has learned how to read e-books
 
Posts: 74
Karma: 765
Join Date: Nov 2013
Location: Italy
Device: kobo aura hd, kobo mini, Sony prs-t3
this vs AdvBoot

Why is necessary to have images of icons (exit nickel etc) in library?
Have U read about AdvBoot in Kobo developer's Corner thread
Should be possible to launch this menu within AdvBoot as third option ? (1 Kobo Nickel; 2 Koreader; 3 This menu)

Thx
xping is offline   Reply With Quote
Old 02-09-2014, 06:48 AM   #13
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Quote:
Originally Posted by Cesco View Post
Installed on the Glo, but does not mount the microSD
I have tried many times to remove it and reinsert it, but it does not work, any suggestions?
I have to try with another card?
Anyway, congratulations for the work
Did you get it to work? (Thank you trekk!) Completely removing might not be necessary. On my Touch I just push on the card, the card jumps out a little bit, I push it back again.
tshering is offline   Reply With Quote
Old 02-09-2014, 06:56 AM   #14
trekk
Terraner
trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.trekk ought to be getting tired of karma fortunes by now.
 
trekk's Avatar
 
Posts: 522
Karma: 4207769
Join Date: Aug 2011
Device: Kobo Libra, Aura One, Kindle Oasis 1 & 2 ...
Just pushing the card is sufficient. I just wanted to make sure, that the microSD is really disconnected.
trekk is offline   Reply With Quote
Old 02-09-2014, 07:33 AM   #15
tshering
Wizard
tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.tshering ought to be getting tired of karma fortunes by now.
 
Posts: 3,489
Karma: 2914715
Join Date: Jun 2012
Device: kobo touch
Sorry for not having explained much until now. I am planning to write some details about the usage in serveral small installments.

Quote:
Originally Posted by xping View Post
Why is necessary to have images of icons (exit nickel etc) in library?
It is not necessary, but maybe helpful.
  • exit_nickel.png: if you select this image in the library, nickel (the Kobo user interface) exits, and you get back to the start menu (provided nickel has been started from the menu).
  • toggle_nightmode.png: if you select this image in the library, it toggles Yoq's nightmode (provided of course it is installed). I thought this might be convenient for some people.
  • simulate_usb_connection.png: If you copy some books that you plan to use with nickel to the device, you should generally establish the USB connection while running nickel (the same way as you supposedly did until now). If you load the books however in some other way (e.g., by establishing the USB connection with the start menu, or via wifi ftp), you have to make nickel update its database. One way to achieve this is to simulate an USB connection/disconnection event. if you select the image simulate_usb_connection.png in the library, the "computer detected" message will pop up (even though there is no computer connected). Press quickly "connect" (you have only some seconds before the pop-up closes), nickel will read the new contents and update the database.
If you don't plan to use any of these, you can remove the concerned image from the library.

Quote:
Originally Posted by xping View Post
Have U read about AdvBoot in Kobo developer's Corner thread
Should be possible to launch this menu within AdvBoot as third option ? (1 Kobo Nickel; 2 Koreader; 3 This menu)

Thx
Yes, I did read this thread, and I am happy that someone went this way, cf. my suggestion. And yes, it should be possible to have this menu as a third option. But I am not sure what purpose it would fullfill, since the aims of AdvBoot and the start menu are very similar.
There are some more ways to launch the menu, by fmon, by Kobo Launcher, by the Kobo Tweaks (I am not sure whether they are working on recent FWs). Of course one would have to change the contents of the menu entries in order to prevent to much circularity.

Last edited by tshering; 02-09-2014 at 06:07 PM.
tshering is offline   Reply With Quote
Reply

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
kobo menu and message tshering Kobo Developer's Corner 26 01-15-2014 09:18 AM
Kobo WiFi - Battery indicator outside menu? Cyberman tM Kobo Reader 1 03-06-2013 04:42 AM
Kobo constantly crashes back to Reading menu avalanches Kobo Reader 0 04-11-2011 09:35 PM
main menu, section menu, css for calibre mobipocket output naisren Calibre 2 08-23-2010 11:42 PM
Calibre start menu icon Cy1clown Calibre 1 02-06-2010 02:10 PM


All times are GMT -4. The time now is 11:03 AM.


MobileRead.com is a privately owned, operated and funded community.