|
|
#1 |
|
THE NOOB
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 584
Karma: 1245625
Join Date: Jan 2012
Location: Italy
Device: Kindle Touch 5.3.2
|
Komic, a Kindle comic reader
![]() ****************COMPATIBILITY**************** The actual version (V2.2) works on Kindle Touch 5.3.2 and not on the previous firmwares. As regards Paperwhite, this is simple: I don't own a PW kindle, so I don't know if Komic works on it. If Paperwhite use the same mesquite thing, it should work. Anyway, I expect lots of GUI problems related to the different resolution. SHORT VERSION: KOMIC V2.1 (AND PREVIOUS) ==> KINDLE TOUCH 5.1.2 AND PREVIOUS KOMIC V2.2 ==> KINDLE TOUCH 5.3.2 (AND FOLLOWING, HOPEFULLY) *************************************** ****************README**************** This WAF is made to be integrated with GUI Launcher or with KUAL. You need to jailbreak your Kindle and to install the launcher or KUAL. If anyone wants to work on it and make it better, just post the results here for everyone. Old versions can be found here. I'm not responsible for bricks (I even don't know how they can happen, this WAF is safe), file deletions (once again, really unlikely) or any other problem. *************************************** ************HOW TO INSTALL************ 1. Plug your Kindle to your computer 2. Copy update_komic_*.install.bin directly onto the Kindle device (i.e., not into any sub-directory) 3. Restart your Kindle using Menu > Settings, Menu > Update. Please note that upgrading to a new version will keep your bookmarks and your Gallery folder. On the other hand, uninstalling will delete all Komic folder and Gallery folder. ************************************** *************HOW TO USE************** Just add your images in /documents/Gallery/ organized in folders and/or subfolders. You can also add CBZ and CBR files in /documents/Gallery/ and use the Decompress CBZs and CBRs feature (more info below). Images can be jpg, png, bmp, gif. For V2.1 and previous: You still have to use the rename script to rename images to match name pattern. If you don't do this, you won't find any comic in the list! Name pattern is 0,1,2,3.... Images can be jpg or png. ************************************** *********ANCILLARY FUNCTIONS********* DECOMPRESS CBZ AND CBR: run this script to decompress every CBZ and CBR file in /documents/Gallery/. This script creates a new folder with the same name as the CBZ/CBR, unpacks the archive, removes the archive and then runs RENAME FILES script. So, keep a copy of the archive on your PC if you want to store it. Images in CBZ/CBR can have any name pattern. Note that if CBZ/CBR contains a folder, you'll find this folder in the newly created folder. I.E: hello.cbr has a folder called world inside it (and pic.jpg is in world folder) ==> you'll find /documents/Gallery/hello/world/pic.jpg. Finally, note that big archives means long decompressing time (it runs at about 70Mb/minute). RENAME FILES: run this script to rename files in every folder in /documents/Gallery/ to match Komic name pattern. If the first file has already 0 as filename, the script skips that folder. DELETE SCHEDULED FOLDERS: run this script from the deletion page after scheduling folders to delete. You can schedule folders using the Schedule folders deletion function inside Komic (you can find it in menu). Once done, hit the run button. Note that this script removes also bookmarks related to scheduled folders. MOVE AND RENAME SCREENSHOTS: run this script to move screenshots from root folder of your Kindle to a folder called @Screenshots@ inside /documents/Gallery. They will be renamed using progressing numbers. This make possible to view screenshots from inside Komic. CHECK FOR UPDATES: run this script to check online for new versions of Komic. The scripts refers to this page on MobileRead. If a new version is found, the script asks the user if he wants to download it and, then, if he wants to update Komic. If you choose not to update Komic, you can still find the update package in the root of your Kindle (/mnt/us/) Follow on screen instructions to perform the update (aka press the HOME button of your Kindle when promped). Please note that this script doesn't download also the uninstall package so you have to download it manually if you want. Note also that this script needs a connection to the internet. ENABLE/DISABLE SOUNDS: run this script to enable/disable sounds in other scripts. SET THE MENU LANGUAGE: run this script to change the language of Komic's GUI launcher menu according to the framework language. Please check below for available languages. NOTE THAT EVERY SCRIPT SAVES A LOG IN /extensions/komic/resources/Logs. ************************************** *************OPTIONS************** AUTOSAVE: if ON, saves a bookmark whenever you return to Home or you change folder. AUTOJUMP: if ON, automatically jump to next folder when you reach the end of a folder. ZOOM BUTTONS: if ON, you can use two small transparent buttons to zoom in and zoom out when reading a comic. Check the attached images to locate the buttons. LANDSCAPE ROTATION: choose clockwise or anticlockwise rotation for landscape mode. IMAGE RATIO: if ON, Komic will maintain image aspect ratio while displaying images. If OFF, all images will be shown in full screen. REMEBER MODE: if ON, Komic will remember last orientation used (portrait or landscape) and brings the user to that orientation when opened. GO TO LAST READ: if ON, Komic will bring the user directly to the last read comic when opened. This means that you will be bringed to the furthest bookmark or, if not present, to the first page. COVER VIEW: enable this option to use a cover view page to select comics. Once inside cover view, tap on the bottom-left/bottom-right corner to zoom up/zoom down. Tap on a cover to zoom it then tap it again to open the comic or tap on the background to return to cover view. Tap on the header ("Cover view") to return to HOME. To provide a lightweight page, Komic creates thumbnails during the startup process. Thumbnails are created only once per comic and they are removed only when the corresponding comic is removed. This means that the startup process may take longer the first time (don't worry, wait for it!) and then every time you add some comics. If you disable cover view, the startup process will exclude the thumbnail part. LAUNCHER SOUNDS: use this option to enable/disable sounds. BACKGROUND COLOR: use this option to choose the color of the background when reading a comic. You can use presets color (White, Black, Gray) or you can choose your own color. Please refer to this page for color names. You can use either the color name or the HEX code (along with the #). REFRESH RATE: use this option to choose the number of pages between a full page refresh and another. ************************************** ***********OTHER FEATURES*********** AUTOMATIC PAGE TURNER: use this feature to enable the automatic page turner. Choose a time interval in seconds then tap OK (e.g 5sec). In portrait mode Komic will turn page every 5sec. In landscape mode Komic will scroll page every 5sec then, when reaching the end of the page, it will turn page. The number of scrolls if automatically calculated using the page height and the scroll amount. To stop the automatic page turner, please tap on the top of the screen to open menus. CHANGE CONTRAST AND BRIGHTNESS: use this feature to alter the contrast/brightness of pages. Contrast goes from -1 to 3. Brightness goes from -150 to 150. Please refer to this post for more information. Tap on the header of the contrast/brightness box ("Contrast") to close the box. TEXT-BASED CHOOSE-A-COMIC PAGE: use this page to choose which comic open. This page tries to replicate the folder structure in /documents/Gallery. If you have this structure: Code:
Gallery |--->Comic_1 |--->Comic_2 |--->Volume_1 |--->Volume_2 Code:
Comic_1 + Comic_2 Tap on the header ("Choose a comic") to return to HOME (or to the comic you were reading). ADJUST SCROLL: use this feature to choose the amount of scroll when in landscape mode. Use the slide bar to change the amount then close the box tapping on the header ("Choose the scroll amount"). The setting is stored even when Komic is closed. The preset value (277px) is the right amount for a three-strips comic page. COMIC INFO PAGE: use this feature to view the ComicInfo.xml file (if present) provided with the comic. You can see an example in the =README= folder or here. To use this feature, just drop the file in the comic folder! ************************************* *************LOCALIZATION************** Komic is now localizable (both the WAF itself and the GUI launcher menu). WAF localization is automatically done during startup according to the framework language. Komic GUI launcher menu localization needs to be done using the provided script. The fallback language is english. I can provide only italian and english language. If someone wants to help, please send me a PM. Anyway, as Komic uses lots of strings and messages, the localization file is quite huge. Availables languages: - italian - english (UK) *************************************** *************GENERIC INFO************** Please don't expect Komic to be fast in page turning if you want to: - turn page - adjust page dimension - keep aspect-ratio - change contrast/brightness every time. Also keep in mind that the bigger the image the slower the page turning. The same works for file sizes. *************************************** ************WELCOME PACK************* When installing or upgrading Komic from V2.2 on, you'll find a small =README= folder inside the Gallery folder. Open it with Komic to see a short changelog and a few infos on how to use Komic. You can delete it! ************************************ ************UPSTART SCRIPT************* From V2.2 Komic uses an upstart script to run an event launcher script. This is part of the communication system and proved to work fine. The upstart script is removed when uninstalling Komic. ************************************ ************STILL TO DO************* - bring back pinch-to-zoom ************************************ KOMIC V1.7 Spoiler:
KOMIC V1.8 Spoiler:
KOMIC V1.9 Spoiler:
KOMIC V2.0 Spoiler:
KOMIC V2.1 (FOR KINDLE TOUCH 5.1.2 AND PREVIOUS) Spoiler:
KOMIC V2.2 (FOR KINDLE TOUCH 5.3.2 AND FOLLOWING) Spoiler:
As I can't upload all screenshots in this post, please refer to this Flickr account! Last edited by silver18; 02-25-2013 at 04:30 AM. |
|
|
|
|
|
#2 |
|
Embedded Cheerleader
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 4,122
Karma: 3854695
Join Date: Feb 2012
Device: Intel 4004
|
Komic
Master and main index sections added, thread added to WAF index.
__________________
"Hack is just a four letter word." - - With apologies to B. Dylan |
|
|
|
|
Enthusiast
|
|
|
|
#3 |
|
Всё гениальное просто.
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 5,023
Karma: 6352591
Join Date: Nov 2011
Location: Щедрость не имеет пределов.
Device: *.*
|
So will "potshots" (from the comic book crowd, now that you renamed it to attract their attention).
__________________
This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
![]() |
|
|
|
|
|
#4 |
|
Connoisseur
![]() Posts: 54
Karma: 10
Join Date: Dec 2010
Device: K5
|
![]() Yay! I installed it already. I can't wait to try it out. Got a question that's been on my mind for a while. You said in the past to delete bookmarks once you're done with them to keep some file manageable. What happens if I delete a directory without removing the bookmarks? |
|
|
|
|
|
#5 |
|
Enthusiast
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 26
Karma: 654188
Join Date: Mar 2012
Device: Kindle Fire HD 8.9, Kindle Touch
|
I want to thank you for working on this. This is a great way for me to enjoy my large manga collection on my KT. It works great. Before this, I was converting things to mobi files. This is much more convenient and give a better result.
|
|
|
|
|
|
#6 |
|
Enthusiast
![]() Posts: 33
Karma: 10
Join Date: Apr 2012
Device: none
|
New version, new topic
ThanksA little suggestion: Can you make it auto-create bookmark when we quit? |
|
|
|
|
|
#7 |
|
THE NOOB
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 584
Karma: 1245625
Join Date: Jan 2012
Location: Italy
Device: Kindle Touch 5.3.2
|
When you delete a folder, the script deletes also the bookmark if present!!
As regards auto saving a bookmark, it could be done! Bookmark could be saved when you return home and/or change a folder. EDIT: Do you prefer to autosave bookmark only when returning home or also when changing folder? Last edited by silver18; 06-21-2012 at 05:50 AM. |
|
|
|
|
|
#8 |
|
Enthusiast
![]() Posts: 33
Karma: 10
Join Date: Apr 2012
Device: none
|
I think both would be perfect
|
|
|
|
|
|
#9 | |
|
Connoisseur
![]() Posts: 54
Karma: 10
Join Date: Dec 2010
Device: K5
|
Quote:
What does the rename script look at when it renames? I got some pretty weird behavior. The files were named 03_001, 03_002, etc. with the credits named as such. The credits were interspersed with the regular pages. Just a FYI. I'll be going back to Mangle to get my double pages automatically rotated. Such is life, huh? Still, great feature to add. Since CBZ/CBR support is uncompressing them on the Kindle, I might as well just do that on my PC--I'm not saving any space. Does that feature take up much space on the kindle? If so, maybe offer a Lite version? Just an idea--no need to have 2 versions if that's too difficult/unwieldy. so much for this. I get to use my touch for the reason I upgraded from my Sony Reader Pocket. Larger screen for manga!
|
|
|
|
|
|
|
#10 | |
|
THE NOOB
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 584
Karma: 1245625
Join Date: Jan 2012
Location: Italy
Device: Kindle Touch 5.3.2
|
Quote:
This time, I can't understand much... ![]() Folders delete script removes scheduled folders...I think that, once a folder is removed, than you don't need the related bookmark (if present), so the script removes also the bookmark. Rename script gets a list of folders in /documents/Gallery containing jpg, png, JPG, PNG. Than it gets, for every folder in that list, a list of files and it sorts the list based on the original filename. If the first file of this new list has 0 as filename, it skips that folder. I tried with a list of files named 03_001 to 03_200 and it worked. I can't understand this part: "with the credits named as such. The credits were interspersed with the regular pages". It would be helpful if you could send me a sample! As regards decompression, all the feature takes 170KB. I know it's a slow process...mounting the archive would be faster but I'm working on it. Anyway, I can't understand how this feature could save space. The minimum space required would be the size of the archive (if mounting it. As I'm decompressing it, the space taken is a little bit more). I can't get to use fewer space than the size of the archive! I added mainly because someone asked for it, and because copying CBR/CBZ to the Kindle is easier than decompressing them before copying folders. If I misunderstood anything, please let me know! |
|
|
|
|
|
|
#11 |
|
Connoisseur
![]() Posts: 54
Karma: 10
Join Date: Dec 2010
Device: K5
|
It did the 03_001, 03_002, etc fine. The credits were "credits1" "credits2" etc. I try and keep the scanlation group's credits pages. Instead of being at the end of the directory, the credit pages were irregularly inserted at the beginning
See attached picture for 1 chapter of a typical manga scanlation. I also included a zip file with the first 2 chapters from the title I saw doing this. It's annoying, to say the least. I didn't realize the resources to unzip were so small! I'd think they'd be in the megabyte range. |
|
|
|
|
|
#12 |
|
Junior Member
![]() Posts: 5
Karma: 12
Join Date: Jun 2012
Device: Kindle Touch 5.0.4
|
Hi silver18! Thank you very much for your hard work! I am really enjoying you app!
Could you please help me with these two files? Komic just creates empty folder after decompressing these archives. Thanks in advance. http://db.tt/Bcq9t8Gw http://db.tt/RyoYrjTV |
|
|
|
|
|
#13 | |
|
Embedded Cheerleader
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 4,122
Karma: 3854695
Join Date: Feb 2012
Device: Intel 4004
|
Quote:
If using Windows, change your preferences to display file extensions. That first name ends in: .cbz.zip But it isn't a zip of a zip (cbz) file - just rename it without the '.zip'. Look for a similar (Windows display) problem with the second.
__________________
"Hack is just a four letter word." - - With apologies to B. Dylan |
|
|
|
|
|
|
#14 | |
|
THE NOOB
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 584
Karma: 1245625
Join Date: Jan 2012
Location: Italy
Device: Kindle Touch 5.3.2
|
Quote:
I'm working on it!! @DRIVER733: both files are mis-named as knc1 stated above! |
|
|
|
|
|
|
#15 | |
|
Embedded Cheerleader
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() Posts: 4,122
Karma: 3854695
Join Date: Feb 2012
Device: Intel 4004
|
Quote:
T == Title V == Volume P == Page X == ? E == Extension Under-bar replacing spaces. File name: TT_TT_VVV_XXX.cbz Created directory name: TT_TT_VVV_XXX Cover name: TT_TTVVV_PP_XXX.jpg Page names: TT_TTVVV_PP_XXX.png So they do sort into page order before adding a leading page number. Adding a leading page number should not changing their sorted order. But you will have to sort them in your code (I admit, I didn't read your code to see if you are already doing that). You can't depend on the contents of the zip (cbz) or rar (cbr) to be in sorted order, the most common order will be "source directory order". Which may or may not be sorted. The unarchive process maintains the order of contents -> ctime order. FAT-32 does not have enough resolution in the time fields for this relationship to be useful. Programming languages "normally" return directory contents in directory order. Where "directory order" depends on the (in *nix) hashed value of the name. When looking at the directory contents from the command line: The *nix list (ls) command normally returns the names in sorted order. You have to pass the "-f" option to see the directory (hash) order. And if the list (ls) command on the Kindle is provided by Busybox, it may or may not be listing files in sorted order, it may or may not have an "-f" option. Translation: The order of the files returned by "ls" may not be the order your program sees them - you will have to sort them. - - - The Title field is "mixed" (bumpy) case and being written to a FAT-32 volume on Linux. So check the mount options of that USB storage area - The mount command without arguments shows what options current file systems have been mounted with: (non-Kindle, but a FAT-32 volume on Linux as an example) Code:
/dev/sde1 on /media/A80E-9247 type vfat (rw,nosuid,nodev,uid=1000,gid=1000,shortname=mixed,dmask=0077,utf8=1,showexec,flush,uhelper=udisks) The result of their choice of options may also have to be dealt with even though these are "long names". Edit: The names are bumpy case, the XXX is not. So a token of some kind? RHN == Right Hand Number == trailing volume number, trailing page number? I.E: Process string right to left, first character sequence describes where the page numbers are at in the string? With that information, then you know how to compute the file name of a page number. No sorting and renaming with a leading sequence number required. Duh... Just guessing. First digital comic book I have ever looked at - mine where on paper.
__________________
"Hack is just a four letter word." - - With apologies to B. Dylan Last edited by knc1; 06-22-2012 at 08:25 AM. |
|
|
|
|
![]() |
| Tags |
| launcher add-ons |
| Thread Tools | Search this Thread |
|
Similar Threads
|
||||
| Thread | Thread Starter | Forum | Replies | Last Post |
| Android Any Comic Reader App working ? | astrocity | enTourage Archive | 38 | 03-01-2011 12:23 PM |
| iPad Good comic reader for iPad? | jocampo | Apple Devices | 5 | 02-24-2011 06:36 AM |
| SmartQ V7 comic reader help | Renji | Alternative Devices | 21 | 12-15-2009 10:05 PM |
| Macintosh Comic Reader and PDF creator now available :) | grayfox | iRex | 3 | 01-03-2008 05:06 PM |