Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Amazon Kindle > Kindle Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old 07-27-2012, 07:58 PM   #1
ixtab
(offline)
ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.
 
ixtab's Avatar
 
Posts: 2,907
Karma: 6736092
Join Date: Dec 2011
Device: K3, K4, K5, KPW, KPW2
Collections Manager

Version 2.8.1

Collections Manager offers a much more flexible way than the built-in one to manage Kindle Touch and Kindle PaperWhite collections.

Here's an (old) screenshot of what it looks like on a Kindle Touch with Firmware 5.1.x; the second picture is annotated with descriptions. The third picture shows the new entry format on a Kindle Paperwhite with Firmware 5.3.x, using the russian localization.

Click image for larger version

Name:	CollectionsManager.gif
Views:	29388
Size:	21.6 KB
ID:	98015Click image for larger version

Name:	CollectionsManager-Help.png
Views:	37857
Size:	149.1 KB
ID:	98013Click image for larger version

Name:	CM-new-ru.png
Views:	20991
Size:	22.6 KB
ID:	110506

Features:
  • Nest collections inside collections
  • Toggle Home Screen visibility of items
  • Synchronize collections with Calibre, using the Kindle Collections plugin.
  • Synchronize collections to the directory layout
  • ... and more

Requirements:
  • Kindle Touch: Firmware 5.1.0 - 5.3.7.3
  • Kindle Paperwhite: Firmware 5.2.0 - 5.4.4.2 (ATTENTION: See the note about FW >= 5.4.2 on the next line!)
  • Kindle Paperwhite 2: Firmware 5.4.0 - 5.4.2.1 & 5.4.3.1 - 5.4.5.1 & 5.6.5 (ATTENTION: On FW 5.4.0, everything works correctly. However, starting with FW 5.4.2, not all of the functionality is working correctly. See this, this, and most importantly THIS post for details).
  • Jailbreak
  • Mobileread Kindlet Kit

Installation:
Make sure that all requirements are met; download and extract the attached file, and copy the contained CollectionsManager.azw2 to the "documents" folder on the Kindle.

Troubleshooting:
Spoiler:
  • Collections Manager does not start, but you see a message like "Your Kindle is not authorized by the developer..."? => (re-)install the Mobileread Kindlet Kit.
  • Collections Manager starts, but only displays "Mobileread Kindlet Kit Required"? => (re-) install the Mobileread Kindlet Kit (duh! )
An MKK reinstallation is usually required when:
  • The registration status of your Kindle has changed, because that removes all developer certificates.
  • The firmware was updated.


Localization:
Spoiler:

Starting with version 1.1.2, this program can be localized. If you want to have the program display something else than the default english texts, download this file and save it as "CollectionsManager-localization.txt" on the Kindle. More instructions are contained in the file itself.

If you have created or updated the localization for a particular language, feel free to post it - I will either update the localization file (if the Kindle supports the language out-of-the-box), or make the translation available from this post (if the Kindle doesn't natively support the language).

Languages that should work out of the box on the Kindle if the localization file is available (incomplete translations are marked with "(~)"):
  • english
  • french (NiLuJe)
  • german (diba, ixtab)
  • italian (Mterry)(~)
  • portuguese (zamana, denydias)
  • spanish (cristbo, coolpable)(~)
The latest revision date of the official (=committed to the repository) localizations is 2014-01-30.


"Unofficial" support for other languages (these must replace the english texts) -- I can't guarantee anything for these translations, but I'll at least try to update this post to point to all of the contributions that were posted in this thread):If you have created a translation for an "unsupported" language, please post it in this thread. I will then link to it from this post.



Upgrade Notes:
Spoiler:

This is only relevant if you had installed version 1.x.x and are upgrading to version 2.x.x.
  • The filenames have slightly changed between version 1 and version 2. Please remove all KTCollectionsManager.* files from your Kindle, and keep only the CollectionsManager.* ones.
  • The filename for the localization has also changed. Similar to what was stated above, it is now CollectionsManager-localization.txt instead of KTCollectionsManager-localization.txt
  • Sorry for the inconvenience.


Version history / release announcements / change log:
Spoiler:


Acknowledgements:
Special thanks to the following people:
  • NiLuJe, for numerous suggestions and tips, for the calibre plugin patch, and much more!
  • rorogio, for the icons and the help screenshot
  • jangell2, for the help with tweaking the icons
  • all translators, for making CM accessible to people around the world
  • mhnotnot, for handling FW 5.4.3.2 & FW 5.4.4.2
  • ADambi, for handling FW 5.4.5.1, FW 5.4.4.2, FW 5.6.5; as well as search support in FW 5.4.4.2, FW 5.4.5, FW 5.6.5
  • everybody who contributed valuable feedback and suggestions
  • last but not least, everybody who donated to support CM development

Notes on Calibre Synchronization:
  • The Export function exports all collections which contain at least one "normal" item. However, it does not export the collection hierarchy (because Calibre does not support that).
  • The Import function will never remove collections; it will only update existing collections, or create new ones (visible in home by default). In particular, this means that after deleting collections from Calibre, you may also have to manually delete these collections from the Kindle.
  • Calibre Synchronization will never change the collection hierarchy, or the visibility of existing items. This applies to both import and export.

Other Notes:
  • To see which collections an item is contained in, either long-click it, or click on the indicator shown at the right.
  • Swipe up or down to "synchronize" the collections that are shown.
  • When using the "Create Collection" button, the newly created collection will be placed in the collection which is showing in the top pane.
  • Collection names must be unique. In other words: you can't have two collections with the same name. If you try to create a collection with a name that already exists, or try to rename a collection so that its name would conflict with another one, the operation will silently fail.
  • Fun fact 1: you can create infinite recursions, by including collection A in B and B in A
  • Fun fact 2: There is a little easter egg in the program which is triggered when you try to hide Collections Manager itself from the home screen and it (CM) hasn't been put into any collection. Try it out!
  • To integrate Collections Manager with the GUI Launcher or KUAL, and/or to actually hide Collections Manager from the Home Screen, see this post. Note that the launcher script has to be edited to use the correct filename (CollectionsManager.azw2, not KTCollectionsManager.azw2).
  • On 5.1.x Firmwares, the search bar disappears if the device enters sleep mode and wakes up again. There is no known workaround, but you could just actually use the device, so that it doesn't enter sleep mode ... or simply restart the application.
  • On *some* firmwares >= 5.2.0, the search functionality is not available.
  • On Firmwares >= 5.4.2, some functionality is unavailable (cf. the section about supported FW), and trying to maintain CM collections through the framework's UI instead of CM may lead to a soft deadlock.

Source code:
https://bitbucket.org/ixtab/ktcollectionsmgr/ & https://bitbucket.org/NiLuJe/ktcollectionsmgr/.

Totally Off-Topic:
Spoiler:


License, Redistribution and Links:
Collections Manager is released as Free and Open Source Software, under the terms of the Do What The Fuck You Want To Public License. You are free to share all Collections Manager files in whichever way you want. However, note that the links provided here are not necessarily stable. In other words: do not distribute direct download links to the files, but link to this post instead.

If you like Collections Manager:
I sincerely hope that you find this program useful. If you like the enhancements that it offers to your Kindle experience, you are more than welcome to donate a little something... but don't give your money to me. Please donate for a much more important cause, namely: for a Literacy project in Laos. You will make not only me happy. Thank you!



NEWER VERSIONS

As I'm not regularly updating this post anymore, it can be difficult to find versions that support newer firmwares (they're attached to various posts in this thread). Here's a wiki page that attempts to provide the downloads in one place. Please edit that page whenever you add a new version -- thanks!

==> DOWNLOADS
Attached Files
File Type: zip CollectionsManager_2.8.1.zip (590.1 KB, 15210 views)

Last edited by ixtab; 11-13-2017 at 06:49 AM. Reason: v2.8.1
ixtab is offline   Reply With Quote
Old 07-27-2012, 08:08 PM   #2
Titano
Definitely not King Kong
Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.Titano never is beset by a damp, drizzly November in his or her soul.
 
Titano's Avatar
 
Posts: 126
Karma: 59238
Join Date: Jul 2012
Location: United States
Device: Kindle Touch


Thank YOU!!! This is exactly what I have wanted since I got my kindle. Thanks so much.
Titano is offline   Reply With Quote
Old 07-27-2012, 11:31 PM   #3
TulseLuper
Connoisseur
TulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with others
 
TulseLuper's Avatar
 
Posts: 61
Karma: 2667
Join Date: Mar 2012
Device: kindle touch
Quote:
Originally Posted by Titano View Post


Thank YOU!!! This is exactly what I have wanted since I got my kindle. Thanks so much.
Say it´s real !!!! pleaaaaase !!!

heheheh going to test now on about 1700 itens library .

I can´t belive you Ixtab ! It´s beautifull !!

thanks !! really!!
TulseLuper is offline   Reply With Quote
Old 07-27-2012, 11:40 PM   #4
fefin
Junior Member
fefin began at the beginning.
 
Posts: 1
Karma: 10
Join Date: Jul 2012
Device: kindle
Thanks you! works fine for me
fefin is offline   Reply With Quote
Old 07-28-2012, 12:00 AM   #5
TulseLuper
Connoisseur
TulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with others
 
TulseLuper's Avatar
 
Posts: 61
Karma: 2667
Join Date: Mar 2012
Device: kindle touch
I have no words to say how up to the point you got here !

It´s perfect , even for the mostly graphic interface ! Is universal too !

wait for the amazon guys to see this heheheh ... .

Seems it is working quite smooth here , and my library is full til the neck ! Worked better than every single tool I´ve tried so far ! Congrats !

---

thinking about , it could a hint over those icos too

Last edited by TulseLuper; 07-28-2012 at 12:17 AM.
TulseLuper is offline   Reply With Quote
Old 07-28-2012, 12:42 AM   #6
dasmoover
Connoisseur
dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.dasmoover is not intimidated by interfenestral monkeys.
 
Posts: 84
Karma: 26720
Join Date: Mar 2011
Device: Kindle 3 WIFI
thank you, this is one of the most useful homebrewed feature
dasmoover is offline   Reply With Quote
Old 07-28-2012, 02:25 AM   #7
ixtab
(offline)
ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.
 
ixtab's Avatar
 
Posts: 2,907
Karma: 6736092
Join Date: Dec 2011
Device: K3, K4, K5, KPW, KPW2
Good to see that this is appreciated.

@TulseLuper: as to the hints, I have added a commented "help" screenshot to the first post...

Oh... woohoo! Thanks to a generous donor, I have now reached 100000 Karma!
ixtab is offline   Reply With Quote
Old 07-28-2012, 04:11 AM   #8
TulseLuper
Connoisseur
TulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with othersTulseLuper plays well with others
 
TulseLuper's Avatar
 
Posts: 61
Karma: 2667
Join Date: Mar 2012
Device: kindle touch
Quote:
Originally Posted by ixtab View Post
Good to see that this is appreciated.

@TulseLuper: as to the hints, I have added a commented "help" screenshot to the first post...

Oh... woohoo! Thanks to a generous donor, I have now reached 100000 Karma!
You deserves that !!!

Really great job ! And you got me those help screenshot! Please pack it up togheter with the azw will help a lot of people.

Now you have a trully Mayan Goddess's karma ! Namaste !
TulseLuper is offline   Reply With Quote
Old 07-28-2012, 04:53 AM   #9
KGS
Junior Member
KGS began at the beginning.
 
Posts: 3
Karma: 10
Join Date: Jul 2012
Device: Kindle Touch
thanks mate
KGS is offline   Reply With Quote
Old 07-28-2012, 09:50 AM   #10
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 13,477
Karma: 26012464
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
Awesome! Would an import/export feature be doable? Preferably in the 'usual' json collection format, that would make it able to be used with the calibre kindle collections plug in with a few tweaks ;-).

I'd take a look at the sources, but the git repo is private on bb ;-).
NiLuJe is offline   Reply With Quote
Old 07-28-2012, 10:44 AM   #11
ixtab
(offline)
ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.
 
ixtab's Avatar
 
Posts: 2,907
Karma: 6736092
Join Date: Dec 2011
Device: K3, K4, K5, KPW, KPW2
Quote:
Originally Posted by NiLuJe View Post
Awesome! Would an import/export feature be doable? Preferably in the 'usual' json collection format, that would make it able to be used with the calibre kindle collections plug in with a few tweaks ;-).
Hmmm... it sure is possible somehow. The problem is that physical entries (i.e., document files, and their sidecar entries) are an entirely different story again, and need to be treated completely differerently than collections. For instance, there is the full-text index, which indexes physical files.

While I did think about a whether a "two-way synchronization" could be done (and would have implemented it if it were sure to work), there is a reason why I only created an "import", but not an "export" feature: collections are completely "virtual", in the sense that they don't impact the file system in any way.
Providing an equivalent "export" option (sort of the "inverse function" of the import option) would modify files and directories all over the place, potentially leading to a complete misbehaviour of the Kindle (yes, I've seen it happen, by simply creating 1000 text files inside the documents folder).

Importing or exporting JSON is, of course, no problem at all. The problem is that changes to the filesystem (may) have a big impact on other components that I'm currently unable to control -- in fact, I don't even know which components are really involved.

Quote:
Originally Posted by NiLuJe View Post
I'd take a look at the sources, but the git repo is private on bb ;-).
Ooops... fixed . That was a glitch on my side, it's public now.
ixtab is offline   Reply With Quote
Old 07-28-2012, 11:52 AM   #12
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 13,477
Karma: 26012464
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
@ixtab: Err, not sure I was clear enough . Let's try again:

I was thinking specifically of importing/exporting just a simple json representation of the collections db, preferably in the same format used on previous Kindles (which is, AFAIU, still used on the Touch, only meshed with a sqlite db), not of reorganizing the documents FS layout to match the collections db . But since I have no idea how the Java side of this thing works, I'm not sure if/how it's possible . I'm guessing there should be something of the sort available, since it's more or less what the 'Import Collections From Another Device' vanilla feature does, I think, albeit maybe in XML instead of JSON (cf. KSP)...

Last edited by NiLuJe; 07-28-2012 at 12:02 PM.
NiLuJe is offline   Reply With Quote
Old 07-28-2012, 12:07 PM   #13
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 73,514
Karma: 126422064
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3
Is there any way to do this without jailbreaking?
JSWolf is offline   Reply With Quote
Old 07-28-2012, 12:19 PM   #14
ixtab
(offline)
ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.ixtab ought to be getting tired of karma fortunes by now.
 
ixtab's Avatar
 
Posts: 2,907
Karma: 6736092
Join Date: Dec 2011
Device: K3, K4, K5, KPW, KPW2
Quote:
Originally Posted by JSWolf View Post
Is there any way to do this without jailbreaking?
No.

You knew that before asking, didn't you?
ixtab is offline   Reply With Quote
Old 07-28-2012, 12:23 PM   #15
JSWolf
Resident Curmudgeon
JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.JSWolf ought to be getting tired of karma fortunes by now.
 
JSWolf's Avatar
 
Posts: 73,514
Karma: 126422064
Join Date: Nov 2006
Location: Roslindale, Massachusetts
Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3
Quote:
Originally Posted by ixtab View Post
No.

You knew that before asking, didn't you?
I was hoping someone had figure it out.
JSWolf is offline   Reply With Quote
Reply

Tags
collections, collections manager, kindle touch hacks

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Troubleshooting Books from collections are visible apart from the collections splitloop Amazon Kindle 3 07-08-2012 01:03 PM
ES File Explorer, Astro File Manager or File Manager HD? DreamWriter Android Devices 15 04-05-2012 03:00 PM
Importing Collections - Only original collections?? kuklachica Amazon Kindle 6 01-20-2012 03:39 PM
File manager and collections creator for PRS-505 igorsk Sony Reader 19 02-12-2009 05:02 PM


All times are GMT -4. The time now is 05:40 AM.


MobileRead.com is a privately owned, operated and funded community.