IP Messenger v4.11

2016/11/14 H.Shirouzu

Index

1. Overview
2. License
3. Requirements
4. Uninstall
5. Usage
6. LogViewer
7. Settings
8. Others
9. WAN Settings (Broadcast Settings)
10. Member detection or file transfer Problem
11. CommandLine
12. Support
13. ToDo
14. tips/Shurtcut
15. 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.
Simple, lightweight, and free software :-)
1. Powerfull LogViewer (ver4.0)
2. Folder/file transfer
3. Embedded images in a message
4. RSA(2048bit) + AES(256bit) for safety communication
5. IPv6 Multicast support
IPMsg software is available for MacOSX, iPhone, Android, Java, X11/GTK/GNOME and all sources supplied with protocol. Please check the URL addresses below.
https://ipmsg.org/index.html.en

2. License

Copyright 1996-2016 SHIROUZU Hiroaki All rights reserved.
Copyright 2015-2016 Asahi Net, Inc. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. 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.
THIS SOFTWARE IS PROVIDED BY SHIROUZU Hiroaki and Asahi Net, Inc. ``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 SHIROUZU Hiroaki 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 XP/Vista/Win7/8/8.1/10 (and Windows2003/2008/2012)

4. Uninstall

If it was installed in administrative privilege, you can use uninstallation from control panel.
If it was not, you can use uninstallation from Start Menu.

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 images)
If logging setting is enabled, send/receive images are saved in ipmsg_img sub-folder of logfile folder.
(Because sending/receiving image mechanism use ipmsg file transfer, it requires to open 2425/tcp port)
Select embedded images and show context menu, it can be saved a 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
whiteEmbedded images, attached files, RSA2048/AES256/SHA1 encryption/sign
light pinkSame as white except disabling embedded images
light grayAttached files RSA encryption
light blueA part of v2.0 level (attached files)
dark grayBasic 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 "Size/Font/Pos Setting" 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.

StrongnessPublicKeyCommonKeySignatureReceive Window TitleLog File
StrongestRSA 2048bitAES 256bitRSA+SHA-1Receive Message +++(RSA2/Signed)
StrongRSA 2048bitAES 256bitNothingReceive Message ++(RSA2)
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>")

6. LogViewer

Powerfull Viewer that can show message log with embedded images

Main Features

It can show several tens of thousand messages with embedded images

It can narrow messages for specified user by 1 click

It has "Marker", "Favorite", "Comment" functions.

(and also has "Self memo", "Embedded images" functions)
Menu & Functions
File Menu
Open Text Log Open a text message log (it requires to associate ".log" file type with a program)
Open Image Folder Open png(embedded images) file folder in ipmsg log folder.
Import/remove log files Import(or remove) ipmsg text log files for the LogViewer.

If text log format is too old, it may not be able to separate username/hostname/uid/IPaddress.
(In that case, whether to modify a header(== Other messages that have same header will be modified, too). Or remove imported data, modify text log, and import it again.)
DB Prefetch Load log-DB file(ipmsg.db) to OS cache for improving search/show performance.
DB Vacuum Vacuum/Reindex log-DB file for reducing size and improving search performance.
Close Close LogViewer
Settings Menu
Reverse Disp Reverse the message show order.
Clear Find History Clear Find History
Font Settings Change display font
(Now, same font is used for all message area in LogViewer. Only font size and thickness are changed)
Window Menu
Open New LogViewer Open New LogViewer.
To add marker or modification will reflect all viewers.
Memo Message Add self memo like a message.
Help Menu
Help Open Viewer Help(this document).
Tips Open Tips section in Help.

ToolBar
Jump to lastest message button Jump to lastest message.
Then, it will be auto scroll mode and this button icon will be broken line arrow.
(with Shift key, jump to oldest message)
Switch to title only Toggle Normal / Title only mode
User filter ("All Users") Narrow selected user message.
(Pushing "User" button in a title has the same effect.)

If it is pushed small pen button, it will be changed manual user search.
(Search username/uid/hostname field)
Search string field Start realtime string search and jumping to a message that contains the string.
If it is pushed return key, jump to next searched message.
If it is pushed return key with Shift key, jump to previous searched message.

If it is checked "Check mark", narrow and show only hitted messages.
Complex search: "AAA BBB" means to search the messages that contain both "AAA" and "BBB". "AAA OR BBB" means to search the messages that contain "AAA" or "BBB".
Favorite narrowing Narrow favorite checked messages.
Marker/Comment narrowing Narrow markered/commented messages.
(Mark: Using right click menu in selected sentence. Comment: Using "..." button in the right side of message titlebar)
Narrow embedded images Narrow embedded image messages.
Narrow unopened messages Narrow unopened messages.
The number of unopened messages is 300. If it is over, New message can't be received.
(Even if it is used "logviewer receive mode", hidden receive window object is created during unopen status.)
Open Send Dialog
Open Send Dialog.

Title part of message area
Date Show the date of send/received message.
(If mouse is over this field, it will show date with day of week and seconds in bottom status field)
Arrow mark Right arrow means sended message, and left arrow means recieved message. (If mouse is over this field, arrow mark change to reply mark)
"User" button If it is pushed, narrow "User" messages.
If it is right-clicked, reply/etc menu will be shown.
Receive "Unopened" mini button If it is received a sealed message, it will show "Unopened" mini button in the right-top of "User" button.
If it is pushed, then the sealed message will open.
Send "Unopened" mini mark If a sended sealed message is not opened, it will show "Unopened" mini mark in the right-top of "User" button.
If the message is opened, it will be hidden.
Favorite Mark If it is pushed a Favorite Mark in a message title, the message will be registered as "Favorite".
And It affects results of narrowing Favorite button in toolbar.
Misc menu(...) Select "Reply ((== title dobule click)", "Copy message", "Modify Header", "Edit Message", "Delete Message", "Add Comment" menu items.

Message Area (Body)
Embedded images Embedded(inline) images is shown as thumbnail. If it is clicked, it will be expanded.
If it is double-clicked, the application that associates ".png" extension will open it.
Add Comment If it is right-clicked, it can be selected to add comment.
If comment area is clicked, then a dialogbox for EditComment will be opened.
Marker It can be selected "Marker", if selected string area is right-clicked,
Copy It can be selected "Copy", if selected string area is right-clicked.
Search Messages It can be selected "Search Message", if selected string area is right-clicked.
Google Seach It can be selected "Google Search", if selected string area is right-clicked.
Reply Open a send message window to reply. (same as title double clicking)
Embedded from Clipboard
Embedded images Ctrl-[V] is pushed, "Image" can be embedded from clipboard.
Embedded text Ctrl-[V] is pushed, "Comment" can be added from clipboard.

Shortcut list is this

7. Settings

Settings Dialog can be opened from right-click in tasktray icon.

Basic & LAN Settings

Basic Settings
User nameSet User name
Group nameSet/Select Group name
Input new group name or select group name in pulldown menu.
LAN Settings
Broadcast setup for different segments IPMsg can detect other members in same sagment. But to detect diffrent segment members, it requires broadcast settings.
(However, now, many current router default settings are blocking (network) directed broadcast. If your route is same settings too, then it requres to change router settings that pass (network) directed broadcast. Or it requires to use IPMsg Exchange Server (in that case, set add this server address to this field.))
Unicast requiredDemand status messages to other IPMsg client
Local segment broadcast (for IPv4 member detection)
Limited broadcastSend to 255.255.255.255 for member detection
(If VMWare is used, we recommend to use "Directed broadcast")
Directed broadcastListing all IPv4 addresses that NICs have, and send all directed broadcast addresses for member detection.
(ex: OS have two addresses(192.168.0.1/24 and 192.168.100.2/24), send to 192.168.0.255 and 192.168.100.255 for member detection.
bothuse Limted and Directed broadcast together
IPv6 multicast (for IPv6 member detection)
SiteLocalSend to ff15::979 as multicast address for member detection.
(If your site routers can use IPv6 multicast, over router member detection will be available.)
LinkLocalSend to ff02::1 as multicast address for member detection.
(member detection is available in local segment only)
Site/LinkLocal dualuse SiteLocal and LinkLocal

Detail Settings

Detal Settings
Receive MsgSpecify duration time(sec) at receive notification
Open MsgSpecify duration time(sec) at open msg notification<
Do not display user information(As it is)
QuoteStrSpecify quote string at replying
Use HotkeyOpen send/recv window by shortcut key
Change Send/Reply -> Fire/InterceptBack to original label(1st beta in 1996)
English UIChange to English UI (need restart)
IconChange main/tasktray Icon
RevIconChange recv/absense Icon
Register Icon & Notify
in TaskTray at Starting
Register Icon&Notify at starting, automatically

Send/Recv Wnd

Send Window
1 Click Open SendDlgOpen Send Dlg by 1click in tasktray icon
IME auto ONEnable IME at SendDlg opened
Narrow Userlist at replyShow original addressees in userlist at replying. (if it is clicked "+" mini button, show all users)
UserHsitoryNumSpecfy the number of user history in right click menu of SendDlg
Prevent missendConfirm addressee changed.
Recv Window
NonPopup ReceiveChange "popup" to "blink tasktray Icon" at receiving
Quoted check(As it is)
Open Logviewer when
trayicon is clicked at recv
(As it is)
Show LogonName(As it is)
Show IP address(As it is)
Don't close RecvDlg, when reply(As it is)
No recv sound(As it is)
Reproduce msg at rebooting
with unopend msg
(As it is)
Sound(As it is)

Image/Capture

Embedded image in a message
Always show directlyShow inline images in RecvDlg, directly
Show directly if priority userIf a sender is display priority user in SendDlg, show inline images in RecvDlg, directry
Always show via Image button(As it is)
Display (area specified) Capture
Minimize Send Message Dialog as default(As not to interfere with the capture)
Clipboard check as defaultCopy image to Clipboard at finishing to capture
Save check as defaultOpen save image dialog at finishing to capture

URL/File Link

Link behavior
One click openOpen a link by single click. (default: double click is needed)
One click open (only viewer)Open a link by single click in log viewer, and open a link by double click in send/recv window.
Link targets are only URLShow only URL-link, not File-link.
Permitted file extensions for clicking a file linkset open file-types without confirm dialog

Log Setting

Logging
Logging available(As it is)
LogFileSpecify a filename of send/recv message logs.
And also, a dbfile(ipmsg.db) for logviewer will be created in same folder.
And also, inline image(.png) files will be stored in ipmsg_image subfolder of LogFolder.

Auto FileDownload

Auto Save
Enable to download attched files automatically(If a message is opened, the message is not autosaved. It requires to download it manually
Auto download folder(If it is not specified, it is used "(LogFile_folder)\AutoSave")
Limitation by disp priorityAutoSave function can be enabled for display priority users.
Download size limitation(MB)Specify the limit of total download size
Download size will be added up while IPMsg hasn't be operated manually
(This limitation protects for disk full)
Grace sec of starting auto downloading(As it is)
Allow to download foldersAutoSave is enabled, even if it is a folder. But total file/folder downloaded size is over than the limitation size, folder transfer will be discontinued
(In this case, it can download manually, if the sender hasn't been shutdown/restart

Remote reboot

Remote Reboot
Allow remote RebootIf it is received "ipmsg-cmd:...", this machine will reboot this machine when a reboot confirm dialog is timeout(15sec)
RefreshChange the reboot message command("ipmsg-cmd:...")
Remote Shutdown
Allow remote ShutdownIf it is received "ipmsg-cmd:...", this machine will be shutdown when a shutdown confirm dialog is timeout(15sec)
RefreshChange the shutdown message command("ipmsg-cmd:...")
Remote Terminate IPMSG
Allow remote ShutdownIf it is received "ipmsg-cmd:...", this ipmsg will be terminated when a terminate confirm dialog is timeout(15sec)
RefreshChange the terminate message command("ipmsg-cmd:...")
(for restarting multiple via RDP or for requesting restart/shutdown to other ipmsg user)

Misc/Firewall

Export Settings
Export settings to .reg file(As it is)
Windows Firewall
Don't confirm Windows Firewall settings at startIn current version, ipmsg confirms Windows Firewall Settings at starting.
And if Windows Firewall blocks IPMsg packet, IPMsg shows "Add to firewall exception list for receive" dialog.
If it is checked, this dialog will be not shown. d>
Experimental
Reduce task tray action at receiving(Change "Blink" to "mini sun moving")

8. 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'].

9. 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.

10. 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.

11. 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.
(Changing /MSG to /MSGEX, '\n' in message will be replaced to new-line character)

12. Support

Any bug report, suggestion and recommendations are welcome in the bbs of https://ipmsg.org/index.html.en
(This site's BBS is the only official support entry)
For these report, please send the following information.
Software Version, Operating System, problem situation, repeatability.

13. ToDo

If you have a reqeust, pleas post to https://ipmsg.org/index.html.en's New BBS

14. Tips/Shortcut key

FunctionDetails
Almost All Windows To close a window, Shortcut(CTRL + [W]) can be used.
Open Send/Recv/LogView
Dialog
It is easy to use shortcut key
(It is assigned CTRL + ALT + [S][R][E], as default)
And in send/recv/LogVIew dialog, it can used BOSS key(Ctrl-[D])
Send Dialog Ctrl-[F] is User incremental Search
To set display priority settings in right click of userlist is convenience.
To use the frequency userlist in right click of userlist is convenience.
If it is right-clicked a image, the image can be re-edited.
If it is sended with SHIFT + CTRL + right-click, it can retrieve the receiver's ipmsg version.
If the refresh button is clicked with Ctrl-key, it is refreshed userlist, but it doesn't remove old entries.
Receive Dialog If it is right-clicked a image, the image can be stored as a png file.
A image can drag & drop to Send Dialog.
LogViewer

[Space][Ret] Go to next message (with Shift-key, go to previous message)
Ctrl-[T] or [Home] Jump to the top of messages (oldest message)
Ctrl-[B] or [End] Jump to the end of messages (newest message)
Ctrl-[R] Reply (if a enabled current message(*) exists)
Ctrl-[S] Open Send Dialog
Ctrl-[F] Set focus to the Search field (toggle)
Ctrl-[N] Show only search results (toggle)
Ctrl-[U] User string search (toggle)
Ctrl-[Q] Title Only mode (Toggle)
Ctrl-[C] Copy selected area to clipboard
Ctrl-[V] Paste from clipboard

In the Search field, it can used AND/OR/NOT search.
AND: "AAA BBB"
OR: "AAA OR BBB"
NOT: "AAA NOT BBB" (NOT can't used the top of the field)

(*) Enabled current message(**) == selected by mouse click, or move current message by [Ret]
(**) Current message has a glay line in the left of header

15. History

VersionDetails
v4.11 Fix not to reflect a opened information to a logviewer.
Fix installer failure when logon name includes multi-byte charactor.
Misc fix.
v4.10 Narrow userlist(original addresees only) at replying as default. (Click "+" button, show all)
Fix not to freeze at receiving in Win10 anniv. (ToastAPI problem. Avoid by multi thread)
Improve logviewer. (Add unopend filter button. Enable to reply in message blank area.)
Change a number of unopen receive window is 100 -> 300. (it can be changed HKCU\Software\HSTools\IPMsg\RecvMax)
v4.00 Support Powerful LogViewer
Support multiple-addressees reply.
Support to confirm that reply-addressees are changed.
Support to add to firewall exception list for receive.
Misc refine/fix.
v3.50 - v3.64 Change bakgroud color to non-transparent for text-marker in image capture.
Support auto download option for attached files.
Support reproduce message for unopened/hidden message at restarting.
Support to encryption/sign(AES-CTR256bit) for file/folder transfer
Support IPv6 multicast
Change image processing library (libpng -> GDI+)
Add new marker function(arrow with text/rectangle).
Support to re-edit image.
Support to paste image by file.
Add new commandline message mode(/MSGEX), "\n" in message is replaced to new line code.
Suport remote reboot/shutdown.
v3.00 - v3.42 (v3.42 is the final version that supports Windows2000.)
Support Marker function for captured display image.
Support display (area specified) capture.
Support detail settings of balloon notifications.
Release 64bit version.
Support select users by user(sended) history.
Support icremental search for userlist (Ctrl-[F]).

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)