Thread: K5 Collections Manager
View Single Post
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,903
Karma: 6677485
Join Date: Dec 2011
Device: K3, K4, K5, KPW, KPW2
Collections Manager

Version 2.7.4

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:	13180
Size:	21.6 KB
ID:	98015Click image for larger version

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

Name:	CM-new-ru.png
Views:	6313
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.2
  • Kindle Paperwhite: Firmware 5.2.0 - 5.3.9
  • Kindle Paperwhite 2: Firmware 5.4.0 - 5.4.2.1 & 5.4.3.1 - 5.4.5.1 (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
  • ADambi, for handling FW 5.4.5.1
  • 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 Firmwares >= 5.2.0, the search functionality is not available.

Source code:
https://bitbucket.org/ixtab/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!
Attached Files
File Type: zip CollectionsManager_2.7.4.zip (557.6 KB, 463 views)

Last edited by NiLuJe; 08-29-2014 at 03:28 PM. Reason: v2.7.4
ixtab is offline   Reply With Quote