IP Messenger v3.42

2012/06/10 H.Shirouzu

Index

1. Overview
2. License
3. Requirements
4. Uninstall
5. Usage
6. Others
7. WAN Settings (Broadcast Settings)
8. Member detection or file transfer Problem
9. CommandLine
10. Support
11. Thanks
12. History

1. Overview

IP Messenger is a pop up style LAN message communication software for multi platforms. It is based on TCP and UDP/IP.

This software does not require server machine.

Embedded image in message (ver3.00 or later)

Folder/file transfer (ver2.00 or later)

RSA2048/AES256/Sha1 Encryption/Sign of message data (ver3.00 or later)

RSA/Blofish Encryption of message data (ver2.00 or later)

Simple, lightweight, and free software :-)

IPMsg software is available for MacOSX, iPhone, Java, X11/GTK/GNOME and all sources supplied with protocol. Please check the URL addresses below.
http://ipmsg.org/index.html.en (Android version is open to public in Android Market)

2. License (BSD License)

Copyright 1996-2012 SHIROUZU Hiroaki All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

Neither the name of the SHIROUZU Hiroaki nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.

IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

3. Requirements

Windows 2000/XP/2003/Vista/2008/Win7

4. Uninstall

You can uninstall from control panel.

5. Usage

Task tray icon

Left Single(or double) click on the icon opens a Send Message window.
Right single click on the icon opens IPMsg menu such as setting, absence mode, etc.

Send Message Window

If [Seal] is checked, it will be sealed message.
If [Lock] is checked, it will be locked message. The receiver must use receiver's own password to open a locked message.

To embed clipboard image (v3.0 or later), push CTRL-V in editbox.(Max.10 image)
If logging setting is enabled, send/receive images are saved in ipmsg_img sub-folder of logfile folder.
(Because embedded image mechanism use ipmsg file transfer, it requires to open 2425/tcp port)
Select embedded image and show context menu, it can be saved selected image to a file.

To capture display (v3.3 or later), push camera button or select in the menu that under "refresh" button.
Area specified desktop image (that can be modified by marker) can be pasted to Send Message Window and it can be saved to PNG file.
Send Message Window is minimized at starting to capture, but this behavior can be changed by settings.

To transfer File/Folder (v2.0 or later), Drag & Drop File/Folder to Send Window. (or selec right button menu on Send Window)

File/Folder transfer can't be completed until a receiver starts to download the file. If a sender re-starts IPMSG, the attachment file information becomes clear, and a receiver will not be able to download the file.)

Prefix color of the user list
colormean
whitev3.0 level (embedded image, attached files, RSA2048/AES256/SHA1 encryption/sign)
light pinksame as white except disabling embedded image
light grayv2.0 level (attached files RSA encryption)
light bluea part of v2.0 level (attached files)
dark grayv1.0 level (basic message communication)
Attention: ! mark indicates absence mode

The order of Send Message window header item list can be changed by Drag & Drop. Right click and select "Save List Header" for saving order.

Right click on the window and select from the menu: Sort/Filter, Group Select, Search User Ctrl+F, File Transfer, (Folder)Transfer, Save List Header, Font Setting, Size Setting, Fix Position, Disp Setting.

Sort/Filter display order priority Sort priority is from small to large number.
If there are identical priority data, then go to the detail setting -> approx. level user sort setting

Receive Message Window

Right click on the window and select from the menu: Font Setting, Size Setting, Fix Position.

If you receive a message with an attachment, then an attachment button will be displayed. Folder transfer data can't be overwritten.

IP Messenger v3.0 or later, Messaging security have improved.

StrongnessPublicKeyCommonKeySignatureReceive Window TitleLog File
StrongestRSA 2048bitAES 256bitRSA+SHA-1Receive Message +++(RSA2/Signed)
StrongRSA 2048bitAES 256bitNothingReceive Message ++(RSA2)
MiddleRSA 1024bitBlowfish 128bitNothingReceive Message +(RSA)
WeakRSA 512bitRC2 40bitNothingReceive Message -(RSA)
NothingNothingNothingNothingReceive Message

It is used most strong way that is supported by sender and reciever.
UserID is extended with finger print in v3.0 or later. ("uid" --> "uid-<finger_print_hexstr>")

Settings Dialog

It can be changed detail settings.

Shortcut or etc

1. Ctrl+D ... Boss key (toggle of hide/show windows)
2. Ctrl+RefreshButton ... remain existing members, and refresh
3. ALT+Ctrl+'S'/'R'/ ... Send/Recv Hotkey (need detail settings)
4. ALT+Ctrl+'D' ... Close old-style message-open notification window
5. Ctrl+F ... open search user box in send window

6. Others

Setting is saved in the following registry key.
\\HKEY_CURRENT_USER\Software\HSTools\IPMsgEng
(If port number has been set, IPMsg + port number)
When changing your registry number, please re-start ipmsg.

Password for Lock and Seal is saved in registry with encording.

If you forget the password, remove it in the following registry key.
\\HKEY_CURRENT_USER\Software\HSTools\IPMsgEng\PasswordStr

Normally use 2425 port for TCP/UDP. (See 8. Appendices)
Use 2425 port only for UDP with no File(Folder) Transfer.
(These ports should be activated when using firewall software.)

Protocol specification comes with source.(Japanese)

Broadcast messaging happens only at [Start/End], [Absencemode], [Refresh], [Change 'UserName' or 'GroupName'].

7. WAN settings (Broadcast Settings)

All bits of Host part have to be 1 in the receiver's IP address.
For example, connect to Class C(network 24bit, host 8bit) address "aaa.bbb.ccc.ddd", broadcast address will be "aaa.bbb.ccc.255".
If network uses subnet, it may not work.

For more detail check TCP/IP books or ask network administrators.

If you have difficulty to connect, especially over two or more router connection. Set IP addresses independent.

For dialup connection, check [Dialup connection] box on.
When press [Refresh], member list doesn't go off.

8. Member detection or file transfer Problem

IP Messenger use 2425/UDP port for member detection and message communication, and use 2425/TCP port for file and image transfer.
If those port are blocked by OS or Antivirus software, IP Messenger can't detect other member or can't send/receive file or images.
Please open those port.

9. CommandLine

At startup IPMSG software, you can specify UDP/TCP port number.
IPMSG can run at multiple sessions.
For example, using [ipmsg.exe 2426] command, you can contact only people who are using 2426 port.

You can run as much as you want using different port number.

Using more UDP/TCP port number, then 1024 is recommended.
(Between 10000 - 60000 may be more safer)
For example, Known NFS software uses 2049/UDP.
Ask network administrator

Specifing NIC (for multi NIC environment)
ipmsg.exe [port] /NIC nic_ipaddr
ex) C:\> ipmsg.exe /NIC 192.168.10.100

Command Line support
ipmsg.exe [port] /MSG [/LOG][/SEAL] <hostname or IPaddr> <message>
ex) C:\> ipmsg.exe /MSG /SEAL localhost Hello.

10. Support

ipmsg-ML is opened. If you want to subscribe for this ML, mail to ipmsg-ml-join@ipmsg.org

Any bug report, suggestion and recommendations are welcome.

If you have any question, send to Mailing list.

For these report, please send the following information.
Software Version, Operating System, problem situation, repeatability.

11. Thanks

12. History

VersionDetails
v3.42 Update libpng (1.5.9 -> 1.5.10)
Fix hidden button label in classic style.
(It will be the final version that supports Windows2000.)
v3.41 Support Marker function for captured display image.
Update libpng (1.5.4 -> 1.5.9) for VU#523889
Show embedded image directly as default.
Support to save selected embedded image to a file via right context menu.
Improve Send Dialog UI.
v3.32 Show embedded image directly as default, if priority user.
Fix illegal characters in setting dialog(v3.31 only)
v3.31 Support to export settings to .reg file. Fix "Log file" button in settings. Misc refine.
v3.30 Support display (area specified) capture.
Support detail settings of balloon notifications.
Update libpng (1.5.2 -> 1.5.4) for VU#819894
Misc refine.
v3.21 Prevent to lost focus in active window when embedded image messsage is received.
Release 64bit version.
v3.20 Support select users by user(sended) history.
Support old-style message-open notification.
Support delayed message-open notification, if desktop window is not activated(ex. screen saver).
Improve unopened message monitor.
Change default behavior to open Send Window by single click.
Misc refine.
v3.10 Support icremental search for userlist (Ctrl+F).
Change recv/log header format.
Improve send list prefix color.
Improve setting dialog.
Change zip archive to exe installer.
some fix.
v3.00 Support embedded image in message.
Support multi language communication.
Support unopened message monitor.
Support to choose Directed/Limited broadcast for local segment.
Support RSA2048/AES256bit encryption.
Support RSA2048/SHA-1 digital sign/verify.
Support userid extension(public-key fingerprint).
v2.10Balloon notification, UTF-8 logging, unify ipmsg.exe for Japanese/English
v2.00File/Folder Transfer function support, Encrypted communication path support.
v1.31English version support(97/09/01)
v1.00Official public version (1996/08/19)