Tools Snapshots of NiLuJe's hacks

[DNSB]

Originally Posted by S3i

Hello,
first of all, thank you for all your work!
I followed the procedure on this site:
https://kindlemodding.org/jailbreaki...ling-kual-mrpi

The “winterbreak” and “Post jailbreak: Setting up a hotfix” parts went well.

But for the part “Post jailbreak : installing KUAL/MRPI” at the line “5 Enter ;log mrpi into the search bar and click enter” I have an error at reboot see picture 1.

I saw the same error on both PW4s that I've used WinterBreak on. It does not seem to have any effect on anything.

[Waylander]

[DELETED]

[Waylander]

Deleted the above post because I read around, tinkered, and worked out what I hadn't done properly. Now have KUAL coplate installed properly, and reminded myself that if I didn't put any packages into the MRpackages folder, then there wouldn't be anything for KUAL to run (duh). Anyway, I was wondering how I can use KUAL on my PW5 to modify the margins in my ebooks beyond the standard settings. This was something I could do with KUAL on my old PW1 back in the day. Also, when installing KOReader, do I put both the Koreader *and* extensions folder in the root of the Kindle? When I try that, my Mac asks if I want to replace the extensions folder that's already there.

[shamanNS]

Originally Posted by Waylander

Anyway, I was wondering how I can use KUAL on my PW5 to modify the margins in my ebooks beyond the standard settings. This was something I could do with KUAL on my old PW1 back in the day.

Lol. On very very early PW1 firmware you probably used "JBPatch" to overload Java code that controls margin values. On later firmware probably @kaznelson's bin installer that replaced couple of JAR files to do the same thing.
For newer models and even newer firmware build you had to do the same JAR edits yourself because nobody already did them for you.

Anyways, long story short: ever since firmware 5.10.x known "margin hack" JAR file edits are ignored / doesn't result with any change in margins shown when you open the book.

So now the only thing available is "per each book" approach, where you need to change CSS code for every book you read a and a code block that sets negative margin for "html" element. And that only works for left and right margins, not for top and bottom margins.

[Waylander]

Originally Posted by shamanNS

Lol. On very very early PW1 firmware you probably used "JBPatch" to overload Java code that controls margin values. On later firmware probably @kaznelson's bin installer that replaced couple of JAR files to do the same thing.
For newer models and even newer firmware build you had to do the same JAR edits yourself because nobody already did them for you.

Anyways, long story short: ever since firmware 5.10.x known "margin hack" JAR file edits are ignored / doesn't result with any change in margins shown when you open the book.

So now the only thing available is "per each book" approach, where you need to change CSS code for every book you read a and a code block that sets negative margin for "html" element. And that only works for left and right margins, not for top and bottom margins.

I thought it was something like this. In which case, KOReader is the best option. I found a useful installation tutorial video on YouTube, which helped guide me through it.

[Barbas]

Originally Posted by esverde

Python 2.7 & Python 3.9 don't support kindle scribe, is it possiable get some update?

Same here with a Kindle 11th gen (2022) on fw 5.16.4

[2025-01-08 @ 18:30:27 +0058] :: [MRPI r19303] - Beginning the processing of package 'Update_python3_0.15.N_install_pw2_and_up.bin' (python3 0.15.N I W+Z+R+B) . . .


Failed to parse package 'Update_python3_0.15.N_install_pw2_and_up.bin' (python3 0.15.N I W+Z+R+B) [return code: 127], skipping . . . :(


KindleTool output:
env: can't execute '/mnt/us/extensions/MRInstaller/bin/PW2/kindletool': No such file or directory

[S3i]

Originally Posted by DNSB

I saw the same error on both PW4s that I've used WinterBreak on. It does not seem to have any effect on anything.

So I'm not the only one

Could someone expert help me?

[BionicGecko]

Originally Posted by S3i

So I'm not the only one

Could someone expert help me?

I also got this error but it had no lasting impact, i.e. KUAL got installed correctly. If you can see KUAL in your books then you can safely ignore this error.

As for KOReader, make sure you install the kindlehf version. Your best bet is the one from Marek’s page.

[S3i]

Originally Posted by BionicGecko

I also got this error but it had no lasting impact, i.e. KUAL got installed correctly. If you can see KUAL in your books then you can safely ignore this error.

As for KOReader, make sure you install the kindlehf version. Your best bet is the one from Marek’s page.

Thank you !

It works now !!!

[tepagu]

Hi,
I've recently bought a Kindle Scribe 1st edition 2024 and while i was able to run winterbreak with no issues, i cannot get KUAL running.
Checking the MRInstaller logs, i see the following message.
Package 'Update_KUALBooklet_18b218e_install.bin' (KUALBooklet 18b218e I) is not targeting your device [FE3 vs. 11... (and other numbers after this).
I'm running 5.17.2.
Is there anything i have to do to fix this?
Thanks for your help!

[SEVRM]

This does not work with Kindle 3 Wifi firmware 3.4.2, as soon as you connect to wifi the jailbreak no longer works and you get the "test kindle "error.

[crazyelectron]

For those of us who eagerly await the release the proper armhf compatible python3 package, in the meantime, this is how I’ve compiled python3 to run on my Kindle Scribe 5.17.0.1 (armhf)

Please consider this just as a notebook in progress, most of the things may/will not work, I followed the suggestion and tried the

Originally Posted by NiLuJe

just respin the package w/ KindleTool yourself.

By the way thanks to the eminent programmer/s involved in Koxtoolchain, KindleTool and all the packages in this thread.

Dockerfile

FROM --platform=linux/amd64 debian:bullseye AS amd64-base

RUN apt-get update

RUN DEBIAN_FRONTEND=noninteractive apt-get install -y \
    build-essential autoconf automake bison flex gawk \
    libtool libtool-bin libncurses-dev \
    curl file git gperf help2man texinfo unzip wget

# Python dev deps for --with-build-python
RUN DEBIAN_FRONTEND=noninteractive apt-get install -y \
    make libssl-dev zlib1g-dev libbz2-dev libreadline-dev \
    libsqlite3-dev llvm libncurses5-dev libncursesw5-dev \
    xz-utils tk-dev liblzma-dev tk-dev libffi-dev

RUN DEBIAN_FRONTEND=noninteractive apt-get install -y \
    pkg-config

WORKDIR /root

RUN wget -qO- https://www.python.org/ftp/python/3.11.11/Python-3.11.11.tgz | tar xvz

RUN cp -r Python-3.11.11 Python-3.11.11-armhf

RUN cd Python-3.11.11 && \
    ./configure --prefix=/usr/local/python-native --enable-optimizations --with-lto --with-computed-gotos --with-system-ffi && \
    make -j$(nproc) && \
    make install

RUN wget -qO- https://github.com/KindleModding/koxtoolchain/releases/download/2025.01/kindlehf.tar.gz | tar xvz && \
    wget -qO- https://github.com/KindleModding/koxtoolchain/raw/27f361f5d5e1b85b6d02978a6b45271a2605019c/refs/x-compile.sh > x-compile.sh

# TO-Discover Where on earth are the contents of ./Kindle/CrossTool/Build_KHF sysroot?? "./gen-tc.sh kindlehf" doesn't seem to gather them, and they are not in kindlehf.tar.gz either.   
RUN mkdir -p /mnt/us/python3

RUN echo '#!/bin/bash\n\
\n\
set -a\n\
HOME=/root source /root/x-compile.sh kindlehf env bare\n\
set +a\n\
\n\
export CC=$CROSS_TC-gcc\n\
export CXX=$CROSS_TC-g++\n\
export STRIP=$CROSS_TC-strip\n\
export AR=$CROSS_TC-gcc-ar\n\
export RANLIB=$CROSS_TC-gcc-ranlib\n\
export LD=$CROSS_TC-ld\n\
export READELF=$CROSS_TC-readelf\n\
export SYSROOT=/mnt/us/python3\n\
export X_TOOLS_SYSROOT=/root/x-tools/arm-kindlehf-linux-gnueabihf/arm-kindlehf-linux-gnueabihf/sysroot\n\
export CFLAGS="-I$SYSROOT/usr/include -I$X_TOOLS_SYSROOT/usr/include"\n\
export CPPFLAGS="-I$SYSROOT/usr/include -I$X_TOOLS_SYSROOT/usr/include"\n\
export LDFLAGS="-L$SYSROOT/lib -L$SYSROOT/usr/lib -L$X_TOOLS_SYSROOT/lib -L$X_TOOLS_SYSROOT/usr/lib -Wl,-rpath=/mnt/us/python3/usr/lib -Wl,-rpath-link=$SYSROOT/lib:$SYSROOT/usr/lib:$X_TOOLS_SYSROOT/lib:$X_TOOLS_SYSROOT/usr/lib"\n\
export PKG_CONFIG_SYSROOT_DIR="$SYSROOT"\n\
export PKG_CONFIG_PATH="$SYSROOT/usr/lib/pkgconfig"\n\
' > /root/exec && chmod +x /root/exec

RUN wget -qO- https://github.com/madler/zlib/archive/refs/tags/v1.3.1.tar.gz | tar xvz
RUN cd zlib-1.3.1 && \
    bash -c "source /root/exec && \
    ./configure --prefix=/usr && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

RUN wget -qO- https://github.com/libffi/libffi/releases/download/v3.4.6/libffi-3.4.6.tar.gz | tar xvz
RUN cd libffi-3.4.6 && \
    bash -c "source /root/exec && \
    ./configure --prefix=/usr --host=arm-linux-gnueabihf --build=x86_64-pc-linux-gnu && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

RUN wget -qO- https://github.com/openssl/openssl/archive/refs/tags/OpenSSL_1_1_1w.tar.gz | tar xvz
RUN cd openssl-OpenSSL_1_1_1w && \
    bash -c "source /root/exec && \
    ./Configure linux-armv4 --prefix=/usr --openssldir=/etc/ssl -DOPENSSL_PIC -DOTHER_LIBS=atomic -lpthread -latomic && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

RUN wget -qO- https://www.sqlite.org/2024/sqlite-autoconf-3450100.tar.gz | tar xvz 
RUN cd sqlite-autoconf-3450100 && \
    bash -c "source /root/exec && \
    ./configure --prefix=/usr --host=arm-linux-gnueabihf --build=x86_64-pc-linux-gnu && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

RUN wget -qO- https://ftp.gnu.org/gnu/ncurses/ncurses-6.4.tar.gz | tar xvz 
RUN cd ncurses-6.4 && \
    bash -c "source /root/exec && \
    ./configure --prefix=/usr --host=arm-linux-gnueabihf --build=x86_64-pc-linux-gnu --with-shared --disable-stripping && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

RUN cd Python-3.11.11-armhf && \
    bash -c "source /root/exec && \
    ./configure --prefix=/usr --host=arm-linux-gnueabihf --build=x86_64-pc-linux-gnu --with-build-python=/usr/local/python-native/bin/python3.11 --enable-shared --enable-optimizations --enable-loadable-sqlite-extensions --with-lto --with-computed-gotos --with-system-ffi --with-ensurepip=install --disable-ipv6 --disable-test-modules ac_cv_file__dev_ptmx=no ac_cv_file__dev_ptc=no && \
    make -j$(nproc) && \
    make install DESTDIR=\$SYSROOT"

Next, I built the image and copied the python3 sysroot to the device:

docker buildx build -t kterm_kindle .

docker run --rm -it -v $(pwd):/project kterm_kindle bash -c "tar -czvf /project/python3.tar.gz -C /mnt/us python3"

scp python3.tar.gz root@192.168.1.101:/mnt/us

On the Kindle extracted the python3 sysroot:

[root@kindle us]# tar -xvf python3.tar.gz -C /mnt/us/

Then running python3 and pip (It is necessary to use the full path or modify $PATH):

[root@kindle us]# /mnt/us/python3/usr/bin/python3.11 -m ensurepip
[root@kindle us]# /mnt/us/python3/usr/bin/python3.11 -m pip install requests
[root@kindle us]# /mnt/us/python3/usr/bin/python3.11
Python 3.11.11 (main, Jan 29 2025, 20:15:57) [GCC 14.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import requests
>>> r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass'))
>>> r.status_code
200
>>>

Of course only packages with a compatible built distribution (.whl) available will/may work.

Note: all the “docker” commands were run on MacOS, for linux it may be necessary to adapt them.

[TsukiSoft]

I don't know what im doing wrong, i want the screensaver to put the book cover, i followed everything, i did everything 3 times, and i have all working good except the cover mode. Tried with different books that i know have covers but nothing

[KridOCaign]

I have an 11th gen Paperwhite Signature Edition running FW 5.15.1.0.3
I jailbroke it with Winterbreak
If I install GAWK then afterwards KUAL will hang on a white screen and the kindle is unresponsive until it is power cycled. It can still enter USB mode and manage files.

I don't see any logs.

Is this a known issue?

[aha]

The same happened to me. And apparently to someone else.

Per the comments in that thread, the gawk extension shouldn't be installed on hf kindles. (Is it the only one?)

Would it be possible to add a note to that effect in the first post, so people don't install it by mistake?

I know the later kindles aren't listed as supported in the linked post on the gawk installer, but that's from 2019 so it just seemed out of date.

Thank you! (And thank you for all these hacks in general. Just being able to run koreader on kindles is amazing, let alone the rest of it.)