K5 How do I run .sh files from the documents folder on Kindle Touch?

gt346 · Yesterday, 10:18 AM

I have a Kindle Touch running firmware 5.3.7.3

I jailbroke it with "K5 JailBreak (5.0.x - 5.4.4.2)" and installed the hotfix, DevCerts update, MRPI, KUAL, and KOReader. KUAL and KOReader run just fine, but I can't run any shell scripts with a .sh extension in the documents folder.

What do I need to do? I searched the forum but didn't find anything.

Thanks!

j.p.s · Yesterday, 01:02 PM

Install kterm or install usbnetwork and connect to the kindle with ssh.
(Or search the forum for posts about RUNME.sh)

gt346 · Yesterday, 03:40 PM

Quote:

Originally Posted by j.p.s

Install kterm or install usbnetwork and connect to the kindle with ssh.
(Or search the forum for posts about RUNME.sh)

I'm confused. Would those things allow scripts to execute by clicking on their icon, or are they workarounds that can execute the scripts in other ways?

I searched for RUNME.sh and it seems that name is not optimized for finding meaningful search results.

j.p.s · Yesterday, 04:39 PM

At the top of page:
Search -> Advanded Search
returns 136 threads that mention RUNME.sh

Anyone wanting to run scripts should know that the standard way is from a command line. kterm is a terminal emulator and ssh allows command line access from a remote computer.

A 4th way to run scripts on a kindle is to write your own KUAL extension. Please do some research before coming back to ask "How to I write a KUAL extension?".

Frogm4n · Yesterday, 05:37 PM

The newer hot fix supports scriptlets. I'm sure they are asking how to replicate this feature on older firmware.

https://kindlemodding.org/kindle-dev/scriptlets.html

gt346 · Yesterday, 08:31 PM

Quote:

Originally Posted by Frogm4n

The newer hot fix supports scriptlets. I'm sure they are asking how to replicate this feature on older firmware.

https://kindlemodding.org/kindle-dev/scriptlets.html

Yes, that's what they're asking. I have a bunch of newer kindles, but someone gave me a Kindle Touch, which despite the lower PPI seems to have a much nicer screen - or at least a much higher contrast screen which seems easier to read.

Is this possible? I'd just like to be able to open up KOReader by clicking an icon on the home screen, without having to reinvent the wheel.

Thanks!

shamanNS · Yesterday, 09:32 PM

Just for fun I previously tested and was successful in manually adding / "registering" SH_Integration on top of old, non-universal hotfix on a PW1 with firmware 5.6.1.1. So it had scriptlets without using the new universal hotfix. I just took the Sh_integration binaries/.so files and handler registration commands from unpacked universal hotfix bin file and did things manually via SSH / USBNet

No idea it that would even work on Kindle Touch with fw 5.3.x (same for if "universal hotfix" would even install it and work correctly on that firmware). It certainly never was tested on such and old device and firmware.

And I also recall that I was successful in installing and using "Kwordle" on that same PW1 And when someone else tried using it on Kindle Touch it wouldn't work/install because I guess there are some differences in structure of "appreg.db" database into which KWordle installer script tries to add stuff.

Since registering Sh_integration also needs to add various things into "appreg.db" I wouldn't be surprised it also errors out when tried on Kindle Touch & fw 5.3.x.

Does anyone know if support for "booklets" existed and worked on 5.3.x?

If they do work instead of trying to "retrofit" scriptlets support to Kindle Touch firmware you could possibly use KOL booklet for starting KOReader.

https://github.com/yparitcher/KUAL_Booklet

gt346 · Yesterday, 11:53 PM

Thank you, that worked. Now I can open KOReader directly from the home screen without going through the KUAL menus.

I still don't have a way of executing scripts from the documents folder, aside from executing them in KOReader. When I ran Check.OTA.status_current.sh from KOReader, the only way to exit out of it was rebooting, but I can deal with that limitation.

I was debating attempting what you did and manually doing what the later hotfix versions do, but decided the juice wasn't worth the squeeze. This gets me to about the same place without messing around with all that.

Thanks again!

Yesterday, 10:18 AM	#1
gt346 Member Posts: 17 Karma: 10 Join Date: Sep 2025 Device: Kindle	How do I run .sh files from the documents folder on Kindle Touch? I have a Kindle Touch running firmware 5.3.7.3 I jailbroke it with "K5 JailBreak (5.0.x - 5.4.4.2)" and installed the hotfix, DevCerts update, MRPI, KUAL, and KOReader. KUAL and KOReader run just fine, but I can't run any shell scripts with a .sh extension in the documents folder. What do I need to do? I searched the forum but didn't find anything. Thanks!

Yesterday, 09:32 PM	#7
shamanNS Wizard Posts: 1,140 Karma: 12345678 Join Date: Feb 2010 Location: Serbia Device: Kindle PW5, Kobo Libra 2, Kindle PW1	Just for fun I previously tested and was successful in manually adding / "registering" SH_Integration on top of old, non-universal hotfix on a PW1 with firmware 5.6.1.1. So it had scriptlets without using the new universal hotfix. I just took the Sh_integration binaries/.so files and handler registration commands from unpacked universal hotfix bin file and did things manually via SSH / USBNet No idea it that would even work on Kindle Touch with fw 5.3.x (same for if "universal hotfix" would even install it and work correctly on that firmware). It certainly never was tested on such and old device and firmware. And I also recall that I was successful in installing and using "Kwordle" on that same PW1 And when someone else tried using it on Kindle Touch it wouldn't work/install because I guess there are some differences in structure of "appreg.db" database into which KWordle installer script tries to add stuff. Since registering Sh_integration also needs to add various things into "appreg.db" I wouldn't be surprised it also errors out when tried on Kindle Touch & fw 5.3.x. Does anyone know if support for "booklets" existed and worked on 5.3.x? If they do work instead of trying to "retrofit" scriptlets support to Kindle Touch firmware you could possibly use KOL booklet for starting KOReader. https://github.com/yparitcher/KUAL_Booklet Last edited by shamanNS; Yesterday at 09:43 PM.

Thread Tools	Search this Thread
Show Printable Version Email this Page	Search this Thread: Advanced Search

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Amazon Fire e-Books onto documents folder of Kindle folder	Maverick1962	Amazon Fire	1	01-20-2020 03:05 AM
How I re-install Kindle Touch when lost all files and folder	tuchchai	Kindle Developer's Corner	5	07-25-2013 04:04 AM
Kindle Fire:Why Do My MOBI Files End Up in my DOCUMENTS Folder Instead of BOOKS??	Nalapombu	Calibre	7	04-22-2012 03:16 PM
Items delelted from Kindle Documents folder still showing on Kindle	bounce	Amazon Kindle	13	03-04-2012 02:39 PM
Deleted Kindle Touch Documents folder contents	Newf	Amazon Kindle	2	12-28-2011 03:20 PM

Yesterday, 01:02 PM	#2
j.p.s Grand Sorcerer Posts: 5,853 Karma: 105494725 Join Date: Apr 2011 Device: pb360	Install kterm or install usbnetwork and connect to the kindle with ssh. (Or search the forum for posts about RUNME.sh)

Yesterday, 04:39 PM	#4
j.p.s Grand Sorcerer Posts: 5,853 Karma: 105494725 Join Date: Apr 2011 Device: pb360	At the top of page: Search -> Advanded Search returns 136 threads that mention RUNME.sh Anyone wanting to run scripts should know that the standard way is from a command line. kterm is a terminal emulator and ssh allows command line access from a remote computer. A 4th way to run scripts on a kindle is to write your own KUAL extension. Please do some research before coming back to ask "How to I write a KUAL extension?".

Yesterday, 05:37 PM	#5
Frogm4n Fanatic Posts: 517 Karma: 4000001 Join Date: Jul 2023 Device: Scribe 2022, OA2, PRS-350	The newer hot fix supports scriptlets. I'm sure they are asking how to replicate this feature on older firmware. https://kindlemodding.org/kindle-dev/scriptlets.html

Yesterday, 11:53 PM	#8
gt346 Member Posts: 17 Karma: 10 Join Date: Sep 2025 Device: Kindle	Thank you, that worked. Now I can open KOReader directly from the home screen without going through the KUAL menus. I still don't have a way of executing scripts from the documents folder, aside from executing them in KOReader. When I ran Check.OTA.status_current.sh from KOReader, the only way to exit out of it was rebooting, but I can deal with that limitation. I was debating attempting what you did and manually doing what the later hotfix versions do, but decided the juice wasn't worth the squeeze. This gets me to about the same place without messing around with all that. Thanks again!