HowTo Sew on a new menu of buttons.

[knc1]

Everyone is a noob at some point in this game, so look at a 'worked example' first.

File layout (v.0.3.1):

*/documents
    KindleLauncher-2.0.azw2
*/extensions
    /helper
        config.xml
        menu.jason
        /bin
            411.sh
            kill-kterm.sh
            setorientation.sh
            ssallow.sh
            ssprevent.sh
            start_update.sh
            usbnetwork.sh

File contents, /extensions/helper/config.xml:

PHP Code:

<?xml version="1.0" encoding="UTF-8"?>
<extension>
    <information>
        <name>Helper</name>
        <version>0.0</version>
        <author>Ixtab Twobob</author>
        <id>helper</id>
    </information>
    <menus>
        <menu type="json" dynamic="true">menu.json</menu>
    </menus>
</extension>

File contents, /extensions/helper/menu.jason:

PHP Code:

{
    "items": [
        {
        "name": "Helper",
        "priority": 0,
        "items": [
            {"name": "BEGIN: Run Grayed Install", "priority": 1, "action": "bin/start_update.sh"},
            {"name": "Start/Stop UsbNetworking", "priority": 2, "action": "bin/usbnetwork.sh"},
            {"name": "PREVENT: ScreenSavers", "priority": 10, "action": "bin/ssprevent.sh"},
            {"name": "ALLOW: ScreenSaver:", "priority": 11, "action": "bin/ssallow.sh"},
            {"name": "711 Page: (Network Info)", "priority": 52, "action": "bin/411.sh", "params": "711"}
        ]
        }
    ]
} 


File contents, /extensions/helper/bin/start_update.sh

PHP Code:

#!/bin/sh
lipc-set-prop com.lab126.ota startUpdate 1 


A nice, regular, file layout.
Now, see if I can duplicate that for the BBB extension.

[twobob]

Laid naked.

Good place to start.

[knc1]

Not a good example of shell programming, just an example of what to change from that shown in post #1 for your own button add-in to the Helper menu.

The Button Man's helper menu is in */extensions/helper
Mine are going into */extensions/helper2
Pick a directory name of your own to use.

In config.xml change **ONLY** the >author< attribute.

In the menu.json file change the 'name:' string to the button label.
In the same line, change the 'action:' string to your path and filename. Paths are relative to your extension directory name.
The 'sort priority' field is not currently used, leave it set at 1.

This demo only adds one button, but add additional button defs. as shown in the post #1 example code as required.

Write a shell script (which can be executed by Busybox Ash) for that described in the 'action:' string (put in your own bin directory).

All of the above text files **should** use Linux line endings.

Create a compressed tarball based at your helper's directory name, see attached for an example.

Enjoy.
(PS: example creates a report 'book' in documents with only the character '/' in it.) I.E: The current working directory of your scripts - which are run as the administrator 'root'.

[knc1]

Released, see:
http://www.mobileread.com/forums/sho...d.php?t=205732

Unarchive,
Diddle the ntpdate.conf file for a local NTP time server if required
(Directions in config file) -
Put the directory 'helper2' and its sub-directories under the 'extensions' folder of KUAL -
Establish a network connection -
Select the 'Set DateTime from Server' button -
It should 'just work' and produce a new 'book-report'.

Only tested on Kpw-5.3.3 but it is written to be harmless -
Give it a try and report back here -
If any errors (other than 'server not available') attach the book-report to your post.

Please mention your Kindle model when making a report.

[knc1]

Works fine on the Kpw (paperwhite)

Testing by twobob:
Works fine on the K5 (touch)
Works fine on the K3
Does not work over DX-3G (but should work over USB networking if you have that setup to access the Internet)

Other testing in progress.
From the list above - it should work on the K4
Still to be heard from: the K2

Other reports on other devices would be nice to have.

[stepk]

Nice script! Can't help you with reporting on other devices as I only have a KT. Suggestion: change the thread title to mention its connection to KUAL.

[knc1]

Originally Posted by stepk

Nice script! Can't help you with reporting on other devices as I only have a KT. Suggestion: change the thread title to mention its connection to KUAL.

Setting the date/time without contacting Amazon is a popular item -
Will give it its own thread when ready.

[knc1]

Released:
http://www.mobileread.com/forums/sho...d.php?t=205732