zAlbee's IMmerge
Trillian/ICQ/MSN Instant Messaging Log Merger

by: zAlbee
email: zalbee -AT- gmail -DOT- com
site: http://zalbee.intricus.net/immerge


Changelog:
----------

- v0.66 (Sep 22, 2009):
    - fixed Trillian XML log size growing exponentially, in the rare case where 
      text occurs before the first session, creating duplicates (if you 
      experience this, manually delete duplicates from the top of the affected 
      files).
    - improved merge speed of Trillian LOG and XML by using StringBuffer.

- v0.65 (Dec 19, 2008):
    - read new timezone introduced in Trillian Astra 4.0 Build 90 (Nov 21). 
      Previous IMmerge versions are unable to read the date correctly from 
      *.LOG files after Build 90. Update strongly suggested.
    - write new timezone in output.
    - better detection of missing session close marker in Trillian *.LOG files.
      Fixes incorrect ordering in some cases. Also add blank lines here for visual 
      clarity.

- v0.64 (Oct 1, 2008):
    - fixed unable to detect UTF-8 header in Trillian *.LOG files on some systems.
    - added commandline to choose character set for *.LOG files that do not contain
      UTF-8 BOM. Default is based on Java's default for your locale/region. It is 
      unlikely you need to use this unless you have very old (Trillian 0.74) logs.
      Use:
        java immerge -defaultcharset CHARSETNAME

- v0.63 (Feb 25, 2008):
    - now uses case-insensitive comparison of filenames (user IDs), while
      retaining the original case on output.
    - added option to skip an MSN Messenger log if you don't
      know the email address.

- v0.62 (Dec 8, 2007):
    - fixed bug where sessions might not be in the correct order in the following
      situation: if merging 3 or more logs, reading the last session in one log (A), 
      2 other logs (B, C) have the same session as A, but C's next session comes 
      before B's next session.
    - added version string
    - added merging of Trillian (Pro/Astra) mediums: ASTRA, FACEBOOK, GOOGLE, 
      JABBER, MYSPACE, XFIRE
    
- v0.61 (May 21, 2007):
    - decreased memory use, fixed out-of-memory error with large number (1000's)
      of log files. (Avoid allocating read buffers before needed.)
    - fixed unable to read any sessions from ICQ Lite logs created from ICQ 2003b 
      history using ICQ Conversion Tool. Linebreaks in XML files no longer matter.
    - fixed potential early termination if empty events found in ICQ Lite logs.

- v0.6 (Apr 6, 2007):
    - added MSN/WLM log conversion/merging into Trillian LOG + XML (messages only).
      -> detects most user IDs (hotmail.com, msn.com, gmail.com) from hashcode.
      -> supports correct incoming/outgoing message formatting, by detecting the
         owner of a display name with a custom similarity metric. User-correctable.
    - now encodes display names and user IDs into entities when converting to
      Trillian XML (only encoded message text before).

- v0.5 (Feb 24, 2007):
    - added ICQ Lite log conversion/merging into Trillian LOG + XML.
    - added immerge.ini file to save ICQ nicknames.
      -> Thanks to Prasad P. Khandekar for the freely available INIFile class.
    - added support for Channel subfolder in Trillian 3.0+.
      -> on input, will find logs in Channel subfolder.
      -> if using "Output to Query/Channel" option, auto-detects MSN Group 
         Conversations and IRC channels (with # in name), and places them in Channel 
         subfolder.

- v0.45 (Jan 24, 2007):
    - greatly improved the conversion from ICQ Pro to Trillian XML logs.
      -> fixed the way non-ASCII characters were converted from ICQ Pro to character 
         entities in Trillian XML logs, including UTF-8 entity sequences.
         Also fixes certain combinations of HTML entities.
      -> fixed a bug where merging ICQ Pro with Trillian XML logs would leave all 
         Trillian sessions at the beginning and ICQ Pro at the end (date was in 
         seconds, should be ms)
    - now adds a space in front of subsequent lines of a multi-line message, when 
      converting from ICQ Pro. This is more like the newer Trillian behaviour 
      (in both LOG and XML files)
    - now requires JRE 1.4 (for regex support)

- v0.4 (Jul 13, 2006):
    - added XML log merging
       - also produces XML logs from ICQ history files, and then merges
    - fixed the read/write methods for UTF-8 files when detected. It was using the 
      system default character encoding before. IMmerge is now completely safe to use 
      on logs with foreign Unicode characters.

- v0.3 (Nov 30, 2005):
    - fixed Trillian log timestamp-parsing in other locales/language regions.
    - added option to use 24hr display
    - added option to change timezone correction of ICQHR

- v0.22 (Nov 27, 2005):
    - important fix! did not fix corrupt UTF-8 header before, now it does.

- v0.21 (Nov 26, 2005):
    - no longer needs JRE 1.5. now runs on 1.2 and up.

- v0.2 (Nov 23, 2005):
    - now looks in Query folder + regular folder
    - added option to output to Query folder
    - now keeps true to all the text in the original logs, even if it's formatted 
      incorrectly, not in a session, etc.
    - fixed nested sesssion handling
    - now outputs own UTF-8 header
    - (--fixes logs with corrupt header-- note: was not actually implemented)
    - now works with ICQ History Reader logs that don't have user info

- v0.1 (Oct 4, 2005):
    - first version, little buggy