zAlbee's IMmerge

Trillian/ICQ/MSN Instant Messaging Log Merger

How to install:

Simply extract the contents of the ZIP file into a folder of your choice. For example, C:\immerge. Make sure to extract with original paths.

How to run:

Right now, this program can only be run from the command line. It also requires you to move/copy your log folders and rename them. These will be addressed in a future version.

Short version:

Collect your log folders that you want to merge. Put the folders where IMmerge is installed, and make sure they are named:
```
<format><number>
```
where <format> is one of: "logs", "icql", "icqh", or "msn" for Trillian, ICQ Lite, ICQ History Reader, or MSN respectively. and <number> is at least "1".
From a command prompt, run:
```
java immerge
```
The program will ask you for a few things: Such as how many folders you have in Step 1.
The merged logs will be created in a folder called output. Stats and error messages are displayed on screen.
If all was successful, you can copy the output folder back to your Trillian folder.

Long version, with explanations of options:

Run ICQ History Reader (only if you have logs from the original ICQ Pro (98-2003b) client). Click "Open Database", select your ICQ DB, then "Export to HTML". Under settings, use "UIN per file".
Collect your log folders that you want to merge.
1. Go to your Trillian logs from one computer. By default, they are in C:\Program Files\Trillian\users\<username>\logs.
  Copy this entire folder, and name it "logs1". Put this folder in the same place where IMmerge is installed. Repeat for the other computers, renaming them to logs2, logs3, logs4, etc.
2. Put your ICQ Pro HTML logs (from step 0: ICQ History Reader) from one computer into one folder, named "icqh1". Put this folder in the same place where IMmerge is installed. Repeat for the other computers, renaming them to icqh2, icqh3, etc.
3. Go to your ICQ Lite logs from one computer. By default, they are in: C:\Documents and Settings\<username>\Application Data\ICQLite\HistoryDB\<YourICQNumber> for Win XP/2003, or C:\WINDOWS\Profiles\<username>\Application Data\ICQLite\HistoryDB\<YourICQNumber> for Win 98/ME.
  Take a copy of the entire folder, and rename it from <YourICQNumber> to "icql1". Put this folder in the same place where IMmerge is installed. Repeat for the other computers, renaming them to icql2, icql3, etc.
4. Go to your MSN/WLM logs from one computer. By default, they are in: C:\Documents and Settings\<username>\My Documents\My Received Files\<msnname + some numbers>\History for Win XP/2003, or C:\My Documents\My Received Files\<msnname + some numbers>\History for Win 98/ME.
  Take a copy of this folder, and rename it from "History" to "msn1". Put this folder in the same place where IMmerge is installed. Repeat for the other computers, renaming them to msn2, msn3, etc.
Run "java immerge" from a command prompt. Open a command prompt by clicking Start > Run, then type: cmd for Win XP/2003, or command for Win 98/ME. and press <Enter>. Navigate to wherever you installed IMmerge (e.g. C:\immerge) by typing:
```
cd C:\immerge
java immerge
```
-> If you get a NoClassDefFoundError, make sure you are in the directory with immerge.class. If that doesn't work, try java -classpath . immerge
The program will ask you for a few things:
1. How many folders ... : enter the number of "logs" folders (from step 1.a)
2. How many folders ... : enter the number of "icqh" folders (from step 1.b)
3. How many folders ... : enter the number of "icql" folders (from step 1.c)
4. How many folders ... : enter the number of "msn" folders (from step 1.d)
5. Should the logs be output to a "Query" or "Channel" folder?
  - enter "Yes" to write both LOG and XML files into the Query (or Channel) subfolder
    (this is what fresh installs of Trillian 3.0+ expect)
  - enter "No" to write LOG files into the parent folder
    (this is what pre-3.0 versions OR pre-3.0 upgraded to 3.0+ installs expect)
  - XML files are always written to the Query (or Channel) folder
  - This only affects the output folder, IMmerge will still read all your input logs successfully
If you are merging non-Trillian logs, it may also ask you:
1. Your ICQ UIN:
  - this is your ICQ number (required)
  - affects logs that are merged from ICQ Pro, ICQ Lite
  - required for making functional XML files
2. Your ICQ Nickname:
  - affects logs that are merged from ICQ Pro, ICQ Lite
3. Display time in 24-hr format?
  - Enter Yes to write log times like [18:45]
  - Enter No to write log times like [06:45 PM]
4. Correct ICQHR timezone by how many hours?:
  - Check the times that ICQ History Reader produces in your logs; if they are wrong, enter a number of hours to correct it.
  - For example, I found that -16 hours is the correct offset for mine.
5. Enter nickname for <ICQNumber>:
  - Nickname of this ICQ user (it will be saved in immerge.ini)
  - If you don't know, leave blank and the ICQ number will be used in the converted logs instead.
6. Your MSN login (e.g. abc@hotmail.com):
  - Required.
7. Your MSN display name (most common or earliest):
  - helps resolve display names
  - the program will use this name initially to compare unknown display names
8. How should unknown MSN display names be resolved?
  - Since MSN/WLM logs only store display names, not user IDs, IMmerge can not be certain whether some display names belong to the owner (you) or the user, but will make an educated guess. This option determines how much control you have on that decision.
  1. Automatically - Always uses the program's guess. May be useful if you are running the program unattended.
  2. Prompt on vague names - Will ask you to confirm a display name if it is not sufficiently similar to a known name.
  3. Prompt on any name that is new/uncertain - Will ask you to confirm a display name if it is not 100% equal to a known name.
  - Resolving the display name correctly means that the message will be correctly formatted as incoming or outgoing in Trillian XML logs. There is no other effect.
9. Enter the MSN ID (full email address) for <msnname + some numbers>:
  - The user is using a non-standard email address to login to MSN (not hotmail.com, msn.com, or gmail.com)
  - Enter the email they use. IMmerge will check for its correctness.
  - If you don't know it, type 'skip'.
  - This will be saved in immerge.ini.
The merged logs will be created in a folder called output. Stats and error messages are displayed on screen.
If all was successful, you can copy the output folder back to your Trillian folder.