Forums

Hasan · #1 (**permalink**) 08-02-2004, 04:49 PM

Introduction:-
Gilly Messenger is an alternate MSN client with different extra tools and options like:-
- Multiline nicknames.
- Talk to people while they're blocked.
- Keep talking to people even after appear offline.
- Keep talking to people even after signing out.
- Open multi instances of GM.
- Search your contact list.
- Chat logger.
- Status logger.
- Text Styler (Word/Character replacement tool).
- Auto Message.
- Chat Bot.
- Unlimited Message length.
- No invite limit.
- IM Window commands e.g cls, /block/ ignore e.t.c.
- New idle state (If GM is not used for 5 mins it will change your status to idle).
- New ignore option (Prevents people from sending you message).
- Easy to change nick and status.
- Block alert.
- Delete alert.
- Add alert.
- Choose status before signing-in.
- Store comments on contacts.
- Contact renaming (Custom Nick).
- Have a fake nick in conversation.
- Emoticon flood control.
- Message All option.
- MSN Messenger like interface.
- Get to know when someone opens your window.
- Get to know when someone closes yoru window.
- Contact statistics (last online time, last message time, last file transfer ip, e.t.c.).
- IM Encryption.
- Random IM Colors.
- Random IM Formatting.
- Contact list cleaner.
- Popup Filter.
- Sound Filter.
- Change file transfer port to bypass firewalls (Does not work from MSN to GM).
- Store password for multiple accounts.
- GM Display Pics (Only viewable to GM users).
- GM Remote Control (Control your PC using a command line interface through text messages).
- GM Scripting Engine (Code your Addons in extended scripting language of GM).
IM Window commands:-
You can type these commands in IM Windows and press return key to achieve different tasks.
Following are the IM Window commands with their description:-
Any argument in bracket shows its optional.
- CLS
  Clears IM Window text.
- /Vanish
  Makes the IM Window invisible and makes it visible when message is received.
- /Block [email]
  Blocks the contact.
- /Unblock [email]
  Unblock the contact.
- /Ignore [email]
  Ignores the contact.
- /Unignore [email]
  Unignores the contact.
- /Profile [email]
  Shows the profile.
- /Properties [email]
  shows properties dialog of contact.
- /List
  Shows all the buddies in conversation.
- /List Online
  Shows all online contacts.
- /View Log [email]
  Shows chat log with the primary conversation buddy.
- /View Comment [email]
  Shows the comment on the contact.
- /Comment [email] Comment
  Sets the comment for the contact.
- /CustomNick [email] Nick
  Sets the customnick of the contact.
- /AddContact [email]
  Adds the contact.
- /Find Text
  Finds the text in IM Window chat history.
- /Email [email]
  Opens hotmail compose page to the specified email address.
- /Nick Nick
  Changes your nickname.
- /FakeNick [Nick]
  Toggles your nick inside the conversation.
- /Font [Bold] [Italic] [Strikethru] [Underline] [FontName]
  Changes your font to the specified format.
- /Color Hexcode
  Changes your color to the specified hexcode.
- /AutoMsg [Message]
  Toggles auto message.
- /Online
  Changes your status to online.
- /Busy
  Changes your status to busy.
- /BRB
  Changes your status to be right back.
- /Away [Message]
  Changes your status to away with optional auto message.
- /Phone
  Changes your status to on the phone.
- /Lunch
  Changes your status to out to lunch.
- /Idle
  Changes your status to idle.
- /Hide
  Changes your status to appear offline.
- /Chat Email
  Starts conversation with the specified email address.
- /Msg Email Message
  Sends an instant message to the specified email address.
- /MsgAll Message
  Sends the specified message to all active conversations.
- /SendFile PathOfFile
  Sends the specified file to the primary conversation buddy.
- /Signout
  Signs you out of the MSN server.
- /Signin Login Password
  Signs you in the MSN server.
- /Ver
  Shows you the version of GM you have.
- /Msgr
  Gives focus to main GM window.
- /Close
  Closes the IM window.
- /Script ScriptPath/Name
  Loads the script by name in scripts directory or by complete path.
- /Bot BotPath/Name
  Loads the bot by name in bots directory or by complete path.
- /Execute FileName [Parameters]
  Opens the file, executable or internet short cut.
- /Buzz
  Shakes the IM window of your buddy like yahoo to get the attention.
- /Exit
  Terminates GM.
Message Aliases:-
Aliases are the words that are replaced by a certain value pre-defined in GM.
You can use following aliases:-
- (Time)
  Is replaced with current time.
- (sTime)
  Is replaced with current time without seconds.
- (Date)
  Is replaced with current date.
- (Now)
  Is replaced with current date and time.
- (Day)
  Is replaced with current day.
- (Email)
  Is replaced with your email.
- (Nick)
  Is replaced with your nick.
- (Status)
  Is replaced with your status number.
- (MyIP)
  Is replaced with your IP address.
- (CrLf)
  Is replaced with carriage return and line feed.
- (Ver)
  Is replaced with GM version.
- (Song)
  Is replaced with currently playing winamp song.
- (FontName)
  Is replaced with your IM font name.
- (FontColor)
  Is replaced with your IM font color value.
- (FontBold)
  Is replaced with your IM font bold value.
- (FontItalic)
  Is replaced with your IM font italic value.
- (FontStrikethru)
  Is replaced with your IM font strikethru value.
- (FontUnderline)
  Is replaced with your IM font underline value.
- (Font)
  Is replaced with your complete font formatting.
- (BuddyCount)
  Is replaced with number of buddies in multi contact conversation.
- (BuddyEmail)
  Is replaced with the email of the primary conversation buddy.
- (BuddyNick)
  Is replaced with the nick of the primary conversation buddy.
- (BuddyComment)
  Is replaced with the comment on the primary conversation buddy.
- (BuddyCustomNick)
  Is replaced with the custom nick of the primary conversation buddy.
- (Buddy#Email)
  Is replaced with the email of the buddy specified by number(#) in multi contact conversation.
- (Buddy#Nick)
  Is replaced with the nick of the buddy specified by number(#) in multi contact conversation.
- (Buddy#Comment)
  Is replaced with the comment on the buddy specified by number(#) in multi contact conversation.
- (Buddy#CustomNick)
  Is replaced with the custom nick of the buddy specified by number(#) in multi contact conversation.
GM Scripting Engine:-
GM Scripting Engine enables you to execute commands on GM saved in a text file with 'gms' extension.
Its commands, functions and events are explained as follows however you can go through the scripts given with the package to have a better understanding.
- Commands, Statements, Functions
  - ChangeNick Nick
    changes your nickname.
  - ChangeStatus Status
    Changes your status toe the number you specify between 0 to 7 (Inclusive).
  - Signout
    Signs you out of MSN server.
  - SignIn Login Password
    Signs you in the MSN server with the login and password you specify.
  - Sleep MilliSeconds
    Delays the execution of the next statement in milliseconds.[/i]
    Note: This command does not function under events.
  - Goto LineNumber
    Moves the execution control to the line number you specify.
    Note: empty spaces and comments and event tags are not counted as lines.[/i]
    Inside events the line count is reset.
  - Chat Email
    Starts conversation with the specified email address.
  - Msg Email Message
    Sends an instant message to the specified email address.
  - MsgBox Message
    This can be used to show a message box to the user running the script.
  - SendFile Email PathOfFile
    Sends the specified file to the contact with the specified email address.
  - MsgAll Message
    Sends the message to all active conversations.
  - Ignore Email
    Ignores the contact with specified email address.
  - Unignore Email
    Unignores the contact with specified email address.
  - Block Email
    Blocks the contact with specified email address.
  - Unblock Email
    Unblocks the contact with specified email address.
  - AddContact [AL/FL/BL] Email
    Adds the contact to the specified list if mentioned otherwise added to forward and allow list together.
  - DelContact [AL/FL/BL] Email
    Deletes the contact from the specified list if mentioned otherwise contact is deleted from forward list.
  - Comment Email Comment
    Sets the comment on the contact with specified email address.
  - CustomNick Email Nick
    Sets the custom nick of the the contact with specified email address.
  - LoadScript PathOfScript
    Loads another script from the specified path.
  - LoadBot PathOfBot
    Loads the bot from the specified path and unloads any other bot if loaded.[/i]
    Note: Only one bot can be loaded at a time.
  - Execute File/Executable/URL [Parameters]
    Opens the file, executes the program or opens an internet shortcut.
  - PlaySound PathOfSound
    Plays the wav/mp3 sound.
  - End
    Ends and unloads the script.
  - Exit
    Terminates GM.
  If parameter of any command is (INP) then user is prompted for the value of paramenter.
- Variables
  A variable is a word which carries a certain value thats replaced where ever it is used in the script.
  Its ideal to add '$' prefix to variable name e.g. $Temp.
  To assign a value to the variable you can use the 'Set' statement.
  Syntax of 'Set' statement is as follows:-
  Set VariableName = Value
  There are different functions that can be used in place of variable value:-
  - Mid Pos CharCount String
    Returns part of a string.
  - Left Chars String
    Returns characters from left side of a string.
  - Right Chars String
    Returns characters from right side of a string.
  - Len String
    Returns the length of a string.
  - Comment Email
    Returns the comment on the contact with specified email address.
  - CustomNick Email
    Returns the custom nick of the contact with specified email address.
  - Nick Email
    Returns the nick name of the person with specified email address.
  - Status Email
    Returns the status number of the contact with specified email address.
  - Rand Limit
    Returns a random number between 1 and the limit (inclusive).
  - InList [AL/FL/BL/RL] Email
    Returns true if the specified contact is in the specified list.
  The value of a variable can also be set to a mathematical expression which is replaced with its evaluated result.
  Supported arithmetic Operators are +, -, /, ^ & Mod.
- File I/O
  - Set $FilePointer=fOpen(PathOfFile, i/o/a/b/r)
    This function opens a file and returns the pointer to the file in variable.
    First paremeter is the file to be opened and second parameter is operation mode.
    - i opens file in input mode.
    - o opens file in output mode.
    - a opens file in append mode.
    - b opens file in binary mode.
    - r opens file in random mode.
  - FClose $FilePointer
    This command closes the file opened with fOpen function.
  - fWrite $FilePointer [FilePos] Data
    This command is used to write to a file.
  - Set $Data=fRead(FilePointer, [FilePos], [Bytes])
    This function is used to read the data from a file opened with fOpen function.
  - Set $Size=FileLen FilePointer
    This function returns the length of file opened with fOpen, in bytes.
- If statement
  This statement executes the commands inside its structure if the condition specified in it returns TRUE.
  If structure is as follows:-
  If Operand1 Operator Operand2
  ****Commands
  End If
  OR
  If Operand1 Operator Operand2
  ****Commands
  Else
  ****Commands
  End If
  The operators supported with this statement are:-
  - =
    Compares two operands and returns true if they are equal.
  - <>
    Compares two operands and returns true if they are unequal.
  - >
    Comapres two operands and returns true if first is greater than the second.
  - >=
    Compares two operands and returns true if the first is greater than or equal to second.
  - <
    Compares two operands and returns true if the first is less than the second.
  - <=
    Compares two operands and returns true if the first is less than or equal to second.
    '
- Events
  Code written under event tag is executed when the action specified in the event is occured for example code written under Event MessageReceived will only execute when someone sends you a message.
  There are certain variables for every event that bring extra information with the event like $Message variable in the above mentioned event will tell you the message sent to you by your buddy.
  Any code written outside an event is executed immidiately after the script is loaded.
  If the script does not contain any event, it is stopped once all the commands are executed otherwise it is held in the memory and executes unless End command is executed.
  Following are the events and the parameters passed with them:-
  - Name: StatusChanged
    Parameter(s): $Status
    This event is raised when your status is changed and the $Status variable contains the status number
    0 = Online, 1 = Busy, 2 = Be Right Back, 3 = Away, 4 = On The Phone, 5 = Out To Lunch, 6 = Idle, 7 = Appear Offline.
  - Name: NickChanged
    Parameter(s): $Nick
    This event is raised when your nick is changed and the $Nick variable containts your new nickname.
  - Name: ContactStatusChanged
    Parameter(s): $Email, $Nick, $Status
    This event is raised when your contact status changes or comes online with status number in $Status variable and email of the contact in $Email variable.
  - Name: ContactNickChanged
    Parameter(s): $Email, $Nick
    This event is raised when your contact changes nickname which is passed in $Nick variable.
  - Name: IMWindowOpened
    Parameter(s): $Email, $Nick
    This event is raised when someone opens an IM window with you or you open an IM window with someone.
    If someone opens your window, the email and nick of the contact is passed in $Nick and $Email variables.
    If you open an IM window with someone then $EMail contains your email address and the person you open the IM window with can be retreived from (BuddyEmail) alias.
  - Name: MessageReceived
    Parameter(s): $Email, $Nick, $FontName, $FontColor, $FontBold, $FontItalic, $FontStrikethru, $FontUnderline, $Message
    This event is raised when someone sends you an instant message with email, nick, message format and message is passed in the variables mentioned above.
  - Name: MessageSent
    Parameter(s): $Email, $FontName, $FontColor, $FontBold, $FontItalic, $FontStrikethru, $FontUnderline, $Message
    This event is raised when you send an instant message to any of your contacts.
    $Email variable is the email of the person you've sent the message to.
    Note: MessageSent event is not raised for the messages sent under the event.
  - Name: TransferRequest
    Parameter(s): $FileName, $FileSize
    This event is raised when someone attempts to send you a file with $FileName variable containing the name of file and size in $FileSize variable.
  - Name: IMWindowClosed
    Parameter(s): $Email
    This event is raised when someone leaves the conversation or you close the IM window.
    If you close it $Email will contain your email address otherwise it contains the email of the person who left the conversation.
GM Remote Control:-
This feature allows you to use your messenger/PC remotly through a CLI interface.
To use the Remote Control you must start the server at the target GM.
To start the server, cick on Tools>Remote Control on the GM main window.
You must have an account on the remote server which can be created through Remote Control dialog.
When the server is started you need to identify yourself to it using that username and password.
First you need to send a request to GM i.e 'GM Remote Control Request'
The server will then ask you for the username and password.
Once you are logged in, you are then ready to send commands to the server.
Following DOS commands are compatible without switches :-
- Dir
  Shows the files and directories.
- RmDir Directory
  Removes a directory.
- MkDir Directory
  Creates a new directory.
- Copy Source Destination
  Copies a file from source to destination directory.
- Del File
  Deletes a file.
- Ren File NewName
  Renames a file or directory.
- ChDir Directory
  Changes the directory.
- Drive:
  Changes the drive to the letter preceding colon.
Other commands are :-
- Get FilePath
  Retrieves a file from the server.
- Execute File/Executable/URL [Parameters]
  Opens the file/Executes the program/Opens the internet shortcut.
- Msgr ChatWindowCommand
  Sends a chat window command to control the messenger.
- List Online
  Sends the list of online buddies on that messenger.
- List chats
  Sends the list of all active conversations.
- Execute File/Internet Address Parameters
  Opens/Executes the file on the server with optional paramerters.
- Dump File
  Starts putting your messages into a file. To end the file dump send a CrLf (CTRL+ENTER) and '.' in a single message.
- Read File
  Reads the contents of a file.
- Logout
  Logs you out of the server.
- Reboot
  Reboots the server PC.
- Shutdown
  Turns off the server PC.