forked from coplate/KUAL_Booklet
-
Notifications
You must be signed in to change notification settings - Fork 1
/
MR_THREAD.txt
510 lines (338 loc) · 42 KB
/
MR_THREAD.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
Welcome to [b]K[/b]indle [b]U[/b]nified [b]A[/b]pplication [b]L[/b]auncher, your [i]/kuːl/[/i] friendly neighborhood Launcher ;).
[COLOR="DarkGreen"][b]What Does It Do?:[/b][/COLOR]
[INDENT]
As the name implies, this is a Launcher application, in which anybody can plug into to provide new [i]buttons[/i] and [i]menus[/i] through [i]extensions[/i]. Those buttons can run pretty much anything, and the backend is powerful enough to make menus dynamic, allowing developers to use KUAL as a configuration UI for their stuff! But the basic principle is: click a button to run stuff!
A number of hacks ship with a KUAL extension, which is why you'll often see KUAL listed as a required dependency ;).
Moreover, it's universal! It'll run on (pretty much) anything, as long as it's running FW >= 2.3! [COLOR="DarkGrey"]With a particular caveat on the KT2/KV/PW3, where some early firmware versions won't let you run it...[/COLOR] And a fun twist on the KOA/KT3/KOA2, as well as on FW 5.9.x in general, more on that later...
[/INDENT]
[COLOR="Red"][b]Latest Updates (04/12/2019):[/b][/COLOR]
[INDENT]
Added information about KOA2/PW4/KT4 support, as well as FW >= 5.9.x in general. Do read the instructions until the end to see which method applies to your specific device.
[/INDENT]
[COLOR="Red"][b]INSTALL:[/b][/COLOR]
[b]KUAL itself:[/b]
[INDENT][SPOILER]
As pretty much anything here, your device will need to be jailbroken. Please refer to the wiki and/or the [url=http://www.mobileread.com/forums/showthread.php?t=180113]stickies[/url] & index for the appropriate method for your specific Kindle model ;).
In addition, you [i]may[/i] need to install [url=http://www.mobileread.com/forums/showthread.php?t=233932]MKK[/url]: if your device runs on FW 5.x, and you're using the [url=http://www.mobileread.com/forums/showthread.php?t=186645]K5 JB >= 1.11.N[/url] (or the associated "hotfix"), you don't need to do anything, MKK is bundled with your JB. If you're using an older device, you [i]will[/i] need to install MKK yourself ;).
Finally, you need to install KUAL itself, by putting the appropriate [i]azw2[/i] file somewhere in the [i]documents/[/i] directory tree of your device.
First, unpack the [b]KUAL-v2.7.zip[/b] archive attached to this post. Then, if your device runs on FW 5.x, use the [b]KUAL-KDK-2.0.azw2[/b] file. If your device is older, use the [b]KUAL-KDK-1.0.azw2[/b] file.
And that's it for the basics! You should now have a pretty KUAL button/entry on your Library (on recent FW, make sure you switch to the [i]local[/i] Library view. In the same vein, on FW using a dedicated Homescreen page, you will [i]never[/i] see KUAL in it). Right now, it won't be terribly useful, since KUAL ships without any extension, but now you have the tools to change that :).
Check the screenshots attached to this post for a quick tutorial on how to actually navigate KUAL's UI ;).
[/INDENT][/SPOILER]
[COLOR="Red"][b]Important notice for KOA/KT3/KOA2/PW4/KT4 owners, as well as *anything* that might be running FW >= 5.9.x:[/b][/COLOR]
[INDENT][SPOILER]
As of right now, and for reasons outside of our control, Kindlets will fail to run on these devices & firmwares, so you can disregard the earlier bit about the [i]azw2[/i] file.
Instead, on these devices, we will have to use the Booklet version of KUAL.
First, the prerequisites: your device of course still needs to be jailbroken, and needs to be running a recent "[url=http://www.mobileread.com/forums/showpost.php?p=3004892&postcount=1597]hotfix[/url]" version [COLOR="DarkGrey"](the vast majority of you should be covered, only the early adopters might need to update their hotfix)[/COLOR]. Then, you will have to install [url=http://www.mobileread.com/forums/showthread.php?t=251143][b]MR Package Installer[/b][/url] (MRPI). Never mind that it's technically a KUAL extension and that we're in effect doing things in reverse ;).
Once that's done, put the [b]Update_KUALBooklet_v*_install.bin[/b] file (found in the same archive as mentioned earlier) in the [i]mrpackages[/i] folder, which you'll find at the root of your Kindle over USB, then eject & unplug you Kindle.
Finally, enter [b];log mrpi[/b] in the Homescreen's searchbar (in a similar fashion as what you had to do during the Jailbreak), and wait for MRPI to do its thing.
When the UI finishes restarting, you should end up with a KUAL entry in your Library (showing as a personal document).
[b]NOTE for KOA2, PW4 & KT4 owners:[/b]
As you already installed it during the JailBreak process, you can disregard the mentions of the "hotfix", yours will by definition be good enough for the job at hand ;).
Do take a look at the final entry in the FAQ, you will *most likely* need to use @coplate's patched version of the Booklet variant, so you might as well start with it to save you some trouble!
[b]NOTE for PW3 owners:[/b]
If you're reading this and you're not yet running FW >= 5.9.x, I'd recommended moving to the Booklet variant ASAP, and then removing the Kindlet version. See the list of known issues for the reasoning behind this recommendation ;).
[/INDENT][/SPOILER]
[b]KUAL extensions:[/b]
[INDENT][SPOILER]
Let's take the 'Helper' extension attached to this post as an example. Simply unpack the [b]kual-helper-0.5.N.zip[/b] archive attached to this post at the USB root of your device. It'll create an [i]extensions[/i] folder, and a [i]helper[/i] subdirectory in it. That's it! Each extension lives as its own subdirectory inside the [i]extensions[/i] folder. It'll automagically get picked up the next time your start KUAL, and you should see a new 'Helper' menu pop up in the main KUAL screen!
Extensions should always be packaged this way (i.e., simply unpack them at the root of your device), but if they're not, unpack them inside the [i]extensions[/i] directory instead.
Developers, see [url=http://wiki.mobileread.com/wiki/KUAL_What%27s_New]this wiki page[/url] for all the gory details on what you can do ;).
Here are a few other 'quality-of-life' extensions provided by the KUAL dev-team:
[url=http://www.mobileread.com/forums/showpost.php?p=2591705&postcount=1014][b]KUAL+[/b][/url], which extends the KUAL menu with more configuration options for KUAL itself.
[url=http://www.mobileread.com/forums/showpost.php?p=2636883&postcount=50][b]GNU Awk Installer[/b][/url], which will provide an install button for gawk in the KUAL menu. gawk will then be used by KUAL, instead of busybox awk. Long story short: it'll make KUAL parse your extensions faster, which is good ;). It's [b]highly[/b] recommended, especially if you use complex KUAL extensions.
[url=http://www.mobileread.com/forums/showthread.php?t=251143][b]MR Package Installer[/b][/url], which will make installing your favorite set of hacks a breeze ;).
You will find the full list of available extensions [url=http://www.mobileread.com/forums/showthread.php?t=205064]here[/url].
[/INDENT][/SPOILER]
[COLOR="Red"][b]FAQs and Known Issues:[/b][/COLOR]
[INDENT][SPOILER]
[b]Q[/b]. Halp! Everything is broken, and my device shows me a weird popup when I try to launch KUAL!
The content of the popup might range from "This device is not authorized as a test Kindle by the developer of this item", to "Mobileread Kindlet Kit is not installed"
[b]A[/b]. You either fell victim to a silent OTA update, or you unregistered your device since the last time you tried to launch a Kindlet.
The fix is simple: reinstall MKK. (On devices where you installed the "hotfix" at some point in time, a simple reboot might do the trick).
[b]Q[/b]. I tried installing the Booklet version on my device, but MRPI said it was "Not targeting my FW version" or "Not targeting my device", what gives?
[b]A[/b]. It means your device was not yet identified at the time the latest release was tagged. Try using packages from my [url=https://www.mobileread.com/forums/showthread.php?t=225030]Snapshots[/url] thread instead ;).
And I do mean that for *everything* you might want that can be found there, from KUAL, to MRPI, to my Hacks.
[b]Q[/b]. I'm running on FW >= 5.9.x, and when I tap on KUAL's document, I end up on a blank screen, with just a status bar! I'm forced to hard-reboot my device to get back to my homescreen :(.
[b]A[/b]. Don't fret, this is a known issue on some devices/FW combos (especially on the KOA2, PW4 or KT4, since they all ship on FW >= 5.9.x). On these devices, instead of the original Booklet version from the latest release/snapshot, you'll want to use @coplate's patched version, a (currently) up to date build of which can be found [url=https://www.mobileread.com/forums/showpost.php?p=3699392&postcount=304]here[/url], in my Snapshots thread.
----
[LIST]
[*]Non-Japanese 4GB PW2 models won't run Kindlets at all [you'll get a "The selected application cannot be started. Please try again later" popup], unless updated to 5.4.5 or newer (make sure you're JailBroken [i]before[/i] updating).
[*]In the same vein, on the KV, the KT2 & the PW3, some early FW versions won't let you run Kindlets at all [you'll get a "The selected application cannot be started. Please try again later" popup].
[*]Still in the same vein, do read the dedicated Oasis, KT3 & KOA2 & PW4 & KT4 section if you own one of these devices.
[*]Same deal if you're running FW >= 5.9.x. If you're reading this, I'm assuming you've read the specific FAQ entry about it just a few lines earlier.
[*]On a cold boot, even with everything in order, KUAL [i]may[/i] sill fail to start on the first try, usually with a "An error occurred while trying to open this item", or a "The selected application cannot be started. Please try again later" or "Kindlet did not shut down properly" popup. This is a known issue, stemming from restrictions of the Kindlet framework, and the way in which KUAL is designed. Simply try again a bit later. (On a sidenote, enabling [url=http://www.mobileread.com/forums/showpost.php?p=2636883&postcount=50][b]gawk[/b][/url] [i]might[/i] help a bit).
[*]Really old firmware versions on the K2 & DX did not support Kindlets, update the firmware to the latest version available.
[*]Frankensteined DXG with FW 3.x won't be able to run Kindlets without [url=http://www.mobileread.com/forums/showpost.php?p=1747631&postcount=354]further tinkering[/url]
[*]You [i]need[/i] an up to date JailBreak (>= 1.13.N) in order for your extensions to behave properly on FW >= 5.6.1. If stuff appears to be half-broken, that's probably the case (the breadcrumb line being prefixed with a [i]%[/i] instead of a [i]$[/i] is a definite sign that your JB is outdated).
[*]If some buttons mysteriously fail to run, in an apparently random fashion, make sure your host system and/or your unarchiving tools are not messing with the case and the line-endings of files when unpacking the archives... This is sure to lead to hair-pulling mysteries otherwise ;).
[*]On newer FW, if you can't seem to find the KUAL button/entry, make sure you switch to a [i]local[/i] Library view. Don't hesitate to filter by "Active Content" if you [i]really[/i] can't seem to find it.
[*]When upgrading from the Kindlet (KDK) version to the Booklet version on a FW version that stopped supporting Kindlets, you will end up with a stray KUAL icon. This is a known issue (affecting the PW3 in particular). @knc1 has been working on an automated way to get rid of it, [url=https://www.mobileread.com/forums/showthread.php?t=297620]see this post[/url] for a recap of the current situation.
If you're reading this before the fact, you can easily avoid the issue by handling your updates smartly: install the Booklet version of KUAL, delete the Kindlet version *from the Kindle's interface* (it'll be the one with an icon), and only then, after verifying that the Booklet version is functional, will you be able to update your FW.
[/LIST]
[/INDENT][/SPOILER]
[COLOR="Red"][b]ChangeLog:[/b][/COLOR]
[INDENT][SPOILER]
It's available [url=https://bitbucket.org/ixtab/kindlelauncher/src/master/src/com/mobileread/ixtab/kindlelauncher/resources/dist/NEWS.txt?at=master]here[/url].
[/INDENT][/SPOILER]
[CENTER][COLOR="Red"][B]==============================[/B][/COLOR][/CENTER]
For historical purposes, and because it's much, much more verbose, here's the first post as it stood before the rewrite ;). That said, everything you need to know should already have been covered earlier :).
[SPOILER]
[FONT="Arial Black"][SIZE="6"][COLOR="YellowGreen"]UPDATE v 2.4: [/COLOR][/SIZE][/FONT]
Kindle K2, K2i, DX, 3, 4, Touch, PW & PW2 supported (all revisions [COLOR="Gray"][SIZE="2"]that support Kindlets[/SIZE][/COLOR])
[SIZE="1"]Many thanks to [URL="http://hackaday.com/2013/02/05/one-kindle-launcher-to-rule-them/"][COLOR="Gray"]Hackaday.com[/COLOR][/URL] and [URL="http://lifehacker.com/5982743/kual-is-a-simple-unified-launcher-for-jailbroken-kindles"][COLOR="Gray"]lifehacker.com[/COLOR][/URL] for their support[/SIZE][SIZE="5"][/SIZE]
[QUOTE][SIZE="1"][COLOR="Red"]NOTICE! [COLOR="Black"]•[/COLOR] Lägg märke [COLOR="Black"]•[/COLOR] لاحظت [COLOR="Black"]•[/COLOR] Beachten [COLOR="Black"]•[/COLOR] AVIS [COLOR="Black"]•[/COLOR] Обратите внимание [COLOR="Black"]•[/COLOR] Προσοχή [COLOR="Black"]•[/COLOR] LET OP [COLOR="Black"]•[/COLOR] 注意[COLOR="Black"] •[/COLOR] نوٹس
[/COLOR][/SIZE]
[B]BEFORE[/B] YOU CAN USE THE KINDLET: You MUST have [B]installed[/B] [URL=http://www.mobileread.com/forums/showthread.php?t=233932][COLOR="Red"][B]MKK[/B][/COLOR][/URL].[/QUOTE]
[I][COLOR="Gray"][B]NOTES: [/B]
Non-Japanese 4GB PW2 models won't run Kindlets at all, unless updated to 5.4.5 or newer (make sure you're JailBroken [i]before[/i] updating).
Really old firmware on Kindle 2's did not support kindlets, update the firmware.
Flashed 3.2.1 Dx's may not show up [B]any[/B] kindlets... [COLOR="Gray"][SIZE="1"][I]See [B]Known Issues[/B] section for more details[/I][/SIZE][/COLOR][/COLOR][/I]
[B]Support[/B]:[SIZE="5"] [B]<--[/B] Like read this... At least [I][B]once[/B][/I][/SIZE]
[SPOILER][COLOR="Black"]Supporting the [B]K2, K2i, DX, Kindle 3 Keyboard, Kindle 4 Range, Kindle Touch, PW[/B] and [B]PW2[/B].
[QUOTE=A WORD FROM THE DEVELOPERS ABOUT DONATION]To be able to support and develop for these devices effectively is a LOT easier WITH the devices and cables. Twobob doesn't have a PW2, Aeris doesn't have a Touch.
If [B]YOU[/B] [I]choose[/I] to [URL="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PK2FB4XBMWPYE"]support this project[/URL] please consider either [URL="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PK2FB4XBMWPYE"]donating a small amount[/URL] via paypal here (simple 1 click process) [B][URL="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PK2FB4XBMWPYE"][email protected][/URL][/B]. It is [COLOR="DarkRed"]not mandatory[/COLOR]. By any means. But we would appreciate it greatly.
Or you could help us keep the dedicated servers up by giving here [url]http://www.dreamhost.com/donate.cgi?id=16490[/url], Alternately consider forwarding monies to the [url]http://laosliteracyproject.org/[/url] project. Any excess project funds will be forwarded there anyway. Thanks for listening. Enjoy the Thing![/QUOTE]
OKAY THAT'S IT FOR THE DONATION INFORMATION - NOW READ ON...
[B]UPSTREAM SOURCE[/B]: [url]https://bitbucket.org/ixtab/kindlelauncher[/url]
[SIZE="1"][B][COLOR="Red"]YOU WILL NEED TO PUT [URL="http://www.mobileread.com/forums/showthread.php?t=205064"]STUFF[/URL] IN YOUR EXTENSIONS FOLDER FOR THIS TO BE USEFUL.[/B]
[COLOR="Black"]This is simply a folder called [B]extensions[/B] located in the ROOT of the drive WHEN YOU ATTACH VIA USB TO FAT. If you forget to make one in advance of running the program for the first time... This folder will be [B]automatically[/B] created for you, containing NOTHING. Simply two buttons:
[LIST]
[*][B]No Extensions Found[/B] <-- Informative message
[*]and [B]Quit[/B]
[/LIST]
To reiterate you need to put some extensions in the [B]extensions[/B] folder.
"[B]What[/B]? that really obvious place right where all the other default folders are?"
"Yep, put stuff there.. in the folder called [B]extensions[/B]"
[SIZE="2"][B]BitRot, No Magic, Voodoo (or Unicorns)[/B][/SIZE] [I]"What will run, what won't run"[/I]
SOME OF THE OLDER PROGRAMS[/COLOR] NO LONGER WORK ON THE NEWER KINDLES [COLOR="Black"]([I]nothing to do with this launcher they just dont work properly anymore[/I])[/COLOR] SUCH AS MANY IN THIS OLD LIST: [URL="http://wiki.mobileread.com/wiki/Kindle_Touch_Hacking#Extensions_for_the_GUI_Launcher"]SOME OF THESE DONT WORK[/URL] [/COLOR]
Any known misbehaving application will have support notes linked from [B]3rd Party Support Notes[/B] (below) in an effort to save you grief and wasted time. Please [B]read the notes[/B] and check your device types [B]is supported[/B] to avoid disappointment.[/SIZE]
ALSO: Some extensions such as [URL="http://www.fabiszewski.net/kindle-terminal/"]Kterm[/URL] ARE DEVICE SPECIFIC. This launcher won't MAGICALLY make code that is [B]DEVICE SPECIFIC[/B] work on [B]OTHER DEVICES[/B].
[B]If it doesn't [COLOR="Red"]normally[/COLOR] work on that type of device? [/B] [B]It [COLOR="red"]won't work[/COLOR] via this launcher either.[/B]
[QUOTE][SIZE="1"][B]NOTE:[/B] There is a push to provide binaries (or pairs of binaries) that provision for [B]all device types[/B]. These gtk-driven releases will fit perfectly into the ecosystem of KUAL. This provisioning is still in it's infancy however. Some working prototypes do, now, exist so perhaps watch this space[/SIZE][/QUOTE]
Enough shouting. You get the picture by now. [I]It's a launcher of "other things" not an exciting thing in itself...[/I]
The new KUAL v2.x series is less forgiving of BROKEN syntax in extension menu.json files... If you find any let us know and we will try to contact the author to get them fixed "at source", there are very helpful details all about the new KUAL error reporting mechanisms and what to do about the issues HERE:
[url]http://www.mobileread.com/forums/showpost.php?p=2507368&postcount=778[/url]
ALSO: We have included a few optional helper scripts to get you going:
Called "Helper" ([URL="http://www.mobileread.com/forums/attachment.php?attachmentid=119275"]attached [/URL]- unzip to [B]FAT-ROOT[/B])
[B]ALSO: highly recommended is: "Additional Menu Items for KUAL 2.x"
[url]http://www.mobileread.com/forums/showpost.php?p=2591741&postcount=15[/url][/B]
[B]In addition[/B], power users might want to take a look at the [url=http://www.mobileread.com/forums/showpost.php?p=2636883&postcount=59]gawk extension[/url], to boost the parser ;).
[/SPOILER][/COLOR]
[B]Complete List of Requirements & Their Installation[/B]:
[COLOR="White"][COLOR="Black"][SIZE="1"]To install a .bin file place it on the FAT ROOT of your kindle and choose [B]UPDATE YOUR KINDLE[/B] from the [B]SETTING[/B] page. [COLOR="Gray"][I]Actual message text may vary, it will be obvious which one to use.[/I][/COLOR] Transferring the .bin files [B]via usb[/B] rather than over ssh will ensure the installer is in a ready-to-work state on all device types.[/SIZE][/COLOR]
[COLOR="RoyalBlue"][B]Here is the list of things you [I]must[/I] have [I]installed[/I]. 3 In Total.[/B][/COLOR]
[SPOILER][COLOR="Black"][B][1] Jailbreak:[/B][COLOR="White"][QUOTE][COLOR="Black"][SIZE="1"]Select the relevant Jailbreak for your device. You will need [B]one[/B] of these.
[B][URL="http://www.mobileread.com/forums/showthread.php?t=186645"]K5, PW & PW2 (5.0 - 5.4.2.1)[/URL] [COLOR="Black"]•[/COLOR] [URL="http://www.mobileread.com/forums/showthread.php?t=191158"]Kindle 4[/URL] [COLOR="Black"]•[/COLOR] [URL="http://www.mobileread.com/forums/showthread.php?t=88004"]Kindle DX, 2.x, 3.x[/URL][/B][/SIZE][/COLOR][/QUOTE][/COLOR]
[B][2][/B] [B][URL="http://www.mobileread.com/forums/showthread.php?t=233932"]Mobileread Kindlet Kit[/URL][/B]
[B][3][/B] [B]Install Kindlet:[/B]
[COLOR="White"][QUOTE][COLOR="Black"][SIZE="1"] Copy the relevant azw2 file to the [I]documents[/I] folder on your kindle.
[COLOR="Silver"][COLOR="Gray"][I]See [B]Running the kindlet[/B] section, below.[/I][/COLOR][/COLOR][/SIZE][/COLOR][/QUOTE][/COLOR]SO TO RECAP:
[SIZE="2"](1) [B]JAILBREAK[/B],
(2) [B]MKK[/B],
(3) [B]PLACE THE [COLOR="DarkRed"]CORRECT[/COLOR] KINDLET IN THE KINDLES [I]documents[/I] FOLDER[/B][/SIZE] [SIZE="1"][COLOR="Gray"] (folder you put books in)[/COLOR][/SIZE]
[SIZE="1"][COLOR="Gray"]See [B]Running the kindlet[/B] section below to determine which Kindlet to use[/COLOR][/SIZE]
[/COLOR][/SPOILER][/COLOR]
[B]Running the kindlet[/B]:
[COLOR="White"][SPOILER][COLOR="Black"][I]Depending on your device:[/I]
(DX, K2, K3, K4)
Put [B]KUAL-KDK-1.0.azw2[/B] in [B]documents[/B] folder.
Run it by clicking new kindlet document in your list.
(Touch, PW, PW2, KV, KT2, PW3)
Put [B]KUAL-KDK-2.0.azw2[/B] in [B]documents[/B] folder.
Run it by clicking icon.
[IMG]http://www.mobileread.com/forums/attachment.php?attachmentid=100648&stc=1&thumb=1[/IMG][/COLOR]
[/SPOILER][/COLOR]
[B]Expected output[/B]:
[COLOR="White"][SPOILER][COLOR="Black"]It [I]should[/I] read through the /mnt/us/extensions folder and build a list of your extensions. Each command will create one button. you then click a button to launch the required application. Results are now paginated, and roll-around for easier scrolling.
NOTE: /mnt/us/extensions is simply a folder called [B]extensions[/B] when you connect via normal USB.
Usbnetworking is [B]not required[/B] to access this folder.[/COLOR][/SPOILER][/COLOR]
[B]The "Helper" Extensions[/B] [SIZE="1"][COLOR="Gray"]Optional extra[/COLOR][/SIZE]
[COLOR="White"][spoiler][COLOR="Black"][SIZE="1"][COLOR="DarkRed"](All Devices) [/COLOR] If you would like some helpful additional buttons you can get the [URL="http://www.mobileread.com/forums/attachment.php?attachmentid=119275"]Helper Extensions[/URL] package.
Unzip the archive and place the contents in the [B]FAT ROOT[/B]. [I][COLOR="Gray"]You of course don't need to put the ChangeLog & VERSION file on your device ;).[/COLOR][/I]
[COLOR="DimGray"][I]The USBNETWORK Extensions [B]only[/B] work when usbnetworking app is [B]installed[/B].
The 711 Network report is Touch / PW specific at this time. Silently failing on other devices[/COLOR][/I]
Also highly recommended is: "Additional Menu Items for KUAL 2.x"
[url]http://www.mobileread.com/forums/showpost.php?p=2591741&postcount=15[/url]
This package adds the following items under the KUAL menu entry (with "collation enabled")
- Non-exiting Explorer button - needs the Explorer extension available elsewhere
- Enable/disable collating menus
- Purge menu cache
- Refresh menu
- Replace/restore Store button - KT/PW only
- Sort menu ABC, ABC! and 123 modes
[/SIZE][/COLOR][/spoiler][/COLOR]
[B]FAQ[/B]:
[COLOR="White"][SPOILER][COLOR="Black"][COLOR="Black"][B]What stage is the project at?[/B]
It's at a release stage. [B]Stable[/B]. [/COLOR]
[B]Anything I should know?[/B]
You should only ever run code on your device from [COLOR="Red"]trusted sources[/COLOR]. Code run via this launcher is no exception. We accept no responsibility and expect you to be [COLOR="red"]vigilant and mindful[/COLOR] of any custom code you choose to run on your machine.
[B]Removing unwanted entries from menu[/B]
If you have a menu item you don't want. simply renaming the correct /mnt/us/extensions/<application name>/[B]config.xml[/B] and[B] menu.json [/B]to [B]config-skip.xml[/B] and [B]menu-skip.json[/B] will remove them from the lists next load. or delete the offending folders. your call.
[B]Adding things to the menu[/B]
Simply construct a pair of [B]config.xml[/B] and[B] menu.json [/B] in it's own application subfolder under /mnt/us/extensions/<application name>/ just like before. The launcher should now parse it.
At a minimum point the menu.json to run at least one thing (like say a shell script) to be actually useful.[/COLOR]
[url]http://wiki.mobileread.com/wiki/KUAL_What's_New[/url] Contains a whole BUNCH of good information for developers about how to use the new KUAL 2.x menu system. Give that a read too.
[COLOR="Black"][B]How do I convert my Launchpad scripts?[/B][/COLOR]
[COLOR="Black"]There is a [URL="http://www.mobileread.com/forums/showpost.php?p=2406316&postcount=5"]basic guide to converting the launchpad calls[/URL] to menu items.
Currently we don't auto-parse the launchpad folder. So this process is required to support applications on the older (pre Touch) devices.[/COLOR]
[COLOR="Black"]
[B]How Do I Exit?[/B]
[COLOR="Black"][B]The kindlet will [I]generally[/I] exit when you click a choice[/B]
Currently just press the [B]HOME key[/B] if you have one or the[B] [SIZE="5"]<[/SIZE] [/B] icon.
[B] Or select an item, the menu is [I]generally[/I] self-terminating.[/B]
There [I]is[/I] an option to make kual non-suicide on a per application basis, configurable in the startup configs. The "USBNetworking suite" demonstrates this in action.
[COLOR="Black"][B]I Have a Keyboard Device... Any Shortcuts?[/B][/COLOR]
Key-bindings have been added for devices with keys; [B]PAGE forward and back now do what you expect and the top row (say q, w, e, r, etc.) will SELECT "options" (i.e KUAL BUTTONS) 1, 2, 3, 4, etc. Which is nice. [/COLOR][/B][/COLOR]
[/SPOILER][/COLOR]
[B]So what can you do with this? [/B]
[COLOR="RoyalBlue"][B][SIZE="3"]Run other applications[/SIZE][/B][/COLOR]
[COLOR="White"][SPOILER][COLOR="Black"]For info on supported Known packages visit [URL="http://www.mobileread.com/forums/showthread.php?t=205064"][KUAL] Extension Support and Versioning[/URL]
An [B][COLOR="Red"]incomplete[/COLOR][/B] list follows, please DO visit the above link for the latest possible extensions:
[LIST]
[B]VIEWERS / TERMINALS / BROWERS / READERS / NOTEPADS[/B]
[*][URL="http://www.mobileread.com/forums/showthread.php?t=220412"]rdesktop[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414040&postcount=5"]KindlePDFviewer[/URL] [COLOR="YellowGreen"]2 DX 3 4 [COLOR="blue"][5][B][COLOR="blue"] [PW][/COLOR][/B][/COLOR][/COLOR] [COLOR="Blue"](see notes for 5 and [COLOR="blue"]PW[/COLOR])[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414613&postcount=13"]Hacked Up Reader[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414350&postcount=8"]Skipstone[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2413914&postcount=3"]KindleVncViewer[/URL] [COLOR="YellowGreen"]2 DX 3 4 [COLOR="Red"][5] [PW][/COLOR][/COLOR] [COLOR="red"](see notes for 5 and PW)[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414344&postcount=7"]Kterm[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414588&postcount=11"]LeafPad[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2510408&postcount=42"]IRC Client[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414622&postcount=14"]Komic[/URL] [COLOR="YellowGreen"]5 (Revisions 5.0.0 - 5.1.2) and [COLOR="RoyalBlue"]NOW Rev. 5.3.2 as of Komic V 2.2[/COLOR][/COLOR]
[B]GAMES / MEDIA / GNASH / ART[/B]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2418286&postcount=23"]Fbgnuboy game loader[/URL] [COLOR="YellowGreen"]2 DX 3[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2413940&postcount=4"]Frotz curses interface for Kindle Touch & Paperwhite[/URL] [COLOR="YellowGreen"] 5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2470844&postcount=39"] Gmplay (Kindle Silent Movie player)[/URL] [COLOR="YellowGreen"] 2 3 4 5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414362&postcount=9"]Javascript Games For Skipstone[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414466&postcount=10"]Eboard Chess[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414625&postcount=15"]Minesweeper[/URL] [COLOR="YellowGreen"]5 PW?[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2416595&postcount=22"]Mplayer GUI[/URL] [COLOR="YellowGreen"]5 PW?[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2414603&postcount=12"]Gnash[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2417350&postcount=7"]KUAL flite Speech Synthesiser [COLOR="Gray"](talking clock demo)[/COLOR][/URL] [COLOR="YellowGreen"]All Audio-Enabled Kindles[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2444779&postcount=29"]Draw - a simple TS drawing application[/URL] [COLOR="YellowGreen"]5, PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2415251&postcount=6"]Basic Audio Recorder for Kindle Touch[/URL] [COLOR="YellowGreen"]5 /PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2415041&postcount=19"][COLOR="Red"]gtkSudoku for kindle touch[/COLOR][/URL] [COLOR="Red"]KT 5.1.2 ONLY[/COLOR] [SIZE="1"][COLOR="Red"][B]SERIOUS ISSUES[/B][/COLOR][/SIZE]
[B]COLLECTIONS / SYSTEM / SECURITY / FIREWALL / UTILITIES[/B]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2461032&postcount=31
"]Broken Screen Scroller[/URL] [COLOR="YellowGreen"]2 DX 3 4[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2469267&postcount=36
"]Vague - Voice Activated GUi Extension (TOUCH DEMO)[/URL] [COLOR="YellowGreen"]5[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2469940&postcount=38
"]REALLY SIMPLE Calculator (pythonGTK) [/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2415815&postcount=20"]Collections Manager Launcher[/URL] [COLOR="YellowGreen"]5 PW[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2425539&postcount=26"]KUAL Firewall with BBB filter[/URL] [COLOR="YellowGreen"]2 DX 3 4 5 PW[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2423767&postcount=25"]BackDoorLock hack - prevents silent updates[/URL] [COLOR="YellowGreen"]2 DX 3 4 5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2422949&postcount=24"]Set DateTime from Server[/URL] [COLOR="YellowGreen"]3 4 5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2413865&postcount=3"]Toggle Light via KUAL for PAPERWHITE[/URL] [COLOR="YellowGreen"]PW ONLY[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2427212&postcount=1"]KUAL DevHelp - dmesg->doc button[/URL] [COLOR="YellowGreen"]2 DX 3 4 5 PW[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2437615&postcount=11"]Battery Report[/URL] [COLOR="YellowGreen"]2 DX 3 4 5 PW[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2447882&postcount=30"]DuokanLauncher[/URL] [COLOR="YellowGreen"] 3? 4? 5 PW?[/COLOR]
[*] [URL="http://www.mobileread.com/forums/showpost.php?p=2432411&postcount=9"]FontConfig[/URL] [COLOR="YellowGreen"] 5 PW[/COLOR]
[*][URL="http://www.mobileread.com/forums/showpost.php?p=2415028&postcount=18"]SSmodeSwitcher[/URL] [COLOR="YellowGreen"]5 (Revision 5.1.2 ONLY)[/COLOR]
[*][URL="http://www.mobileread.com/forums/showthread.php?p=2414240#post2414240"][COLOR="red"]FolderToggle[/COLOR][/URL] [COLOR="Red"]NOT SUPPORTED[/COLOR]
[/LIST][/COLOR]
[/SPOILER][/COLOR]
[B]Anything I might not have read above that I [COLOR="Red"][B]really should have[/B][/COLOR]?[/B][COLOR="Silver"][QUOTE=SUPPORT ADVICE][COLOR="Black"]
[SIZE="1"]Since most of the support requests are about the initial [I][B]installation[/B][/I] this section has been expanded to hopefully make it [B][COLOR="DarkRed"]perfectly clear[/COLOR][/B]. [/SIZE]
[COLOR="Red"]Before[/COLOR] you ask for support: Have you installed the [B]Mobileread Kindlet Kit?[/B] It is [B]REQUIRED[/B].
[COLOR="White"][SPOILER][COLOR="Black"]
You [B]MUST[/B] install the Mobileread Kindlet Kit!!!!!!!!!!!!!
See the [URL=http://www.mobileread.com/forums/showthread.php?t=233932]MKK Thread[/url].
It is really required. Like really. You NEED it.
The large error messages will be a clue if you forget this step.
You install it using the UPDATE MY KINDLE option in HOME>SETTINGS[/COLOR]
[/SPOILER][/COLOR][SIZE="1"]Don't expect support if you haven't installed it other than "[B]Install it[/B]!"[/SIZE][/COLOR][/QUOTE][/COLOR][B]So by this point you should be 100% ready to install everything...[/B]
Give it a go... :)
[SIZE="1"]We maintain lists of known issues and other exciting details below.[/SIZE] Enjoy the App.
[B]Testing, errata, one last time...[/B]
[COLOR="White"][SPOILER][COLOR="Black"]There are a couple of apps that don't play nicely - [B][I]xterm for example on the PW & PW2 must be replaced by [URL="http://www.fabiszewski.net/kindle-terminal/"]Kterm[/URL]. [/I][/B] Documenting these corner cases would go a long way towards knowing what needs to be fixed. Some efforts to this end are being made in the[B] 3rd Party Support Notes[/B] section below.
Feel free to add comments about amending that as needed.
This is in the Release phase right now for K2, K2i, DX, K3, K4, Touch, PW, PW2, KV, KT2 & PW3 devices, support is confirmed for these devices and it is safe to use the installers on them.
You can follow the project updates and grab the source here: [URL="https://bitbucket.org/ixtab/kindlelauncher/overview"]Kindle Launcher Git[/URL]
Also Attached [I]as described above[/I] is the "Helper" extensions package.
However: DO, Simply un-archive the HELPER package and place the resulting "extensions" folder and it's contents in your [B]FAT ROOT[/B] to get started with a few "Helper" links. Get you going with a few buttons.[/COLOR]
[/SPOILER][/COLOR]
[B]Programmers details:[/B]
[B]TODO[/B]:
[COLOR="White"][SPOILER][COLOR="Black"]
Make it prettier. - still.
Document everything.
UPDATE HELPER TO BE USEFUL ON ALL DEVICE TYPES[/COLOR]
[/SPOILER][/COLOR]
[B]Credits[/B]. Twobob, Ixtab, StepK, NiLuJe, KNC1, et al.
[COLOR="White"][SPOILER][COLOR="Black"]
Thanks to KNC1 for download authentication support, support hosting and all his tireless help developing the modules, structure and concepts for kual-system.
wakawakawaka for testing the DX prerequisites.
All the application authors who took the time to provide support.
All those kind users who were good enough to provide extensions for their favourite apps.
Yifan was the original chap whoms configs we parse.
All the unsung demo authors whose work we draw from on a daily basis.
And everyone else along the way.[/COLOR]
[/SPOILER][/COLOR]
[B]Known issues[/B]:[COLOR="White"][SPOILER][COLOR="Black"][B]ERROR[/B] "This device is not authorized as a test Kindle by the developer of this item"
[B]SOLUTION[/B] Re/Install the MKK bundle.
[B]ERROR[/B] "Mobileread Kindlet Kit is not installed"
[B]SOLUTION[/B] Install the MKK bundle.
[B]ERROR[/B] "The selected application cannot be started. Please try again later" on non-Japanese 4GB PW2 models.
[B]SOLUTION[/B] Update to FW >= 5.4.5 ([i]after[/i] JailBreaking your device).
[B]ERROR[/B] [COLOR="Sienna"][B]Flashed 3.2.1 Dx's[/B][/COLOR] may not show up [B]any[/B] kindlets...
[B]SOLUTION[/B] [COLOR="Gray"][SIZE="1"]There is a [URL="http://www.mobileread.com/forums/showpost.php?p=1747631&postcount=354"] workaround[/URL] by [URL="http://www.mobileread.com/forums/member.php?u=131896"]TJW[/URL] [B]<--[/B] [URL="http://www.mobileread.com/forums/showpost.php?p=2407467&postcount=6"]tested by wakawakawaka[/URL][/SIZE][/COLOR]
[B]ERROR[/B] [I][COLOR="Gray"][B]Kindlet did not shut down properly[/B][/COLOR]:[/I] Occasionally a seemingly spurious fail message is shown: "Kindlet did not shut down properly... blah.. blah.."
[B]SOLUTION[/B][COLOR="White"][spoiler][COLOR="Black"] This happens generally after:
[LIST]
[*]A change in the install of MKK. [SIZE="1"][COLOR="Gray"](following a failed previous "open" attempt)[/COLOR][/SIZE]
[*]A newly installed application ends with a bang.
[*]You restart your kindle while the app is running somehow (ssh, rebootApp, etc)
[/LIST]
Just press on "OK" then "Home" [I][B]IN TIME[/B][/I], or suffer the reboot :smack:
Simply opening KUAL again (after you dismissed the message) will work just fine. Very rare. Benign. This is actually the Amazon framework doing [B]it's job correctly[/B] and alerting us we had an issue. [COLOR="Gray"]IIRC there is some way of auto-clearing the notification but this seems contrary[/COLOR]. Therefore "Won't fix".[/COLOR][/spoiler][/COLOR][/COLOR][/SPOILER][/COLOR][COLOR="White"]
[COLOR="Black"][B]3rd Party Support Notes:[/B][/COLOR][SPOILER][COLOR="Black"]Extension with serious issues are colored.
Many have no issues but additional helpful run notes etc. check pages for details.
[B]FolderToggle [COLOR="Red"]NOT SUPPORTED[/COLOR][/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414344&postcount=6"]HERE[/URL]
[B]SSmodeSwitcher [COLOR="Blue"]KT 5.1.2 ONLY[/COLOR][/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2415028&postcount=18"]HERE[/URL]
[B]gtkSudoku for kindle touch [COLOR="Red"]KT 5.1.2 ONLY[/COLOR][/B] SERIOUS Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2415041&postcount=19"]HERE[/URL]
[B]Hacked up Reader[/B] [COLOR="DarkRed"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414613&postcount=13"]HERE[/URL]
[B]Komic[/B] [COLOR="Red"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414622&postcount=14"]HERE[/URL]
[B]Skipstone[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414350&postcount=8"]HERE[/URL]
[B]Leafpad[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414588&postcount=11"]HERE[/URL]
[B]IRC Client[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2510408&postcount=42"]HERE[/URL]
[B]Gnash[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414603&postcount=12"]HERE[/URL]
[B]Kterm[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414344&postcount=7"]HERE[/URL]
[B]Eboard Chess[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414344&postcount=10"]HERE[/URL]
[B]Javascript Games For Skipstone[/B] Issues noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414344&postcount=9"]HERE[/URL]
[B]KindlePDFViewer[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414040&postcount=5"]HERE[/URL]
[B]KindleVNCViewer[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414613&postcount=3"]HERE[/URL]
[B]Frotz[/B] [COLOR="DarkRed"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2413940&postcount=4"]HERE[/URL]
[B]Fbgnuboy game loader[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2418286&postcount=23"]HERE[/URL]
[B]Minesweeper[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2414625&postcount=15"]HERE[/URL]
[B]Collections Manager Launcher[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2415815&postcount=20"]HERE[/URL]
[B]Set DateTime from Server[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2422949&postcount=24"]HERE[/URL]
[B]KUAL flite Speech Synthesiser [COLOR="gray"](talking clock demo)[/COLOR][/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2417350&postcount=7"]HERE[/URL]
[B]Vague - Voice Activated GUi Extension (TOUCH DEMO)[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2469267&postcount=36"]HERE[/URL]
[B] Gmplay (Kindle Silent Movie player)[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2470844&postcount=39"]HERE[/URL]
[B]Basic Audio Recorder for Kindle Touch[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2415251&postcount=6"]HERE[/URL]
[B]Toggle Light via KUAL for PAPERWHITE[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2413865&postcount=3"]HERE[/URL]
[B]BackDoorLock hack - prevents silent updates[/B] [COLOR="DarkRed"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2423767&postcount=25"]HERE[/URL]
[B]KUAL Firewall with BBB filter[/B] [COLOR="Blue"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2425539&postcount=26"]HERE[/URL]
[B]KUAL DevHelp - dmesg->doc button[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2427212&postcount=1"]HERE[/URL]
[B]DuokanLauncher[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2447882&postcount=30"]HERE[/URL]
[B]FontConfig[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2432411&postcount=9"]HERE[/URL]
[B]Broken Screen Scroller[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2461032&postcount=31"]HERE[/URL]
[B]Simple Calculator[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2469940&postcount=38"]HERE[/URL]
[B]Battery Report[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2437615&postcount=11"]HERE[/URL]
[B]Draw - a simple TS drawing application[/B] [COLOR="Black"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2444779&postcount=29"]HERE[/URL]
[B]Mplayer GUI[/B] [COLOR="DarkRed"]Issues[/COLOR] noted [URL="http://www.mobileread.com/forums/showpost.php?p=2416595&postcount=22"]HERE[/URL]
Much of these issues are [B]bit rot[/B] of old extensions... not the launchers failing.
[B]NOTES:[/B] Are you a user? please report your fails on the relevant threads.
Are you a developer? use the templating system to add yourself as a "known" application.
Probably other apps exist and have issues.... If you find one we missed? Let us know.[/COLOR][/spoiler][/COLOR]
[B]HOW DO I UPGRADE FROM AN EARLIER ONE? [/B]
[COLOR="Gray"][I]No need to touch MKK.[/I][/COLOR]
Replace the old KUAL-KDK-[I](1|2)[/I].0.azw2 file in the [I]documents[/I] folder with the new one.
[B]NOTE:[/B] If you're upgrading from a version older than 2.3, remove the deprecated [B]KindleLauncher-[I](1|2)[/I].0.azw2[/B] file in the process.
The correct, up to date filename is now [B]KUAL-KDK-[I](1|2)[/I].0.azw2[/B] ;).
That's everything. [COLOR="Gray"][I]You can find the new one in the KUAL files below[/I][/COLOR]
[B]Changelog [/B]
[url]https://bitbucket.org/ixtab/kindlelauncher/src/master/src/com/mobileread/ixtab/kindlelauncher/resources/dist/NEWS.txt?at=master[/url]
[/SPOILER]