Kindle README
Kindle README
Kindle README
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!
{
"library_view books view state": {
"column_positions": {
"last_modified": 10,
"languages": 11,
"series": 7,
"rating": 5,
"tags": 6,
"size": 4,
"publisher": 8,
"authors": 2,
"pubdate": 9,
"title": 1,
"timestamp": 3,
"ondevice": 0
},
"sort_history": [
[
"timestamp",
false
]
],
"column_sizes": {
"last_modified": 0,
"languages": 0,
"rating": 70,
"tags": 58,
"size": 90,
"publisher": 89,
"authors": 103,
"pubdate": 92,
"title": 214,
"timestamp": 84,
"series": 69
},
"languages_injected": true,
"column_alignment": {
"pubdate": "center",
"timestamp": "center",
"size": "center"
},
"hidden_columns": [
"last_modified",
"languages"
],
"last_modified_injected": true
},
"news_to_be_synced": [],
"gui_view_history": [
[
6,
"How to Write the Perfect Personal Statement (Peterson's Perfect Personal
Statements)"
],
[
5,
"How to Get Into the Top MBA Programs, 5th Edition"
],
[
3,
"mahabharata-sanskrit-hindi-01-gitapress"
],
[
2,
"Hindi Book-Mahabharat Part-1"
]
],
"user_categories": {},
"saved_searches": {},
"field_metadata": {
"comments": {
"is_multiple": {},
"rec_index": 7,
"is_custom": false,
"is_category": false,
"name": "Comments",
"is_editable": true,
"table": null,
"label": "comments",
"datatype": "text",
"column": null,
"search_terms": [
"comments",
"comment"
],
"kind": "field",
"display": {},
"is_csp": false
},
"series_index": {
"is_multiple": {},
"rec_index": 10,
"is_custom": false,
"is_category": false,
"name": null,
"is_editable": true,
"table": null,
"label": "series_index",
"datatype": "float",
"column": null,
"search_terms": [
"series_index"
],
"kind": "field",
"display": {},
"is_csp": false
},
"news": {
"is_multiple": {},
"is_custom": false,
"is_category": true,
"name": "News",
"is_editable": true,
"table": "news",
"label": "news",
"datatype": null,
"column": "name",
"search_terms": [],
"kind": "category",
"display": {},
"category_sort": "name",
"is_csp": false
},
"size": {
"is_multiple": {},
"rec_index": 4,
"is_custom": false,
"is_category": false,
"name": "Size",
"is_editable": true,
"table": null,
"label": "size",
"datatype": "float",
"column": null,
"search_terms": [
"size"
],
"kind": "field",
"display": {},
"is_csp": false
},
"authors": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": "&",
"list_to_ui": " & "
},
"rec_index": 2,
"is_custom": false,
"is_category": true,
"name": "Authors",
"is_editable": true,
"table": "authors",
"link_column": "author",
"label": "authors",
"datatype": "text",
"column": "name",
"search_terms": [
"authors",
"author"
],
"kind": "field",
"display": {},
"category_sort": "sort",
"is_csp": false
},
"pubdate": {
"is_multiple": {},
"rec_index": 15,
"is_custom": false,
"is_category": false,
"name": "Published",
"is_editable": true,
"table": null,
"label": "pubdate",
"datatype": "datetime",
"column": null,
"search_terms": [
"pubdate"
],
"kind": "field",
"display": {
"date_format": "MMM yyyy"
},
"is_csp": false
},
"au_map": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": null,
"list_to_ui": null
},
"rec_index": 18,
"is_custom": false,
"is_category": false,
"name": null,
"is_editable": true,
"table": null,
"label": "au_map",
"datatype": "text",
"column": null,
"search_terms": [],
"kind": "field",
"display": {},
"is_csp": false
},
"author_sort": {
"is_multiple": {},
"rec_index": 12,
"is_custom": false,
"is_category": false,
"name": "Author Sort",
"is_editable": true,
"table": null,
"label": "author_sort",
"datatype": "text",
"column": null,
"search_terms": [
"author_sort"
],
"kind": "field",
"display": {},
"is_csp": false
},
"rating": {
"is_multiple": {},
"rec_index": 5,
"is_custom": false,
"is_category": true,
"name": "Rating",
"is_editable": true,
"table": "ratings",
"link_column": "rating",
"label": "rating",
"datatype": "rating",
"column": "rating",
"search_terms": [
"rating"
],
"kind": "field",
"display": {},
"category_sort": "rating",
"is_csp": false
},
"uuid": {
"is_multiple": {},
"rec_index": 16,
"is_custom": false,
"is_category": false,
"name": null,
"is_editable": true,
"table": null,
"label": "uuid",
"datatype": "text",
"column": null,
"search_terms": [
"uuid"
],
"kind": "field",
"display": {},
"is_csp": false
},
"tags": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": ",",
"list_to_ui": ", "
},
"rec_index": 6,
"is_custom": false,
"is_category": true,
"name": "Tags",
"is_editable": true,
"table": "tags",
"link_column": "tag",
"label": "tags",
"datatype": "text",
"column": "name",
"search_terms": [
"tags",
"tag"
],
"kind": "field",
"display": {},
"category_sort": "name",
"is_csp": false
},
"timestamp": {
"is_multiple": {},
"rec_index": 3,
"is_custom": false,
"is_category": false,
"name": "Date",
"is_editable": true,
"table": null,
"label": "timestamp",
"datatype": "datetime",
"column": null,
"search_terms": [
"date"
],
"kind": "field",
"display": {
"date_format": "dd MMM yyyy"
},
"is_csp": false
},
"path": {
"is_multiple": {},
"rec_index": 14,
"is_custom": false,
"is_category": false,
"name": "Path",
"is_editable": true,
"table": null,
"label": "path",
"datatype": "text",
"column": null,
"search_terms": [],
"kind": "field",
"display": {},
"is_csp": false
},
"title": {
"is_multiple": {},
"rec_index": 1,
"is_custom": false,
"is_category": false,
"name": "Title",
"is_editable": true,
"table": null,
"label": "title",
"datatype": "text",
"column": null,
"search_terms": [
"title"
],
"kind": "field",
"display": {},
"is_csp": false
},
"series_sort": {
"is_multiple": {},
"rec_index": 24,
"is_custom": false,
"is_category": false,
"name": "Series Sort",
"is_editable": true,
"table": null,
"label": "series_sort",
"datatype": "text",
"column": null,
"search_terms": [
"series_sort"
],
"kind": "field",
"display": {},
"is_csp": false
},
"last_modified": {
"is_multiple": {},
"rec_index": 19,
"is_custom": false,
"is_category": false,
"name": "Modified",
"is_editable": true,
"table": null,
"label": "last_modified",
"datatype": "datetime",
"column": null,
"search_terms": [
"last_modified"
],
"kind": "field",
"display": {
"date_format": "dd MMM yyyy"
},
"is_csp": false
},
"languages": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": ",",
"list_to_ui": ", "
},
"rec_index": 21,
"is_custom": false,
"is_category": true,
"name": "Languages",
"is_editable": true,
"table": "languages",
"link_column": "lang_code",
"label": "languages",
"datatype": "text",
"column": "lang_code",
"search_terms": [
"languages",
"language"
],
"kind": "field",
"display": {},
"category_sort": "lang_code",
"is_csp": false
},
"id": {
"is_multiple": {},
"rec_index": 0,
"is_custom": false,
"is_category": false,
"name": null,
"is_editable": true,
"table": null,
"label": "id",
"datatype": "int",
"column": null,
"search_terms": [
"id"
],
"kind": "field",
"display": {},
"is_csp": false
},
"publisher": {
"is_multiple": {},
"rec_index": 9,
"is_custom": false,
"is_category": true,
"name": "Publisher",
"is_editable": true,
"table": "publishers",
"link_column": "publisher",
"label": "publisher",
"datatype": "text",
"column": "name",
"search_terms": [
"publisher"
],
"kind": "field",
"display": {},
"category_sort": "name",
"is_csp": false
},
"marked": {
"is_multiple": {},
"rec_index": 23,
"is_custom": false,
"is_category": false,
"name": null,
"is_editable": true,
"table": null,
"label": "marked",
"datatype": "text",
"column": null,
"search_terms": [
"marked"
],
"kind": "field",
"display": {},
"is_csp": false
},
"identifiers": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": ",",
"list_to_ui": ", "
},
"rec_index": 20,
"is_custom": false,
"is_category": true,
"name": "Identifiers",
"is_editable": true,
"table": null,
"label": "identifiers",
"datatype": "text",
"column": null,
"search_terms": [
"identifiers",
"identifier",
"isbn"
],
"kind": "field",
"display": {},
"is_csp": true
},
"formats": {
"is_multiple": {
"cache_to_list": ",",
"ui_to_list": ",",
"list_to_ui": ", "
},
"rec_index": 13,
"is_custom": false,
"is_category": true,
"name": "Formats",
"is_editable": true,
"table": null,
"label": "formats",
"datatype": "text",
"column": null,
"search_terms": [
"formats",
"format"
],
"kind": "field",
"display": {},
"is_csp": false
},
"sort": {
"is_multiple": {},
"rec_index": 11,
"is_custom": false,
"is_category": false,
"name": "Title Sort",
"is_editable": true,
"table": null,
"label": "sort",
"datatype": "text",
"column": null,
"search_terms": [
"title_sort"
],
"kind": "field",
"display": {},
"is_csp": false
},
"series": {
"is_multiple": {},
"rec_index": 8,
"is_custom": false,
"is_category": true,
"name": "Series",
"is_editable": true,
"table": "series",
"link_column": "series",
"label": "series",
"datatype": "series",
"column": "name",
"search_terms": [
"series"
],
"kind": "field",
"display": {},
"category_sort": "(title_sort(name))",
"is_csp": false
},
"cover": {
"is_multiple": {},
"rec_index": 17,
"is_custom": false,
"is_category": false,
"name": "Cover",
"is_editable": true,
"table": null,
"label": "cover",
"datatype": "int",
"column": null,
"search_terms": [
"cover"
],
"kind": "field",
"display": {},
"is_csp": false
},
"ondevice": {
"is_multiple": {},
"rec_index": 22,
"is_custom": false,
"is_category": false,
"name": "On Device",
"is_editable": true,
"table": null,
"label": "ondevice",
"datatype": "text",
"column": null,
"search_terms": [
"ondevice"
],
"kind": "field",
"display": {},
"is_csp": false
}
},
"bools_are_tristate": true,
"tag_browser_hidden_categories": [],
"grouped_search_terms": {}
}
*Latest Updates (08/19/2015):*
JB v0.13.N, SS v0.47.N, Python 0.14.N, Fonts v5.16.N, USBNet v0.57.N (Updated bi
naries).
*INSTALL:*
*Jailbreak:*
*What Does It Do?:*
The JailBreak opens the door to pretty much everything you'll find on this forum
;).
As for USBNetwork, besides bundling a couple of useful tools, it will grant you
remote shell access to your Kindle, be it over USB or WiFi.
*Note for Kindle 4 Users*
Please skip this section and refer to the Wiki : http://wiki.mobileread.com/wiki
/Kindle4NTHacking#Jailbreak instead.
*ScreenSavers:*
*What Does It Do?:*
This will allow you to customize the screensavers (or sleep screens) used by you
r Kindle, replacing them either with your choice of images or the cover of the l
ast book you opened ;).
Download the attached kindle-ss-0.47.N.zip file, and unpack it. In here, you'll
find a few files.
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.47.N_k4_install.bin* for exampl
e.
Now, eject & unplug your Kindle, and go to *[HOME] -> [MENU] > Settings -> [MENU
] > Update Your Kindle*. It should take a couple dozen of seconds.
Note that if you have KUAL : http://www.mobileread.com/forums/showthread.php?t=2
03326 set up and running, you're welcome to use our very own MR Package Installe
r : http://www.mobileread.com/forums/showthread.php?t=251143, which may speed up
the process if you're installing multiple things ;).
Once your device is back to your Homescreen, check that everything went fine by
putting your Kindle to sleep: on a fresh install, you should now see a special s
creensaver to confirm that the installation was successful ;). Carry on if you d
o, otherwise, check the FAQ at the bottom of this message.
You now have a couple of choices to make:
Do you want to use the cover of the last book opened as a screensaver? Make sure
you've installed the Python package first, then just drop a blank file named *c
over* in the linkss folder. Restart your Kindle (*[HOME] -> [MENU] > Settings ->
[MENU] > Restart*), and you're done :).
A couple of things to note on this mode: It's only available since *v0.31.N*, an
d if you don't rely on the autoreboot feature for third-party tools (Calibre?),
the autoreboot feature is probably useless to you in this mode, so you should al
so delete the *autoreboot* file in the linkss folder.
If you simply want to use a set of custom screensavers, like usual, keep on read
ing :).
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 when 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 restart your Kindle (either through the autore
boot feature, or a full restart).
*Since v0.35.N:* All of these settings are now available in a friendly *KUAL* :
http://www.mobileread.com/forums/showthread.php?t=203326 menu :). Running at lea
st KUAL 2.1 is recommended for the best user experience.
*Fonts:*
*What Does It Do?:*
This will allow you to customize the fonts used by your Kindle, be it in books,
or the UI, and optionally grant you deeper control over the font rendering engin
e.
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.16.N.zip file for your device (the K2, K
2I, DX, DXI and DXG packages are in the kindle-fonts-5.16.N-k2.zip archive, the
K3G, K3W and K3GB packages are in the kindle-fonts-5.16.N-k3.zip archive, and th
e K4 packages are in the kindle-fonts-5.16.N-k4.zip archive), and unpack it. In
here, you'll find a few files.
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.16.N_k2i_install.bin
* for example.
Now, eject & unplug your Kindle, and go to *[HOME] -> [MENU] > Settings -> [MENU
] > Update 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 minu
te or two on the "Update successful, Your Kindle is restarting " screen, that's okay
.
Note that if you have KUAL : http://www.mobileread.com/forums/showthread.php?t=2
03326 set up and running, you're welcome to use our very own MR Package Installe
r : http://www.mobileread.com/forums/showthread.php?t=251143, which may speed up
the process if you're installing multiple things ;).
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 ;).
*v5.8.N:* Removal of the bci_new override (if you're currently using it, the ins
taller will migrate your config to bci). Basically, what differentiated it from
bci is now enabled by default for all three variants. I haven't encounterd any i
ssues yet, but if you suddenly experience severe rendering issues after this upd
ate, contact me!
*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 ;).
*Since v5.8.N:* All of these settings are now available in a friendly *KUAL* : h
ttp://www.mobileread.com/forums/showthread.php?t=203326 menu :). Running at leas
t KUAL 2.1 is recommended for the best user experience.
*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
*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)
* *v0.12.N*:
* Update binaries
* *v0.13.N*:
* Update binaries
**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*:
* Don't trap update files from our own hacks
* Log to syslog during install & uninstall updates
* The linkfonts folder is now installed by the update binfile! No need t
o copy it manually anymore.
And if you're already using custom content, it won't be overwritten,
allowing you to keep your choice of fonts and/or screensavers when updating the
hacks.
Both this thread and the Wiki have been updated to reflect this chan
ge, simplifying a bit the install & update process.
* *v3.8.N*:
* Works on firmware v3.x.
* FW 3.x only: Customizing the browser fonts adds a certain overhead to
the font switching process (it'll most likely take a few minutes during boot or
before a framework restart)
if you have updated your fonts. Moreover, the Kindle FW now makes us
e of TrueType hinting instructions. That tends to make fonts not having TT hinti
ng instructions (or crappy ones)
fuzzier than they looked on a K2. That is especially marked with sma
ll font sizes and with the browser. In order to let the browser use the default
fonts, to both be sure you'll have readable fonts, and
to avoid the overhead when switching fonts, create a blank "nobrowse
r" file in the linkfonts directory. All this is explained in a bit more details
in the install instructions.
*NOTE*: Because it really takes a *long* time to regenerate fontconf
ig's cache, the "nobrowser" feature in *enabled by default*.
* *v3.9.N*:
* FW 3.x: Added a different font config file that replaces the "condense
d" font with the original serif (Caecilia). To enable this, drop a blank "nocond
ensed" file in the linkss folder.
* Update the CJK.ttf font (Droid Fallback). Supports even more Chinese g
lyphs.
* The install script now correctly upgrades default custom fonts.
* Move pid & lock files in a dedicated folder (run) to unclutter the bin
folder.
* Move all the config files to a dedicated folder (etc). The bin folder
now really only contains binaries.
* *v4.0.N*:
* Tweak the usb watchdog a bit to avoid false-positives, and implement a
proper locking mechanism to avoid race conditions.
* Whitelist font_pkg & duokan update files (don't trap them).
* Update the fc-scan binary (updated FontConfig & TC).
* New feature: you can now override the FreeType library used to render
fonts, in order for example to force the usage of FT's
autohinter, to get a rendering resembling that of FW 2.x. Check the
post for more details.
* Fix the fontconfig config generation to properly take all styles into
account, while still avoiding multiple entries for the same font family.
* And, actually, fix the fontconfig cache generation, too. (Stupid mista
ke that would break this on vanilla Kindles )
* Properly check if the hack is already applied instead of the usual wor
karounds to avoid double mounts.
* A few code cleanups.
* *v4.1.N*:
* A tiny code cleanup.
* Support light FT hinting (override)
* Fix the FW 3.x browser when using an FT override.
* *v4.2.N*:
* Only use the FT override + FW 3.x browser fix when we're actually usin
g an FT override on FW 3.x.
* Updated FT libs (updated ft)
* *v4.3.N*:
* Updated FT libs (updated ft)
* Updated fc-scan binary (updated fc)
* Use the new jailbreak whitelist to check wether of not we want to trap
an update file.
* *v4.4.N*:
* Updated FT libs (updated ft)
* Fix the rendering issues encountered with the 'light' ft override in t
he Symbols popup, Note edit popup and address bars.
* Updated fallback whitelist
* *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*:
* Updated the USB watchdog to support the new shuffle on autoreboot feat
ure of SS 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*:
* Updated FT libs (new tc, updated ft)
* Updated binaries (new tc, updated fc)
* Use libkh (verbose logging if the linkfonts/verbose file is present)
* Always use verbose logging when using the browser feature on FW 3.x
* Add some more failsafes around the USB watchdog when dealing with brok
en setups
* *v5.0.N*:
* Added some more safety checks to avoid filling up a partition during i
nstall
* Updated FT libs (new tc, updated ft)
* Updated fallback whitelist
* Updated binaries (new tc, updated fc)
* Update the CJK.ttf font (Droid Fallback)
* *v5.1.N*:
* *v5.11.N*:
* Slightly prettier verbose mode
* Updated binaries (new tc, updated ft & fc)
* *v5.12.N*:
* Updated binaries (new tc, updated ft & fc)
* *v5.13.N*:
* Updated binaries (new tc, updated ft & fc)
* *v5.14.N*:
* Updated binaries (new tc, updated ft & fc)
* *v5.15.N*:
* Updated binaries (new tc, updated ft & fc)
* *v5.16.N*:
* Updated binaries (new tc, updated ft & 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*:
* Same bugfixes as the Fonts hack.
* *v0.8.N*:
* Same new featured/bug fixes as the Fonts hack (system logging, less fo
rking).
* Fix a bug with the screensavers randomizing (and possibly the set up o
f the hack in itself, if you're really unlucky) when your screensavers have spac
es or special characters in their filenames.
* In the same vein, fix a bug with some safety checks when using the ran
dom feature.
* *v0.9.N*:
* *v0.14.N*:
* Use a dynamically linked sort binary. (To save a bit of space).
* Same changes as the Fonts hack (config & pidfiles moved).
* *v0.15.N*:
* Properly detect the screen size instead of trying every size possible.
(Avoid an useless mount).
* *v0.16.N*:
* Same fixes as the Fonts hack (update trap, usb watchdog, cleanups, mou
nt checks).
* Updated sort binary (updated coreutils & TC).
* *v0.17.N*:
* Fixed a confusing install log message
* Updated sort binary (updated coreutils)
* *v0.18.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*:
* Updated binaries (new tc, updated coreutils)
* Use libkh (verbose logging if the linkss/verbose file is present)
* Add some more failsafes around the USB watchdog when dealing with brok
en setups
* Simplify the zero-padding code when shuffling screensavers
* *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*:
* Resync watchdog with Fonts v5.3.N
* *v0.30.N*:
* Updated binaries (new tc)
* *v0.31.N*:
* Implement a new setting: use the cover of the last book opened as the
screensaver! (Drop a blank *cover* file in the linkss folder to enable this mode
)
* *v0.32.N*:
* New KUAL extension (at the time of release, requires the development v
ersion of KUAL)
* Tweaked the processing settings a bit to play nice with the new ImageM
agick build. Possibly a bit faster.
* Try harder to not break the cover mode under some circumstances
* Made the extra workaround for the first sleep cycle in cover mode conf
igurable (if you sometimes see a broken/innacurate cover on the first sleep cycl
e after a book switch, drop a blank *sleep* file in the linkss folder to enable
this workaround).
* Updated binaries (updated tc, everything)
* *v0.36.N*:
* Made the default & fallback image in cover mode a bit more helpful tha
n a blank screen.
* *v0.37.N*:
* Optimized cover mode behavior, IO wise.
* *v0.38.N*:
* Updated binaries (updated tc)
* Tweaked how the cover images are dithered down (now properly use the e
Ink palette of 16 shades of grey).
* Reduced memory consumption of the cover processing, now less likely to
blow up the framework on DX/DXG devices.
* In the same spirit, added more settings to control the dithering proce
ss (none/FloydSteinberg/Riemersma).
* The KUAL extension now properly detects the Kindle DX models when show
ing device-specific buttons with the latest KUAL development snapshots.
* *v0.39.N*:
* Updated binaries (updated tc)
* *v0.40.N*:
**Python*:
* *v0.1.N*:
* First release.
* *v0.2.N*:
* Updated binaries (new tc)
* *v0.3.N*:
* Updated binaries (updated tc)
* *v0.4.N*:
* Updated binaries (updated tc, update to Python 2.7.5)
* *v0.5.N*:
* Updated binaries (updated tc, updated Python 2.7.5 patchset to fix pot
ential issues with the re module)
* *v0.6.N*: