Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
s & USBNetwork hacks for all non Touch Kindle devices (Kindle 2/DX/DXG/3/4), alo
ng with the Kindle 2/DX/DXG/3 JailBreak.
I know it's a bit daunting, but please bear with me, it'll be worth it ;).
First things first, a huge thanks to the original creators/updaters of these hac
ks, all the people who, at some point, worked on these hacks, and some of the pi
oneers! In no particular order:
* clarknova : http://www.mobileread.com/forums/showpost.php?p=963004&postcount=2
for the first 2.5.x jailbreak & screensavers hacks
* porkupan : http://www.the-ebook.org/forum/viewtopic.php?t=11259 for one of the
first bind mount based fonts hack
* kukyakya : http://www.mobileread.com/forums/showthread.php?t=87995 for the usb
watchdog & update-safe tweaks : https://redmine.kukyakya.pe.kr/projects/customf
ont/wiki/Customfont
* jyavenard : http://www.mobileread.com/forums/showthread.php?t=63225 for the pa
ckager
* tedsan : https://sites.google.com/a/etccreations.com/kdesignworks/Home/font-in
stall-files & blogkindle : http://blogkindle.com/unicode-fonts-hack/ for their f
onts hack
* igorsk : http://igorsk.blogspot.com/, ebs : http://www.mobileread.com/forums/s
howthread.php?t=49350 & Jesse Vincent : http://blog.fsck.com/ for all they did
to make this possible!
* yifanlu : http://www.mobileread.com/forums/showthread.php?t=122519 and dsmid :
http://www.mobileread.com/forums/showthread.php?t=122000 for the Kindle 3.1 jai
lbreak!
* yifanlu : http://www.mobileread.com/forums/showthread.php?t=122519 and serge_l
evin : http://www.mobileread.com/forums/showpost.php?p=1725629&postcount=151 for
the Kindle 3.2.1 jailbreak!
*Latest Updates (10/12/2012):*
JailBreak v0.11.N, Fonts v5.5.N, SS v0.30.N, USBNet v0.44.N (Updated binaries).
*INSTALL:*
*Jailbreak:*
*Note for Kindle 4 Users*
Please skip this section and refer to the Wiki : http://wiki.mobileread.com/wiki
/Kindle4NTHacking#Jailbreak instead.
Download the attached kindle-ss-0.30.N.zip file, and unpack it. In here, you'll
find a bunch of .bin files, and a src directory.
First, upload the correct *update_*_install.bin* file for your kindle to the roo
t directory of your Kindle.
For a Black Kindle 4, that would be *update_ss_0.30.N_k4_install.bin* for exampl
e.
Now, eject your Kindle, and go to *[HOME] -> [MENU] > Settings -> [MENU] > Updat
e Your Kindle*. It should take a couple dozen of seconds.
To change your custom screensavers, plug your Kindle to your computer via USB, a
nd upload them to the *linkss/screensavers* folder that has been created by the
hack. You'll have to restart your Kindle in order to take your new screensavers
into account. To that effect, you can either use the autoreboot feature, or simp
ly do a full restart of your Kindle.
To use the autoreboot feature: Just drop a blank file named *reboot* in the link
ss folder (by copying and renaming the already existing "autoreboot" blank file,
for example) (*or in the linkfonts folder if you also have the fonts hack insta
lled!*), and your Kindle will do a quick reboot 10s after you've unplugged it!
For those of you using meme's wonderful Kindle Collections : http://www.mobilere
ad.com/forums/showthread.php?t=118635 plugin for Calibre, that's exactly what it
s 'fast reboot' setting does whan you eject your Kindle from Calibre ;).
If you want to randomize the sequence in which your screensavers will be shown,
create a blank file named *random* in the linkss folder (right alongside the "au
to" file), and then do a full restart of your Kindle! This will shuffle your scr
eensavers around on each boot.
*Since v0.23.N:* In addition to this, you can also shuffle your screensavers eac
h time a framework restart is triggered through the autoreboot feature. Be advis
ed that this may significantly (a few dozen of seconds) delay the framework rest
art procedure, depending on the number of screensavers you're using. To enable t
his feature, create a blank file named *shuffle* in the linkss folder (right alo
ngside the "auto" file), and then estart your Kindle (either through the autoreb
oot feature, or a full restart).
*Fonts:*
Please read this section in full before installing this hack, there are a few im
portant things to be aware of: most notably that in order to avoid potential iss
ues, you'll probably want to disable any & all password & parental control prote
ctions until you're satisfied with your fonts settings!
Download the appropriate kindle-fonts-5.5.N.rar file for your device (the K2, K2
I, DX, DXI and DXG packages are in the kindle-fonts-5.5.N-k2.rar archive, the K3
G, K3W and K3GB packages are in the kindle-fonts-5.5.N-k3.rar archive, and the K
4 packages are in the kindle-fonts-5.5.N-k4.rar archive), and unpack it. In here
, you'll find a bunch of .bin files, and a src directory.
First, upload the correct *update_*_install.bin* file for your kindle to the roo
t directory of your Kindle.
For a Kindle 2 International, that would be *update_fonts_5.5.N_k2i_install.bin*
for example.
Now, eject your Kindle, and go to *[HOME] -> [MENU] > Settings -> [MENU] > Updat
e Your Kindle*. It should take a few dozen of seconds. If you're on FW 3.x or 4.
x, and this is your first install, it may seem to hang for about a minute or two
on the "Update successful, Your Kindle is restarting..." screen, that's okay.
If you want to change the fonts used by the hack, you'll have to upload them in
the *linkfonts/fonts* directory, strictly following the usual naming scheme. (Ty
pe_Style.ttf) (for details on where each font is used, please see this post : ht
tp://www.mobileread.com/forums/showpost.php?p=977006&postcount=97). The default
fonts installed by the hack are the usual non-cjk unicode fonts (Droid Sans, Dro
id Serif & DejaVu Sans Mono), with the addition of the CJK-aware Droid Fallback
if you're on FW 3.x or 4.x. You'll find a bunch of other prepackaged, ready to u
se, font sets here, and in the next few replies.
You'll have to restart your Kindle in order to properly take your new fonts into
account.
*By default, the autoreboot feature is enabled*. If you wish to make use of it,
don't forget to drop a blank file named *reboot* in the linkfonts folder (right
alongside the "autoreboot" file, by copying and renaming it, for example). When
that file is present, your Kindle should automatically do a quick reboot 10s aft
er you've unplugged it.
*FW 3.x & 4.x:* If you chose to handle the browser fonts, this will add a consid
erable overhead to this process (we need to regenerate FontConfig's config & cac
he). That can take more than a couple of minutes! It'll happen each time you upd
ate your fonts, either during the framework startup if you did a full restart, o
r *before the framework restart when using the autoreboot feature!*. So, if you'
re switching fonts on a K3 or K4, and you have enabled the browser fonts handlin
g (more on that later), and you use the autoreboot feature, don't be surprised i
f it takes considerably more than 10s before the framework restarts!
Another thing to take into account since FW 3.x is that the settings of the rend
ering engine have changed a bit. It now makes use of the TrueType bytecode hinti
ng instructions of your fonts, and uses them to hint at the most aggressive leve
l. (In terms of FT/FC settings: hinting=true, hintstyle=hintfull, autohint=false
). What this means is that fonts without hinting instructions (or with crappy co
de) will look considerably fuzzier than they did on previous devices. It's espec
ially noticeable at small sizes, and in the browser.
If you really want to be able to tweak the browser fonts, and don't care about t
he overhead involved, just remove the *nobrowser* file in the linkfonts folder,
and Restart your Kindle, and wait. A lot. *NOTE*: Because regenerating the cache
takes so much time, we won't try to handle the browser fonts by default, in ord
er not to waste 5 minutes each font switch.
*Important note about KF8 files:* Please note that in order to use your custom f
onts in KF8 files, you will *have* to enable this feature! You'll also want your
font's metadata to be consistent: for example, all the Serif fonts should be of
the same family, and their styling info should be accurate, or you'll risk havi
ng strange surprises, like books rendered in all bold ;).
There's also two new custom fonts used for rendering non-latin scripts. CJK.ttf,
like the name implies, is used to render Chinese/Japanese/Korean scripts. After
that, there's I18N.ttf, which is used as a fallback. By default, the hack uses
the DejaVu Sans font. While it's far more pretty than the vanilla fallback font
usually used (code2000), it does seem to support a lot less different types of s
cripts. Long story short, if you have weird non-latin rendering issues, those ar
e the two fonts you should look at ;).
If you don't use the autoreboot feature (for exemple if you removed the autorebo
ot file in the linkfonts folder), you'll have to do at least a framework restart
each time you change the fonts. If you have no means of doing a framework resta
rt (ie. via usbnetwork), you'll have to do a full restart via the Settings menu,
or by holding the power switch for ~15 seconds). Do note that the autoreboot &
Restart methods are both way cleaner (and possibly safer) than the physical hard
-reboot (which basically just plugs the battery off for a little while, which ex
plains why your Kindle needs to be unplugged from any power source for this to w
ork).
/!\ Be careful, if you miss a font, the hack won't be applied, so you shouldn't
have any problem, but if for some reason, the Kindle software doesn't like one o
f your custom font, they'll be garbled, or invisible. Also, it may prevent you f
rom actually _seeing_ the Settings page to do the restart. (And actually reading
any books, also.) If that happens to you, try one of the three methods describe
d earlier to reboot your Kindle. *If you want to avoid this kind of issue, use t
he autoreboot feature ;)* Also, *don't remove the other fonts found in the linkf
onts/fonts folder*. We need them, and the hack won't be applied if they're missi
ng. Using an FT override like bci is another workaround to remember if your devi
ce *really* doesn't like a font, even after a reboot.
*Since v4.0.N:* You can now control a bit more the settings used by the renderin
g engine. For example, if you want to make sure it'll be using FreeType's autohi
nter (like on FW 2.x) instead of native hinting on FW >= 3.x, drop a blank *auto
hint* file in the linkfonts folder. The same applies on FW 2.x if you want to ma
ke sure the renderer uses native hinting (like FW >= 3.x) instead of the autohin
ter on FW 2.x, drop a blank *bci* file in the linkfonts folder.
You will have to do a full *Restart* of your Kindle for the changes to be taken
into account (a framework restart won't be enough).
(Note that both settings are always available (ie. you can use bci on FW 3.x, an
d autohint on FW 2.x), in which case while the rendering should be mostly simila
r to your Kindle's defaults, it won't be exactly the same, due to changes in Fre
eType, and possibly patches Amazon might be using. If you have both files presen
t, autohint will take precedence. It might also impact page turns perceived spee
d (good or bad, YMMV).)
*v4.1.N:* In addition to autohint & bci, there is now a third setting available:
*light*. It's based on autohint, but with lighter hinting and a bunch of other
tweaks used in order to try to preserve each glyph's shape, at the expense of be
ing potentially a bit fuzzier. It's a bit like font rendering on OS X. It might
very well look better than both the autohint or bci settings in the latest versi
ons of the Hack.
*v5.4.N:* The bci_new override was added. It's similar to bci, but it might be s
lightly more performant. It might also be less compatible, so if you start encou
ntering weird rendering issues, switch back to bci ;).
*NOTE:* For obvious reasons (it's a bit more intrusive than usual), this is disa
bled by default. But it might very well workaround the 'blank fonts' issue some
of you have been suffering on FW >= 3.x ;).
*NOTE:* If all of this is still a bit unclear, please check this post : http://w
ww.mobileread.com/forums/showpost.php?p=1210081&postcount=1066. And if you're st
ill confused, you can of course skip this feature entirely ;).
*WIKI:*
If you have some trouble with my brief instructions, the MR wiki has been update
d (with some screenshots):
Fonts Hack: http://wiki.mobileread.com/wiki/Kindle_Font_Hack_for_all_2.x,_3.x_an
d_4.x_Kindles
SS Hack: http://wiki.mobileread.com/wiki/Kindle_Screen_Saver_Hack_for_all_2.x,_3
.x_%26_4.x_Kindles
*NOTES:*
Some people reported losing their collections when installing these hacks... It
shouldn't happen, but apparently it's a bug in the vanilla 2.5 firmware, so make
sure you do a Whispernet Sync and/or that you make a backup of your *system/col
lections.json* file before doing anything ;).
Don't try to force a custom update by rebooting your Kindle. You should *always*
install custom hacks via the Settings page. If the 'Update Your Kindle' link is
greyed out, it's because you uploaded the wrong binfile for your device. Don't
try to force an install by rebooting. It'll, at best, fail, and at worst, force
you to start your Kindle in recovery mode to delete the offending update.
Again, if you're having issues with the Fonts hack (missing fonts, blank pages/m
enu, ...), do try to use one of the new freetype override settings! In the same
vein, disable your Kindle's password/parental control before switching fonts, th
ere's been reports that a messed up font will prevent the password box from popp
ing up, in which case you won't be able to unlock your device... And that probab
ly means a hard reset to factory defaults will be needed to clear things up, and
that's never fun ;'(.
Also note that, while there is a zipfile for the usbnetwok hack attached here, I
won't provide *any* support for it, and I *strongly* discourage anyone not well
versed in bare-bone Linux CLI system administration to even try it. It's far to
o easy to brick your device/mess up the software with that thing.
*ChangeLog:*
**Jailbreak*:
* *v0.1.N*:
* Added an uninstaller, just in case
* *v0.2.N*:
* Works on firmware <= 3.0.2 :).
* *v0.4.N*:
* Works on firmware <= 3.0.3 :).
* *v0.5.N*:
* Works on firmware <= 3.2, thanks to yifanlu!
* *v0.6.N*:
* Fix uninstall so that it immediately switches back to default keys (on
FW 3.1), instead of requiring a reboot.
* *v0.7.N*:
* Fix a stupid oversight that prevented a number of hacks to be correctl
y whitelisted. >_<"
* *v0.8.N*:
* Works on firmware <= 3.3, thanks to yifanlu & serge_levin!
* *v0.9.N*:
* Try harder to warn users when mixing jailbreaks (ie. abort if another
jailbreak is found).
* Also, fix the K3 3.0-3.2 packages that I stupidly broke in 0.8.N... >_
<"
* *v0.10.N*:
* Updated whitelist
* Use libkh (verbose logging if the linkjail/verbose file is present)
* *v0.11.N*:
* Deprecate the whole whitelist system (a fast autodetection method is u
sed instead)
**Fonts*:
* *v.3.2.N*:
* Make backups of the original files on the first boot
* If there's a script in linkfonts/bin/emergency.sh, run it and abort th
e hack on startup
* If there's a file in linkfonts/bin/prettyversion.txt, use it to overri
de the system's copy. (The original will be part of the backups)
* Use the DejaVu Sans font instead of the Free Sans font in the default
fonts set.
* Added some safety checks to abort the hack if we're missing a font. It
won't do a thing for fonts the Kindle Software doesn't happen to really like, t
hough...
* *v.3.3.N*:
* You won't have to uninstall/deactivate the hack in order to install of
ficial updates!
* Added the possibility to let the Kindle automatically soft-reboot when
switching fonts. It's now both safer & faster! (Check the detailed instructions
belox for the detail)
* And a bunch of tweaks in the scripts to make them safer. I don't remem
ber everything right now, there's a detailed ChangeLog in each zipfile for those
interested ;).
* *v3.4.N*:
* Fix a bug with the autoreboot feature, which would, occasionally, afte
r an update, go a bit crazy, and do *two* restarts instead of one. That upsets t
he Kindle for a while, but it ends up doing a full reboot ;).
* If you had a custom prettversion.txt, that wasn't update-safe. It's no
w fixed ;).
* *v3.5.N*:
* Use the system logger instead of pointless echo's to stdout. (That way
, it'll end up in the output of ;dumpMessages among other things).
* Avoid forking & parsing ls in some cases, when a shell glob can do the
job.
* *v3.6.N*:
* Fix a silly case sensitivity bug that prevented official OTA updates f
rom being trapped by the scripts.
* *v3.7.N*:
*
*
*
o copy it
* *v4.5.N*:
* Updated FT libs (new tc, updated ft)
* Updated fallback whitelist
* Updated binaries (new tc, updated fc)
* *v4.6.N*:
* update trap whitelisting bugfix
* *v4.7.N*:
*
ure of SS
*
*
Updated the USB watchdog to support the new shuffle on autoreboot feat
v0.23.N.
Updated FT libs (new tc, updated ft)
Updated binaries (new tc, updated fc)
* *v4.8.N*:
* Updated the USB watchdog to print a status bar on the bottom of the sc
reen when triggering an autoreboot.
* *v4.9.N*:
*
*
*
*
*
en setups
* *v5.0.N*:
* Added some more safety checks to avoid filling up a partition during i
nstall
*
*
*
*
* *v5.1.N*:
*
*
*
*
ool
* Dry-coded K4 support (completely untested, likely unsafe)
* *v5.2.N*:
*
*
*
*
* *v5.3.N*:
* Fixed a number of stupid bugs related to KF8/Fontconfig handling.
* *v5.4.N*:
* Removed the browser workaround, turns out it's unnecessary now that we
're doing stuff properly ;).
* Added the bci_new FT override (bci built without FT_CONFIG_OPTION_OLD_
INTERNALS). It might be more performant, but it might also be less compatible, e
specially on older devices/fw.
* Use the proper fontconfig config file in older K3 FW (<= 3.3).
* *v5.5.N*:
* Updated FT libs (new tc, updated ft)
* Updated binaries (new tc, updated fc)
**ScreenSavers*:
* *v0.5.N*:
* Reworked the script to use the same wonderful idea of bind mounts as t
he font hack. (And use a single script for everything, handling both the K2 & KD
X)
* Same system of backup/emergency/prettyversion as the font hack.
* A bit of safety check to avoid using an empty directory for the screen
savers
* *v0.6.N*:
* Same tweaks & updates as the Fonts hack.
* You now have the possibility to automatically randomize the order in w
hich your screensavers will be displayed. (Check the detailed instructions below
)
* *v0.7.N*:
* Fix the autoreboot feature when the fonts hack is not installed.
* *v0.19.N*:
* Updated sort binary (updated coreutils)
* Same fixes as the Fonts hack (update trap)
* *v0.20.N*:
* Updated fallback whitelist
* *v0.21.N*:
* Updated fallback whitelist
* Updated binaries (new tc, updated coreutils)
* *v0.22.N*:
* update trap whitelisting bugfix
* *v0.23.N*:
* You can now also shuffle your screensavers when an autoreboot is trigg
ered by the USB watchdog (check the first post for details).
* Updated binaries (new tc)
* *v0.24.N*:
* Updated the USB watchdog to print a status bar on the bottom of the sc
reen when triggering an autoreboot.
* *v0.25.N*:
*
*
*
en setups
*
* *v0.26.N*:
* Updated fallback whitelist
* Updated binaries (new tc, updated coreutils)
* Added some more safety checks to avoid filling up a partition during i
nstall
* *v0.27.N*:
* Updated binaries (new tc, updated coreutils)
* Updated fallback whitelist
* Build the packages with KindleTool : https://github.com/NiLuJe/KindleT
ool
* Beta, untested K4 support
* *v0.28.N*:
* Updated binaries (new tc, updated coreutils)
* K4 support
* *v0.29.N*: