GmailSync

A script to facilitate migration of mail from one Gmail account to another. During the migration all To, From, Cc and Bcc headers matching the old account are rewritten to match the new account.

• Requirements
• Synopsis
• Changelog

Requirements

• imapsync - IMAP transfers tool, see http://imapsync.lamiral.info
• mail - a command line mail utility used to send and receive mail

Synopsis

gmailsync [options] [argument]

A wrapper around imapsync to help with migration of gmail accounts.

    Options                 All options are optional and
    -------                 can be supplied in any order.

    Server connection details:

    -i --imapsync=path      Location of the imapsync script
    -t --timeout=seconds    Timeout between server operations

    Source properties (from):

    --user1=username        Account username (gmail address)
    --pass1=password        Account password
    --host1=hostname        Hostname or IP address
    --port1=number          Port on which IMAP is listening

    Target properties (to):

    --user2=username        Account username (gmail address)
    --pass2=password        Account password
    --host2=hostname        Hostname or IP address
    --port2=number          Port on which IMAP is listening

    Generic output options:

    -r --report=email       Email activity log to this address
    -l --log=path           Log output to a file
    -q --quiet              Suppress output of the script
    -? --help               Display this help message
    --version               Script and BASH version info

    Arguments               All arguments are optional and
    ---------               can be supplied in any order.

    A list of folders (space separated) which are to be
    synchronise between the accounts.

<> - required parameters    [] - optional parameters
Use 'less ${0}' to view further documentation.

Changelog

• 1.2.1

  • Bumped version number to get releases working on GitHub.
  • Updated documentation.

• 1.2.0

  • The script no longer deletes it's log file
  • Default values for all options can now be set by defining a GMAILSYNC_LONG_OPTION_NAME variables (all caps). For example, defining export GMAILSYNC_IMAPSYNC=/bin/true will use /bin/true as the default value for --imapsync option.

• 1.1.0

  • Added a user friendly help message and support for command line parameters. Improved error handling: the script now exit with error code as per shell standard, all error messages are logged via STDERR.

• 1.0.0

  • Initial release of the code.