1
0
mirror of https://github.com/imapsync/imapsync.git synced 2024-11-17 00:02:29 +01:00
imapsync/README_Windows.txt

105 lines
3.7 KiB
Plaintext
Raw Normal View History

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