Koll3ctions Files

==========================================================================
File  : 'readme.txt' - Info about Koll3ctions
Author: János Fogas
E-Mail: janos.fogas@gmail.com
WWW   : http://sourceforge.net/projects/koll3ctions/
==========================================================================

What is Koll3ctions?
--------------------------------------------------------------------------
Koll3ctions is a free Kindle collection manager. 
Creates collections from your folders structure automatically on Kindle. 
It's platform independent. (Needs Java 1.6 or greater to run.)

Features
--------------------------------------------------------------------------
- Create collections for books on Kindle automatically based on the Kindle
  folder structure.
- Runs on Mac OS X, Linux and Windows. (It's platform independent.)
- Support Kindle 2, 3 and 5-way controller model. (It does NOT SUPPORT Kindle Touch or Fire!)
- Supported file formats: 
    - documents:
        - azw
        - azw1
        - mobi
        - pdf
        - prc
        - tpz
        - txt
    - pictures:
        - cbz
        - zip
    - music:
        - aa
        - aax
        - mp3
- Find the kindle automatically.
- Multilanguage support.
- Command line support for advanced users.


How to install
--------------------------------------------------------------------------
- If you don't have Java 1.6 or later download and install it from here:
  http://java.com
- Just unzip all the files into a directory you want.


How to run
--------------------------------------------------------------------------
- Connect your Kindle with an USB cable.
- Then launch Kollections.bat or Kollections.sh.
- Restart your Kindle. 
    - Press HOME, 
    - press MENU and select 'Settings', 
    - press MENU again and select 'Restart'.


Command line
--------------------------------------------------------------------------
USAGE:
    Koll3ctions [-[?|h|help] | -[l|lang] language | -[r|readable] | 
        -[b|backup] | -[s|scan] [a|p|ap] | -[k|kindle] driveLetter]

 -[b|backup]               Create backup from the actual collections.
 -[r|readable]             Set the output JSON file readable format.
 -[?|h|help]               Show the help screen.
 -[s|scan] [a|p|ap]        Scan extra folders where 'a' audiable, 'p' pictures,
                           'ap' audiable AND pictures.
 -[l|lang] language        Set the program output language.
 -[k|kindle] drivePath     Set the Kindle drive path.
 -[la|latinAlphabet]       Use only latin alphabet characters in the names of
                           collections. (For example: replace 'õ' to 'o'.)

DEFAULT:
  java -jar Koll3ctions.jar -backup -scan ap

EXAMPLE:
  java -jar Koll3ctions.jar -lang en -help (Show the english help screen.)
  java -jar Koll3ctions.jar -b -s ap       (Default. Creates backup and scan
                                           'audiable' and 'pictures' folders.)
  java -jar Koll3ctions.jar                (Default. Creates backup and scan
                                           'audiable' and 'pictures' folders.)
  java -jar Koll3ctions.jar -lang en       (Set program language to english,
                                           don't create backup and scan the 
                                           'documents' folder only.)


Help
--------------------------------------------------------------------------
Please feel free to contact me at anytime! Mail to: janos.fogas@gmail.com
Latest version available at: http://sourceforge.net/projects/koll3ctions/

==========================================================================
Koll3ctions software is provided "as-is". 
No warranty of any kind is expressed or implied. 
==========================================================================