Read Me

Use apkFileManager to catalog and organize your (legally* obtained) apk file collection on your computer.

First, your friendly warning message:
-------------------------------------
DRAGONS AHEAD. THIS PROGRAM IS STILL IN DEVELOPMENT.
I CAN NOT BE HELD RESPONSIBLE FOR ANY KIND OF DATA LOSS, IN WHATEVER WAY.
THIS TOOL MODIFIES FILES ON YOUR COMPUTER AND IT IS WISE TO ALWAYS HAVE A BACKUP OF THE DATA BEFORE DOING ANY OPERATION.
YOU HAVE BEEN WARNED.
-------------------------------------

The aapt executable from the android SDK is needed for the program to function properly.
A place to get it would be at:
   http://code.google.com/p/android-apktool/downloads/list

and get the file named:
   apktool-install-windows-r05-ibot.tar.bz2
for the Windows binary.

This program is portable, everything is kept in one folder.
Just unzip and you're ready to go!

I created this little tool because I keep a backup on the computer with my installed and purchased apk files.
It didn't take long and this folder to become cluttered with multiple old versions for each App and non-properly named files.
So I searched for an program that will be able to organize this mess.
I found only basic apk file renamers that were either basic scripts or either needed java or .net installed, and only use the build-in information from each apk file.
So, I sat down and started to write a program which could organize my collection a little better.


Features:

 - Reads apk's from a directory and extracts icon and basic information about them, with the help of aapt.
 - Gets Google Play Store details and descriptions for all apk's that are in the Store.
 - View Screenshots from Google Play Store (If Play Store details have been retrieved).
 - Move older versions of apk's to another folder so you can inspect them and remove them.
 - Rename files by using a custom renaming mask.
 - Batch rename apk's using a mask.
 - Move files automatically to subfolders named from the official Google Play Store categories.
 - Preview file rename/move operation.


Version History:
0.6.7 (2012-12-24):
  Major Changes:
    - New Ribbon Layout on main window. Can be reverted to classic menu on the Options tab.
    - Due to the large amount of small files piling up in the Screenshot directory after viewing a lot of app screenshots,
      as of version 0.6.7, these files will be stored from now on in a separate database file (Screenshots.db3), like the app icons.
      The existing Screenshot directory will be migrated to the new database file.
  Changes:
    - Changed iconset from FamFamFam to Fatcow.
    - Improved program startup time.
    - Main Window: View Screenshots Button gets disabled if you haven't retrieved Google Play Infos for the app.
    - Multi Rename Window: Unchecked apps are greyed out.
  New Features:
    - Main Window: Added Delete apk file function.
    - Main Window: Added option to enable/disable alternate row colors.
    - App Details Window: Implemented Right-Click Menu on App description, on selected text and links.
    - Multi Rename Window: Added Progress Bar when rename operation starts.
    - Multi Rename Window: Manual edit of filenames. Click on the filename or press F2 to rename. Changes on the filenames are lost if you change the filter settings from above.
    - Screenshot Window: Added 1:1 and zoomed in view buttons on the lower right region of the image.
  Bugfixes:
    - Main Window: Duplicate/Old file status column indicator now only checks inside the working directory, as it should be.
    - App Details Window: You can now scroll up/down the text with the mouse wheel on App description.
  Known Bugs:
    - Unicode .apk file names or folders cannot be reconized yet. Suggested solution is to rename them to standard ascii, until I'll solve this problem.

0.5.9 (2012-11-28):
  New Features:
    - Added Select All/None checkbox on Mass Rename form.
    - Rows are now displayed with alternate colors.
    - If a file cannot be recognized, a message appears.
  Bugfixes:
    - Fixed App detail Hint on main window not showing correct information, when table order is changed.
    - Fixed sorting of the File Size column on main window.
  Changes:
    - Using Natural sorting on tables.

0.5.8 (2012-10-26):
  New Features:
    - Added Screenshot Image Rotation (Rotation is performed lossless on jpeg images with jpegtran).
  Some minor bugfixes.
  Screenshot thumbnails are now generated for faster preview.

0.5.7 (2012-09-18):
  New Features:
    - In screenshot window, click on image for zoomed view.
  Bugfixes:
    - Getting screenshots from Play Store works again.

0.5.6 (2012-09-06):
  New Features:
    - When hovering over the "Open Google Play Store" link in App Details window, the QR Code of the link is displayed on the icon.
    - When renaming, added an option to remove non-ascii characters from filename.
    Bugfixes:
    - If the apkName or googleName contained a slash character, the app would be moved into the wrong directory.

0.5.5 (2012-08-08):
  New Feature:
    - Added checkbox to Multi Rename Window, so you can uncheck files you don't want to rename.

0.5.4 (2012-08-05):
  Fixed 2 bugs:
    #1  Program freeze upon clicking "include subdirs".
    #2  Division by zero on Win7 x64 when clicking Get Google App Infos.

0.5.3 (2012-08-02):
  First public release.


Mask Renaming mechanism explained:

the following masks are supported:

%filename%      = Original File Name
%apkname%       = APK Name
%apkversion%    = APK Version
%apkrevision%   = APK Revision
%apkpackage%    = APK Package Name
%googlename%    = Google Play Name (If nonexistent, APK Name will be used)
%googlemaincat% = Google Play Main Category (If nonexistent, the word 'Uncategorized' will be used)
%googlesubcat%  = Google Play Subcategory (If there is a main category but no subcategory, the word 'Uncategorized' will be used, else it will remain blank)

For example:
Let's say you have a backup from the popular game Angry Birds v2.0. You have the game named as 'angry_birds.apk' in a folder 'D:\Android\files'.

Setting the rename mask to: '%googlename% %apkversion%', and the destination folder to 'D:\Android\Sorted'

the file will be renamed/moved
    from:  D:\Android\files\angry_birds.apk
      to:  D:\Android\Sorted\Angry Birds 2.0.0.apk

A more advanced example:
You have the same file as above, 'D:\Android\files\angry_birds.apk', and you also have retrieved Google Play Store information for this file.
Now you have more flexible choices:
Set the file rename mask to: '%googlemaincat%/%googlesubcat%/%googlename% %apkversion%', and the destination folder to 'D:\Android\Sorted'

the file will be renamed/moved
    from:  D:\Android\files\angry_birds.apk
      to:  D:\Android\Sorted\Games\Arcade & Action\Angry Birds 2.0.0.apk

with that, you can instantly organize your apps into the categories the Google Play Store displays them.




Acknowledgements:
Application Icon from http://tempest.deviantart.com/#/d36uwz0
Icons from Fatcow Free Icon Set (http://www.fatcow.com/free-icons)

OpenSSL Libraries:
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).



* I do not endorse piracy in any way.