2015-05-28 19:04:57 +02:00
|
|
|
# $Id: README_Windows.txt,v 1.5 2015/03/26 04:27:39 gilles Exp gilles $
|
2014-05-30 03:56:21 +02:00
|
|
|
#
|
|
|
|
# README_Windows.txt file for imapsync
|
|
|
|
# imapsync : IMAP sync and migrate tool.
|
|
|
|
|
|
|
|
WINDOWS
|
|
|
|
=======
|
|
|
|
|
|
|
|
Two ways to install and use imapsync on Windows systems: A) or B).
|
|
|
|
|
|
|
|
Standard users should only take the A) way.
|
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
Developers, users that want to build their own imapsync.exe
|
2014-05-30 03:56:21 +02:00
|
|
|
or modify it, have to consider the B) way.
|
|
|
|
|
|
|
|
A) Simplest way
|
|
|
|
---------------
|
|
|
|
|
|
|
|
A.1) Get imapsync.
|
|
|
|
|
|
|
|
Buy imapsync at http://imapsync.lamiral.info/
|
|
|
|
You'll then have access to a zip archive file named imapsync_1.xxx.zip
|
|
|
|
where 1.xxx is the imapsync release number.
|
|
|
|
|
|
|
|
A.2) Extract the zip file in a folder where you'll work with imapsync
|
|
|
|
|
|
|
|
You can work on the Desktop since the zip file extraction creates
|
2015-05-28 19:04:57 +02:00
|
|
|
a unique folder named imapsync_1.xxx (where 1.xxx is the imapsync
|
2014-05-30 03:56:21 +02:00
|
|
|
release number).
|
|
|
|
|
|
|
|
A.3) Check the folder
|
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
In the folder extracted imapsync_1.xxx you see 6 files and 2 directories:
|
2014-05-30 03:56:21 +02:00
|
|
|
|
|
|
|
* README_Windows.txt is the current file you are reading
|
|
|
|
* imapsync_example.bat is a batch file example you will copy and edit
|
|
|
|
* sync_loop_windows.bat is a batch file example for syncing many accounts
|
2015-05-28 19:04:57 +02:00
|
|
|
* FAQ.txt contains many useful tips, too many so I started
|
|
|
|
* FAQ.d/* to split them in FAQ.d/ folder.
|
|
|
|
FAQs are a must read when something goes wrong.
|
2014-05-30 03:56:21 +02:00
|
|
|
* README.txt imapsync general documentation.
|
|
|
|
* imapsync.exe is the imapsync binary. You don't have to run it directly.
|
2015-05-28 19:04:57 +02:00
|
|
|
* Cook/ is the directory to build imapsync.exe from its source.
|
2014-05-30 03:56:21 +02:00
|
|
|
|
|
|
|
You can copy or rename imapsync_example.bat as you wish as long as
|
|
|
|
its extension remains ".bat". On Windows systems .bat extension
|
|
|
|
means "I'm a batch script". Same thing for sync_loop_windows.bat.
|
|
|
|
The batch scripts have to stay with imapsync.exe because
|
|
|
|
of the way they call it, they use ".\imapsync.exe", so
|
2015-05-28 19:04:57 +02:00
|
|
|
let them be in the same directory (or change the path if you
|
|
|
|
understand what you're doing).
|
2014-05-30 03:56:21 +02:00
|
|
|
|
|
|
|
For the rest of this documentation I assume you copied
|
|
|
|
imapsync_example.bat to a file named imapsync_stuff.bat
|
|
|
|
|
|
|
|
A.4) Edit the batch file
|
|
|
|
|
|
|
|
Edit imapsync_stuff.bat and change the values with yours.
|
|
|
|
In order to edit it you have do a right click on it and select "modify"
|
|
|
|
in the list presented in the small window menu.
|
|
|
|
Notepad is a good editor to modify it,
|
|
|
|
Office Word is not good for that job.
|
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
Files FAQ.txt and FAQ.d/* contain many tips and special options sometimes
|
2014-05-30 03:56:21 +02:00
|
|
|
needed by specific imap server softwares like Exchange or Gmail.
|
|
|
|
|
|
|
|
A.5) Run the batch file
|
|
|
|
|
|
|
|
To run imapsync with your values just double-clic on
|
2015-05-28 19:04:57 +02:00
|
|
|
the batch file imapsync_stuff.bat
|
2014-05-30 03:56:21 +02:00
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
You do not need to have administrator privilege to run imapsync.
|
2014-05-30 03:56:21 +02:00
|
|
|
|
|
|
|
A.6) Loop on A.5) A.6)
|
|
|
|
|
|
|
|
Loop the process of editing and running imapsync until
|
|
|
|
you solve all issues and all values suit your needs.
|
|
|
|
|
|
|
|
A.7) Look the sync running. You can abort it at any time with a ctrl-c.
|
|
|
|
|
|
|
|
A.8) When the sync is finished you can find the whole log of the output
|
|
|
|
in the folder named "LOG_imapsync", the logfile name is based
|
2015-05-28 19:04:57 +02:00
|
|
|
on the launching date, hour, minute, second and the user2 parameter,
|
|
|
|
one logfile per run.
|
2014-05-30 03:56:21 +02:00
|
|
|
The logfile name is printed at the end of the imapsync run.
|
|
|
|
If you do not want logging in a file use option --nolog
|
|
|
|
|
|
|
|
|
|
|
|
B) Hard way. It is the hard way because it installs all software
|
2015-05-28 19:04:57 +02:00
|
|
|
dependencies. This is the way for modifying imapsync.exe if needed.
|
2014-05-30 03:56:21 +02:00
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
B.1) Install Perl if it isn't already installed.
|
2014-05-30 03:56:21 +02:00
|
|
|
Strawberry Perl is a very good candidate
|
|
|
|
http://strawberryperl.com/
|
2015-05-28 19:04:57 +02:00
|
|
|
I use 5.16 (March 2015) but later releases should work (5.18 and 5.20 do)
|
2014-05-30 03:56:21 +02:00
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
B.2) Go into the Cook/ directory
|
|
|
|
B.3) Double-clic build_exe.bat
|
2014-05-30 03:56:21 +02:00
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
It should create a binary imapsync.exe in the current Cook/ directory.
|
2014-05-30 03:56:21 +02:00
|
|
|
|
2015-05-28 19:04:57 +02:00
|
|
|
B.4) Move imapsync.exe in the upper directory and follow instructions
|
|
|
|
from A.3) to A.8)
|
2014-05-30 03:56:21 +02:00
|
|
|
|