GetByMail gives you a unique ability to have access to remote PC from any home PC and vice versa simply through e-mail accounts.

For example if you have Remote PC and several Home PCs: Home1 PC, Home2 PC and Home3 PC.

Every PC should have a unique e-mail address. In our example, we have the following e-mail addresses: remote@remote.com, home1@home.net, home2@home.net and home3@home.net.

GetByMail should be installed on every PC (unless you don't Use Command Line) and configured like a standard e-mail client (Microsoft Outlook Express, Eudora etc) to work with an appropriate e-mail account.

One additional configuration step is needed on Remote PC: add Home PCs e-mail addresses to Remote PC Members list and grant appropriate remote access rights to those addresses.

Now Home PCs could access Remote PC sending specially prepared e-mail "requests" to remote@remote.com e-mail address and receiving e-mail "responses" sent to Home PCs e-mail addresses. During this communication process Remote PC checks every Home PC e-mail request and if the request "From" address is not found in Remote PC Members list than ERROR response sent back. For example, if home3@home.net e-mail address of Home3 PC is not added to Remote PC Members list than any Home3 PC request will be rejected by Remote PC (see image).

This chapter provides an overview of practical steps that should be taken to establish a connection between your home and remote computers.

First of all, you should have two e-mail accounts: home computer e-mail account and remote computer e-mail account. If you have the home computer e-mail account with home@home.net e-mail address and the remote computer e-mail account with remote@remote.com e-mail address. To establish a connection between the home and remote computers, next configuration steps should be done.

REMOTE COMPUTER

Step 1: Install GetByMail on the remote computer.

Step 2: Configure GetByMail on the remote computer to work with the remote computer e-mail account.

The remote computer e-mail address will appear in the program "Local Address" field.

NOTE: Read more about "Local Mail Configuration" here.

Step 3: Start GetByMail on the remote computer (see Start Service).

Step 4: Add your home computer e-mail address to the remote computer user list with a help of "Security Manager" from menu Tools->Security Manager...

To add your home computer address to the members list press "Add new user" button . In the "New User" dialog enter your home computer e-mail address.

Press "OK" and your new user record will be added to the members list.

By default the new user has rights to execute "Change Dir" and "Download" commands on the remote computer. You could add/remove user rights editing appropriate columns in the list.

Share some disks or folders on the remote computer to be used by the home computer. Press "Add new folder" button , enter/select the full path to the disk or folder and give it an original alias that will be seen by the home computer user.

Press "OK" and the new folder record will be added to the list.

GetByMail supports anonymous authentication mechanism similar to that used in FTP. If anonymous authentication is enabled any person could have access to the remote computer without the need to be a member.

To enable anonymous authentication go to "Anonymous" tab and press "Enable anonymous" button .

Anonymous users have rights to execute "Change Dir" and "Download" commands on the remote computer. You could add/remove anonymous rights editing appropriate columns in the list. You could publish some disks or folders on the remote computer to be used by anonymous users.

HOME COMPUTER

Step 1: Install GetByMail on the home computer.

Step 2: Configure GetByMail on the home computer to work with the home computer e-mail account.

The home computer e-mail address will appear in the program "Local Address" field.

NOTE: Read more about "Local Mail Configuration" here.

Step 3: Start GetByMail on the home computer (see Start Service).

Step 4: Enter your remote computer e-mail address in GetByMail "Remote Address" field and press "Connect" button.

NOTE: Do not forget to select "Anonymous" checkbox if you want to connect as anonymous user.

New connection thread will appear in "Client Threads" list.

Wait on the remote computers response. The time between request and response depends on the type of home and remote computers local mail configurations. The fastest connection achieved by the Microsoft Exchange Server mail configurations on the both sides. Medium time (down to 10 seconds) achieved if one side has Microsoft Exchange Server mail configuration and the other side has Internet E-mail (POP3/IMAP/SMTP) configuration. Finally the slowest connection (down to 20 seconds) is use between Internet E-mail (POP3/IMAP/SMTP) configured home and remote computers. Connection time depends not only on the e-mail account configurations but also on general network functionality, e-mail server antivirus activity etc...

If the connection is successfully established the connection thread changes its status from "Active" to "Done" and the remote computers shared folders are shown in the applications right window.

Enjoy access to your remote computer:).

You could try GetByMail locally (no remote computers are needed)!

You could upload/download your files from one folder to another on your home computer and all the operations are done through your home computer e-mail account. It's not the best way to operate on your home computer but it helps you to appreciate the functionality of GetByMail right after installation.

EXCEPTION: Self connection test could not be provided with Gmail account.

To perform "self connection" test you should do the next steps.

Step 1: Install GetByMail on the home computer if not yet installed.

Step 2: Configure GetByMail on the home computer to work with the home computer e-mail account if not yet configured (see Local Mail Configuration).

Step 3: Start GetByMail on the home computer if not yet started (see Start Service).

Step 4: Now imagine that your "home" computer is "remote" one. Add your home computer e-mail address (home@home.net for example) to the user list with a help of "Security Manager" from menu Tools->Security Manager... Press "Add new user" button and enter your home computer e-mail address. By default the new user has rights to execute Change Dir and Download commands. You could add/remove user rights editing appropriate columns in the list. Share some disks or folders to be used by the "home" computer. Press "Add new folder", enter/select the full path to the disk or folder and give it an original alias that will be seen by the "home" computer user.

Finally Security Manager should look like this:

Step 5: Now you are back at "home". Enter your "remote" computer e-mail address that in fact is your home computer e-mail address in GetByMail "Remote Address" field and press "Connect"...

New connection thread will appear in "Client Threads" list. After a while new response thread will appear in "Server Threads" list. Now wait until response come back and updates your connection thread in "Client Threads" list with "Done" state.

Enjoy "remote access" to your home computer:).

It is recommended to perform "self connection" tests on your home and remote computers before establishing a real home-remote communication (see Get Connection).

To connect a remote PC, it is not necessary to install GetByMail on both local and remote computers. GetByMail supports command line interpreter for some commands sent to remote PC from any e-mail client (Outlook Express, Eudora etc.) or web mail application. One simply needs to have GetByMail installed on a remote PC with enabled Cmd Line option for chosen Members and/or Anonymous User in Security Manager. By default, Cmd Line option is deactivated.

Command line interpreter (if activated) supports the following commands:

• Change Dir
• Download
• Rename
• Make Dir
• Delete
• Screen
• Run
• Shutdown
• Reboot
• LogOff

To connect a remote PC from anywhere in the world using any possible e-mail client or web mail application, undertake the following steps.

REMOTE COMPUTER

Configure remote GetByMail to work with a remote PC unique e-mail address (remote@remote.com for example). See Local Mail Configuration chapter for more details.

Start GetByMail, if not yet started (see Start Service).

Add your home computer (home@home.net for example) or any other e-mail address to the remote computer Members list in Security Manager. Select Cmd Line checkbox to activate command line interpreter for added Members.

You can also activate Cmd Line option for Anonymous User.

HOME COMPUTER

One simply needs to have access to e-mail account with address registered in remote PC Security Manger and ability to send e-mails using this account. For example you can use e-mail client configured to work with home@home.net address account (the address was registered in Security Manger of remote PC GetByMail). You can also use any web mail account like Gmail with address preliminary registered on a remote side.

To send a command, create a new e-mail with Subject and Message fields filled respectively, send it to remote PC address and wait for response.

Each command is followed by its syntax. Angled brackets indicate a required parameter and square brackets an optional parameter.

Change Dir

"Change Dir" command allows you to change and list a directory content on a remote computer.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$><remote path>>list
Message:

Example 1

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>list
Message:

This command returns the list of shared folders (disks) on a remote PC. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>list>Done
Message:	20061008172234337: MyMusic Disk Docs Disk

Example 2

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic>list
Message:

This command returns the list of MyMusic folder content on a remote PC. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic>list>Done
Message:	20061008182234336: .. Jazz Folder song1.mp3 File 1895KB song2.mp3 File 1701KB

Example 3

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic\Jazz>list
Message:

This command returns the list of MyMusic\Jazz folder content on a remote PC. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic\Jazz>list>Done
Message:	20061008192234331: .. jazzsong1.mp3 File 1567KB jazzsong2.mp3 File 1891KB

Download

"Download" command helps you download files and/or directories from a remote computer onto a local computer.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$>Host>download
Message:	<file1 or folder1 to download> .. <fileN or folderN to download>

IMPORTANT: <file1 or folder1 to download> ... <fileN or folderN to download> items should begin in first and N line of e-mail message box respectively. File or folder names should contain full path on a remote PC. Folder names should end with "\*.*" strings.

Example

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>download
Message:	MyMusic\Blues\*.* MyMusic\song2.mp3

This command zips Blues folder and song2.mp3 file located in MyMusic folder on a remote PC and creates PKZip compatible spanned zip files (the volume size is defined in GetByMail Tools->Options->Message Options). Next each volume is sent back as attachment. For example we could obtain two response e-mails as follows:

E-mail 1

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>download>Done
Message:	20070812220534101.1789099.2: Spanned zip volumes are compatible with PKZip format. Place all volumes tothe same folder, rename "disk.zip_" volume to "disk.zip" and startextraction process using any PKZip compatible utility. For example you could download and use free ZIP Reader by PKWARE: http://www.download.com/ZIP-Reader/3000-2250_4-10363714.html
Attachment:	disk.z01 (0.99 MB)

E-mail 2

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>download>Done
Message:	20070812220534101.1789099.2: Spanned zip volumes are compatible with PKZip format. Place all volumes tothe same folder, rename "disk.zip_" volume to "disk.zip" and startextraction process using any PKZip compatible utility. For example you could download and use free ZIP Reader by PKWARE: http://www.download.com/ZIP-Reader/3000-2250_4-10363714.html
Attachment:	disk.zip_ (0.78 MB)

Each response e-mail contains detailed instruction how to extract spanned zip files content.

NOTE: the first line of each response e-mail message contains the same important information:

<unique message ID>.<total size of spanned zip files>.<total number of spanned zip files>

In our example 20070812220534101.1789099.2 means that we should receive two spanned zip files of total size 1789099 bytes before starting extraction process.

Rename

"Rename" command allows you to rename any file or folder on a remote PC.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$><remote path>>rename
Message:	<old file or folder name> <new file or folder name>

IMPORTANT: <old file or folder name> and <new file or folder name> items should begin in first and second line of e-mail message box respectively.

Example 1

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic\Jazz>rename
Message:	jazzsong1.mp3 new_jazzsong1.mp3

This command renames jazzsong1.mp3 file located in MyMusic\Jazz folder on a remote PC into new_jazzsong1.mp3 file. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic\Jazz>rename>Done
Message:	20061008202234311: .. new_jazzsong1.mp3 File 1567KB jazzsong2.mp3 File 1891KB

Example 2

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic>rename
Message:	Jazz NewJazz

This command renames Jazz folder located in MyMusic folder on a remote PC into NewJazz folder. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic>rename>Done
Message:	20061008212234323: .. NewJazz Folder song1.mp3 File 1895KB song2.mp3 File 1701KB

Make Dir

"Make Dir" command allows you to create a directory on a remote computer.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$><remote path>>make
Message:	<new folder name>

IMPORTANT: <new folder name> item should begin in first line of e-mail message box.

Example

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic>make
Message:	Blues

This command creates Blues folder located in MyMusic folder on a remote PC. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic>make>Done
Message:	20061008232234329: .. Blues Folder Jazz Folder song1.mp3 File 1895KB song2.mp3 File 1701KB

Delete

"Delete" command helps you delete any unnecessary files and /or folders on a remote computer.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$><remote path>>delete
Message:	<file1 or folder1 to remove> .. <fileN or folderN to remove>

IMPORTANT: <file1 or folder1 to remove> ... <fileN or folderN to remove> items should begin in first and N line of e-mail message box respectively. File or folder names should contain full path on a remote PC. Folder names should end with "\*.*" strings.

Example

From:	home@home.net
To:	remote@remote.com
Subject:	$>MyMusic>delete
Message:	MyMusic\Blues\*.* MyMusic\song2.mp3

This command removes Blues folder and song2.mp3 file located in MyMusic folder on a remote PC. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>MyMusic>delete>Done
Message:	20061008262234327: .. Jazz Folder song1.mp3 File 1895KB

Screen

"Screen" command allows you to obtain a remote computer desktop screen.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$>Host>screen
Message:

Example

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>screen
Message:

Basically, this command is similar to the Download command. Screen image is zipped and sent back as attachment. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>screen>Done
Message:	20070813220534156.89575.1: Rename "disk.zip_" file to "disk.zip" and start extraction process usingany unzip utility like PKZip, WinZip, 7-Zip etc.
Attachment:	disk.zip_ (0.09 MB)

Response e-mail contains detailed instruction how to extract screen image from attached file.

Run

"Run" command allows you to run applications on a remote computer.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$>Host>run
Message:	<file to run/open on remote PC> [show state] [parameters]

Run command options

[show state] - specifies how the application is to be shown when it is run/opened. The next show state constants are supported:

• Hide
• ShowNormal
• ShowMinimized
• ShowMaximized
• Maximize
• ShowNoActivate
• Show
• Minimize
• ShowMinNoActive
• ShowNA
• Restore
• ShowDefault

[parameters] - specifies parameters to be passed to the application.

IMPORTANT: <full path of file to run/open on a remote PC>, [show state] and [parameters] items should begin in new line of e-mail message box. File name should contain full path on a remote PC.

Example 1

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>run
Message:	MyMusic\song1.mp3

This command opens MyMusic\song1.mp3 file on a remote PC with default mp3 player (for example, WinAmp). No optional parameters are supplied, so the default mp3 player starts in ShowNormal state. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>run>Done
Message:	20061008512234323:

Example 2

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>run
Message:	MyBatches\sendmail.bat ShowMinimized -a test@address.com -s testSubject -m testMessage

This command runs MyBatches\sendmail.bat file on a remote PC with "-a test@address.com -s testSubject -m testMessage" input parameter string. Batch file executes in ShowMinimized console state. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>run>Done
Message:	20061008232234456:

Shutdown, Reboot and LogOff

"Shutdown" command allows you to shutdown a remote computer. "Reboot" command allows you to reboot a remote computer. "LogOff" command allows you to logoff the current logged on user on a remote PC.

Command line syntax

From:	<e-mail address registered in Security Manager of remote PC>
To:	<remote PC e-mail address>
Subject:	$>Host><one of the three possible commands>
Message:	<one of the three possible commands> [force all applications to close on execute] [message dialog timeout value in seconds]

<one of the three possible commands> - shutdown, reboot or logoff command.

[force all applications to close on execute] - false or true value. If not supplied, the default false value is used.

[message dialog timeout value in seconds] - if not supplied, the default 5 seconds timeout value is used.

IMPORTANT: <one of the three possible commands>, [force all applications to close on execute] and [message dialog timeout value in seconds] parameters should be placed in first line of e-mail message box and separated by white spaces.

Example 1

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>shutdown
Message:	shutdown true 30

This command shutdowns a remote PC in 30 seconds. All remote applications are forced to be closed on shutdown. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>shutdown>Done
Message:	20061008612234323:

Example 2

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>reboot
Message:	reboot true

This command reboots remote PC in 5 seconds. All remote applications are forced to be closed on reboot. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>reboot>Done
Message:	20061008712234326:

Example 3

From:	home@home.net
To:	remote@remote.com
Subject:	$>Host>logoff
Message:	logoff

This command logoffs current logged on user on a remote PC in 5 seconds without forcing all applications to be closed. Response e-mail is as follows:

From:	remote@remote.com
To:	home@home.net
Subject:	!>Host>logoff>Done
Message:	20061008912234327:

On GetByMail first run, you will be presented with a Local Mail Configuration wizard screen. Go step by step and configure GetByMail like a standard e-mail client (Microsoft Outlook Express, Eudora etc) to work with your local e-mail account. Alternatively you could configure local mail settings with the help of Local Mail Configuration dialog under Tools->Local Mail Configuration->Dialog...

The Local Mail Configuration dialog contains the same fields as the Local Mail Configuration wizard.

Example1: Custom ISP e-mail configuration.

Example2: Google's Gmail configuration.

IMPORTANT: Don't forget to enable POP in your Gmail account!

IMPORTANT: For German and UK users (and users with internet connection routed through Germany or UK) POP3 and SMTP servers should be changed on:

pop.gmail.com -> pop.googlemail.com
smtp.gmail.com -> smtp.googlemail.com

To activate GetByMail start it from menu File->Start

or press "Start" button on toolbar .

If local mail configuration is proper and your ISP mail server is not down GetByMail is ready to receive remote commands and send its own. "Stop" button is enabled and tray icon is turn to be green.

Need more information? Please, read GetByMail Help, FAQ or download Manuals.