zydronium/imapsync
1
0
Fork 0
mirror of https://github.com/imapsync/imapsync.git synced 2025-07-23 02:35:54 +02:00
Code Issues Projects Releases Packages Wiki Activity

2.140

Browse source
This commit is contained in:
Nick Bebout 2021-08-04 14:14:36 -05:00
parent 4ce248c075
commit f26b2573c3
370 changed files with 14441 additions and 136699 deletions
Download patch file Download diff file Expand all files Collapse all files

465
index.shtml
View file

@ -23,6 +23,7 @@
<!--
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" />
-->
</head>
<body>
@ -30,19 +31,20 @@
<div id="left-menu">
<ul class="none">
<li><a href="#WHATIS">What is imapsync?</a></li>
<li><big><big><a href="https://i005.lamiral.info/X/" title="Free full service!">Use imapsync online!</a></big></big></li>
<li><big><big><a href="https://imapsync.lamiral.info/X/" title="Free online service under 3 GB">Use imapsync online 24/7! No installation! Free! ( below 3 GB )</a></big></big></li>
<li><a rel="author" href="#AUTHOR">Contact the author, Gilles LAMIRAL</a></li>
<li><a href="S/testimonial.shtml">Testimonials from users</a></li>
<li><a href="#buy_all" class="larger" >Buy <b>imapsync</b> and <b>support</b></a> ( Windows + Linux + OS X + Source )</li>
<li><a href="#CANTDO">What imapsync can't do?</a></li>
<li><a href="#buy_all" class="larger" >Buy <b>imapsync</b> and <b>support</b></a> ( Windows + Linux + Mac OS X ) </li>
<!-- <li><big><a href="http://imapsync.lamiral.info/S/guestbook.shtml">New! Give your feedback via the Guestbook!</a></big></li> -->
<li><a href="http://imapsync.lamiral.info/S/poll.shtml">Vote for a better imapsync and better services</a></li>
<!-- <li><a href="http://imapsync.lamiral.info/S/poll.shtml">Vote for a better imapsync and better services</a></li> -->
<li><a href="#SUPPORT">What <b>support </b></a>is given?</li>
<li><a href="#NUMBERS">Facts and figures</a></li>
<li>Examples:</li>
<li>
<ul class="none">
<li><a rel="help" href="#DOC_BASIC">How to transfer a single mailbox on Windows</a></li>
<li><a rel="help" href="#DOC_BASIC_MAC">How to transfer a single mailbox on Mac OS X</a></li>
<li><a rel="help" href="#DOC_BASIC_UNIX">How to transfer a single mailbox on Unix</a></li>
<li><a rel="help" href="#DOC_MASS">How to transfer many mailboxes</a></li>
</ul>
@ -50,7 +52,7 @@
<li><a rel="help" href="#install">Installation</a></li>
<li><a rel="help" href="#doc" class="larger" >Documentation</a></li>
<li><a href="S/news.shtml">News about imapsync <!--#exec cmd="cat ./VERSION| tr -d '\n'" -->, previous and next releases</a></li>
<li><a href="S/imapservers.shtml">List of the 81 imap software server applications <b>supported</b></a> by imapsync</li>
<li><a href="S/imapservers.shtml">List of the 86 imap software server applications <b>supported</b></a> by imapsync</li>
<li><a href="S/external.shtml">Similar software tools and external services</a></li>
<li><a href="S/mailing_list.shtml">Discuss or search on the mailing-list</a></li>
<li><a href="S/terms_and_conditions.shtml">Imapsync Terms and Conditions</a></li>
@ -66,7 +68,10 @@
<img width="486" height="309" alt="imapsync logo" src="S/images/logo_imapsync.png" />
</a>
<h1>Time to copy all your emails and folders elsewhere!</h1>
<h1>Afraid of losing all your precious emails?<br/>
It's time to copy all of them elsewhere!<br/>
Safely.
</h1>
<!-- I use SSI here only to pass a strict xhtml validation that facebook/twitter/coinbase can't pass -->
<!-- remove space before #include to activate these ssi -->
@ -91,18 +96,18 @@ Imapsync presentation by Gilles
<p>
Imapsync is an <b>IMAP transfers tool</b>.
Imapsync is an <b>IMAP transfer tool</b>.
The purpose of imapsync is to <b>migrate</b> IMAP accounts or to <b>backup</b> IMAP accounts.
IMAP is one of the three current standard protocols used to access mailboxes,
the two other are POP3 and HTTP with webmails,
webmails are often tied to an IMAP server.
IMAP, IMAP4 in fact (started December 1994), is one of the three current standard protocols used to access mailboxes,
the two other being POP3 (started November 1988) and HTTP (started May 1996) with webmails,
webmails are often tied to an IMAP server.
</p>
<p>Latest imapsync published release <!--#exec cmd="cat ./VERSION| tr -d '\n'" -->
<p>The latest imapsync published release <!--#exec cmd="cat ./VERSION| tr -d '\n'" -->
was written on <!--#flastmod file="VERSION" -->
</p>
<p><b>Imapsync</b> software is a command line tool that allows incremental and
<p><b>Imapsync</b> is a command-line tool that allows incremental and
recursive <b>IMAP</b> transfers from one mailbox to another, both anywhere on the internet
or in your local network. Imapsync runs on <b>Windows</b>, <b>Linux</b>, <b>Mac OS X</b>.
@ -111,12 +116,16 @@ and restart it later efficiently, without generating duplicates.
"<b>Recursive</b>" means the complete folders hierarchy can be copied, all folders, all subfolders etc.
"<b>Command line</b>" means it's not a graphical tool, on Windows you have to run imapsync
"<b>Command-line</b>" means it's not a graphical tool, on Windows you have to run imapsync
from a <a href="#DOC_BASIC">batch file</a>.
Anyway there is a visual online service,
you can try imapsync online at <a href="https://i005.lamiral.info/X/">https://i005.lamiral.info/X/</a>
you can try imapsync online at <a href="https://imapsync.lamiral.info/X/">https://imapsync.lamiral.info/X/</a>
</p>
<h2>What imapsync can't do? <a href="#TOP" id="CANTDO"><small>(back to menu)</small></a>
</h2>
<p>
<b>Imapsync can't migrate Contacts and Calendars</b>.
Most email systems don't set or get Contacts or Calendars via the IMAP protocol.
@ -127,17 +136,30 @@ or asking experts at <a href="https://twitter.com/sumatra_dev">Sumatra company<
</p>
<p>
<b>imapsync</b> is not suitable for maintaining a synchronization between two active imap accounts while the user
is working on both sides.
<b>Imapsync is not suitable</b> for maintaining a synchronization <b>between two
active imap accounts</b> while the user is working on both sides.
See why in the <a href="FAQ.d/FAQ.Two_Ways_Sync.txt">Two Ways Sync</a> document.
Use <a href="http://offlineimap.org/"><b>offlineimap</b></a> (written by John Goerzen)
or <a href="http://isync.sourceforge.net/"><b>mbsync</b></a> (written by Michael R. Elkins)
for <b>bidirectionnal (2 ways) synchronizations</b>.
for <b>bidirectional (2 ways) synchronizations</b>.
</p>
<p>
<b>Imapsync can't backup</b> nor <b>restore</b> email messages <b>to or from a local directory</b>.
Imapsync works only with IMAP accounts, which always belong to some IMAP server.
Read the <a href="FAQ.d/FAQ.Archiving.txt">Archiving</a>
document to get several solutions, at least four solutions, to this issue.
</p>
<p>Alternatives to imapsync are listed in the <a href="S/external.shtml"><b>Similar softwares</b></a> section.
</p>
<p>Alternatives to the <a href="https://imapsync.lamiral.info/X/" title="Free online service under 3 GB">imapsync online service</a>
are listed in the <a href="S/external.shtml#ONLINE_OTHERS"><b>External online services</b></a> section.
</p>
<!--
<p>Imapsync used to be free, open and gratis, that was before November 2010.
Now imapsync is free, open and not gratis from the homepage.
@ -210,6 +232,11 @@ See detailed explanation and motivation here when
<p><b>Good feedback is always welcome!</b><br/>
and bad feedback is very often welcome</p>
<p>
It may sounds crazy but I do reply personally to every single email message
I receive, so don't hesitate to spend time writing to me about your email
problems, you're sure to get my attention and my time.
</p>
<h2>Buy imapsync and support <a href="#TOP" id="buy_all"><small>(back to menu)</small></a>
</h2>
@ -245,14 +272,17 @@ See detailed explanation and motivation here when
<ul>
<li>Imapsync <b>full professional support</b> (that costs also &euro;120 EUR by itself, see why below).</li>
<li>Access without any limit to the imapsync online service.
</li>
<li>Standalone <b>imapsync.exe</b> for win32, easy installation done by a zip extraction anywhere.
See <a href="README_Windows.txt">README_Windows.txt</a> for details.</li>
<li>Standalone <b>imapsync_bin_Darwin</b> for Mac OS X. (not Catalina ready because of the new signature mechanism)</li>
<li>Standalone <b>imapsync_bin_Darwin</b> for <a href="INSTALL.d/INSTALL.Darwin.txt">Mac OS X</a>. (Catalina ok with a permission deed)</li>
<li>Imapsync Perl <b>source code</b> for any operating system, Unix, Windows, OS X.</li>
<li>The <b>online visual interface</b>, like <b><a href="https://i005.lamiral.info/X/">/X</a></b>,
<li>The <b>online visual interface</b>, like <b><a href="https://imapsync.lamiral.info/X/">/X</a></b>,
to install the service on a <b>Linux server</b> (not working on Windows yet).</li>
<li><b>Lifetime</b> of imapsync <b>updates</b> without extra payment.</li>
@ -268,15 +298,17 @@ See detailed explanation and motivation here when
<p>
For <b>&euro;120 EUR</b> independently, you get imapsync <b>full professional support</b>,
provided by the imapsync designer and developer, Gilles LAMIRAL, your servitor, who has
been supporting imap migrations with imapsync for more than 18 years (I started in 2001).
been supporting imap migrations with imapsync for more than 19 years (I started in 2001).
See a detailed <a href="#SUPPORT"><b>support description</b></a> below.
</p>
<p>
You may wonder <b>why the support alone is the same price as imapsync+support?</b> it's
because when you buy both at once, I'm not sure I will have to spend some time
directly with you, it's possible that everything will go smoothly for you;
but when you buy the support alone, after buying the software,
You may wonder <b>why the support alone is the same price as imapsync+support?</b>
It's because when you buy both at once, I'm not sure I will have to spend some time
directly with you, it's possible that everything goes smoothly for you,
since this aim is my daily work.
But when you buy the support alone, after buying the software,
then I will surely spend time (any amount of hours) to help you.
Does it seem fair enough?
</p>
@ -289,34 +321,40 @@ Does it seem fair enough?
<input type="hidden" value="H2YTURNFT4XT4" name="hosted_button_id" />
<input type="hidden" value="imapsync choice" name="on0" />
<label class="">Imapsync buying options:
<select name="os0">
<option value="Software + Support. For professional use." class="bold">Software_+_Support. For_professional_use: &euro;120 EUR</option>
<option value="Software only. For professional use." class="bold" >Software_only.______For_professional_use: &euro;60 EUR</option>
<option value="Support only. For professional use." class="" >Support__only.______For_professional_use: &euro;120 EUR</option>
<option disabled="disabled" class="" >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~</option>
<label class=""><big>Imapsync <b>buying options</b></big>, select your choice by <big><b>clicking</b></big> on it:<br /><br />
<select name="os0" size="4" >
<option selected="selected" value="Software + Support. For professional use." class="bold">Software_+_Support. For_professional_use: &euro;120 EUR</option>
<option value="Software only. For professional use." class="" >Software_only.______For_professional_use: &euro;60 EUR</option>
<option value="Support only. For professional use." class="bold" >Support__only.______For_professional_use: &euro;120 EUR</option>
<!-- <option disabled="disabled" class="" >~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~</option> -->
<option value="Software only. For individual use." class="" >Software only.______For_individual___use: &euro;60 EUR</option>
</select>
</label>
<br />
</p>
<p>
Professionals buyers outside France are <b>VAT exempted</b>. Individuals or French buyers are <b>VAT taxed</b>.
<br />
</p>
<p>
<input type="hidden" value="VAT if professional in Europe" name="on1" />
<label>In case <b>you're a European professional</b>, please enter your <b>VAT number</b>
<label>In case <b>you're a European professional buyer</b>, please enter your <b>VAT number:</b>
<input type="text" maxlength="17" size="17" name="os1" />
</label>
it is for accounting and customs declaration.<br />
It is for accounting and customs declaration.<br />
It's ok if you don't have your VAT number right now, I'll email you later for it.<br />
VAT is often 2 letters followed by several digits, for example mine is FR74429303332.<br />
If you're a <b>European</b> and you <b>don't have a VAT number</b>
then select "Software only. For <b>individual</b> use." (it's at the bottom of the buying options, above).<br />
<input type="hidden" value="EUR" name="currency_code" />
<input type="image"
alt="PayPal, a safe and easy way to pay online!"
name="submit"
src="https://www.paypalobjects.com/en_US/i/btn/btn_buynowCC_LG.gif" /><br />
If you <b>can't use Paypal</b> then consider a <b><a href="#IBAN">Bank transfer</a></b>.
or a <b><a href="#crypto">Crypto</a> payment</b>.
src="https://www.paypalobjects.com/en_US/i/btn/btn_buynowCC_LG.gif" />
</p>
<p>
If you <b>can't use Paypal</b> nor <b>a credit card</b> then
consider a <b><a href="#IBAN">Bank transfer</a></b> (I'll give you my IBAN on demand)
or even a <b><a href="#crypto">Crypto</a> payment</b>(very rare indeed so there is a very special offer here).
</p>
</form>
@ -373,7 +411,7 @@ I have been supporting imap migrations with imapsync since 2001, I still enjoy i
<p>If you can't pay with a credit card via Paypal then it is possible to pay via a bank transfer.
</p>
<p>Refund for a bank transfer is far less easy than with Paypal so drop me an email to test imapsync
<p>Refund for a bank transfer is less easier than with Paypal so drop me an email to test imapsync
and to be sure it will do what you need it to do, before any payment.<br />
The bank account references will be given upon request.
</p>
@ -384,10 +422,15 @@ that is 120 EUR.
</p>
<h3>Payment with crypto currencies, Bitcoins, Ethereum etc. <a href="#TOP" id="crypto"><small>(back to menu)</small></a>
<h3 id="bitcoin">Payment with crypto currencies, Bitcoins, Ethereum etc. <a href="#TOP" id="crypto"><small>(back to menu)</small></a>
</h3>
<p>
The funny thing about crypto payments is that I receive very few of them, one or two per year, and in small amount, one or two dollars equivalent...
Maybe one day those little crypto coins will be like gold? (I would like that!)
</p>
<!--
<div>
<a class="buy-with-crypto"
href="https://commerce.coinbase.com/checkout/5e1ad7cb-dd3d-4cda-bbf1-53d8ba94b7b6">
@ -397,9 +440,8 @@ that is 120 EUR.
type="text/javascript">
</script>
</div>
-->
<!--
<div>
<a class="buy-with-crypto"
href="https://commerce.coinbase.com/checkout/d757d82d-5f54-428e-9260-90c8b032d7ce">
@ -409,66 +451,205 @@ that is 120 EUR.
type="text/javascript">
</script>
</div>
-->
<h2>Facts and figures <a href="#TOP" id="NUMBERS"><small>(back to menu)</small></a>
</h2>
<!--
gilles@i005:~/imapsync_stats 14$ date
Tue Jan 12 12:01:08 CET 2021
gilles@i005:~/imapsync_stats 13$ statistics_VERSION_synthesis 2020
==== Nb users each month in 2020
6261 stats_imapsync_2020_01.ip
6660 stats_imapsync_2020_02.ip
6727 stats_imapsync_2020_03.ip
6362 stats_imapsync_2020_04.ip
6841 stats_imapsync_2020_05.ip
6195 stats_imapsync_2020_06.ip
7025 stats_imapsync_2020_07.ip
6221 stats_imapsync_2020_08.ip
6450 stats_imapsync_2020_09.ip
6686 stats_imapsync_2020_10.ip
6929 stats_imapsync_2020_11.ip
6902 stats_imapsync_2020_12.ip
79259 total
==== Nb runs each month in 2020
stats_imapsync_2020_01.runs : 11844697 total
stats_imapsync_2020_02.runs : 10658279 total
stats_imapsync_2020_03.runs : 10691171 total
stats_imapsync_2020_04.runs : 9902899 total
stats_imapsync_2020_05.runs : 9389412 total
stats_imapsync_2020_06.runs : 10841772 total
stats_imapsync_2020_07.runs : 11650852 total
stats_imapsync_2020_08.runs : 10138316 total
stats_imapsync_2020_10.runs : 11040092 total
stats_imapsync_2020_11.runs : 15849476 total
stats_imapsync_2020_12.runs : 12920080 total
==== % Operating systems in 2020
Linux 67.96 %
Win32 18.15 %
Darwin 12.38 %
FreeBSD 1.43 %
Solaris .02 %
OpenBSD .03 %
Cygwin 0.00 %
Unknown 0.00 %
Other .01 %
==== Perl releases in 2020
statistics_perl_from_files_cumul_percentage 48786 stats_imapsync_2020.ip
5.10 2%
5.12 3%
5.14 0%
5.16 35%
5.18 9%
5.20 0%
5.22 1%
5.24 6%
5.26 15%
5.28 11%
5.30 12%
5.31 0%
5.32 0%
5.8 0%
==== Most releases used in 2020
230 1.957
301 1.644
361 1.484
450 1.979
745 1.997
887 1.684
1092 1.998
1175 1.921
1563 1.967
1871 1.836
2273 1.983
2629 1.882
3483 1.945
11019 1.977
17660 1.727
==== Nb users each year
9640 stats_imapsync_2011.ip
26284 stats_imapsync_2012.ip
43336 stats_imapsync_2013.ip
40209 stats_imapsync_2014.ip
41324 stats_imapsync_2015.ip
38837 stats_imapsync_2016.ip
46197 stats_imapsync_2017.ip
44116 stats_imapsync_2018.ip
48103 stats_imapsync_2019.ip
49562 stats_imapsync_2020.ip
3273 stats_imapsync_2021.ip
390881 total
==== Nb runs each year :
2010: 0
2011: 62268134
2012: 73658942
2013: 144573196
2014: 203982027
2015: 178711357
2016: 98243422
2017: 87832226
2018: 108047481
2019: 158971132
2020: 135913391
2021: 4428153
2021~~134689380
Done 2021/01/18
-->
<ul>
<li><b>6000 to 7000 </b>users per month (48000 users a year).</li>
<li>11 to 16 millions mailboxes transfers per month.</li>
<li><b>159 millions</b> transfers for 2019,
that is five whole mailboxes complitely synced per second in average (159*10^6/365/24/3600),
and an estimation of 71 Petabytes ( 1 PiB = 2^50 bytes = 1024^5 ~ 10^15) transferred in total in 2019,
taking a mean of 500 Mbytes per transfer (an estimated mean given by online /X real stats).
71 Petabytes = 500*10^6*159*10^6. The global internet traffic of 2019 was 2004 Exabytes so imapsync
is a very very tiny thing (35 per million).
<li>There are <b>6000 to 7000 </b> imapsync users per month (50 000 users for the year 2021).
Well, if all users could be buyers!
</li>
<li>9 M to 16 M mailboxes transfers per month during 2020.</li>
<li><b>136 M</b> transfers for 2020,
that is <b>4 whole mailboxes completely synced each second</b> on average (136*10^6/365/24/3600 ~ 4),
and an estimation of <b>60 Petabytes transferred in 2020</b> ( 1 PiB = 2^50 bytes = 1024^5 ~ 10^15),
taking a mean of 500 Megabytes per transfer (an estimated mean given by online /X real stats).
60 Petabytes = 500*10^6*136*10^6. The 2020 global internet traffic was 2580 Exabytes
(2580 ~ <a href="https://en.wikipedia.org/wiki/Internet_traffic#Global_Internet_traffic">(174+41)</a> * 12 )
(1 EiB = 2^60 bytes = 1024^6 ~ 10^18) so imapsync is a very very tiny thing (23 per million, 60/2580000).
</li>
<li>
<b>159 millions</b> transfers for 2019.
That's nearly 717 millions email messages transferred by imapsync every day (1600*164/366)
taking a mean of 1600 messages per transfer (an estimated mean given by online /X real stats).
Let's see it another way, imapsync did 136 M transfers for 2020,
that's nearly <b>492 M email messages transferred every day</b> (136*1325/366)
taking a mean of 1325 messages per transfer (an estimated mean given by online /X real stats).
The internet global estimated number of messages sent every day is 300 billions in 2019
(10% being non-spam but that's another story...).
So imapsync does 0.24% of all email trafic, not that bad for a command line tool!
The internet global estimated number of messages sent every day is
<a href="https://www.statista.com/statistics/456500/daily-number-of-e-mails-worldwide/">306 billions</a> in 2020
(55% being spam but that's another story...).
So imapsync does 0.16% (492/306000*100) of all email traffic, not that bad for a command-line tool!
</li>
<li><b>Operating systems</b> run by imapsync users (in 2019):
<li>
See the Wikipedia <a href="https://en.wikipedia.org/wiki/Byte#Multiple-byte_units">Byte page</a> to learn about Petabytes and Exabytes.
</li>
<li><b>Operating systems</b> run by command line imapsync users (in 2020):
<ul>
<li><b>Linux: 68%</b></li>
<li><b>Win32: 18%</b></li>
<li><b>Darwin: 13%</b></li>
<li><b>FreeBSD: 0.92%</b></li>
<li>OpenBSD: 0.05%</li>
<li>Solaris: 0.03%</li>
<li><b>Darwin: 12%</b></li>
<li><b>FreeBSD: 1.43%</b></li>
<li>Solaris: 0.02%</li>
<li>OpenBSD: 0.03%</li>
<li>Other: 0.01%</li>
<li>Cygwin: 0%</li>
<li>Unknown: 0%</li>
<li>Other: 0%</li>
</ul>
</li>
<li><b>Highest use rate</b>: about <b>56 millions</b> of IMAP mailbox transfers by just one host.</li>
<li><b>Biggest known account</b> migrated: <b>2.4 millions folders</b> (figure independently reported).</li>
<li><b>Highest use rate</b>: about <b>56 M</b> IMAP mailbox transfers by just one host (it was in 2014).</li>
<li><b>Biggest known account</b> migrated: <b>2.4 M folders</b> (figure independently reported).</li>
<li><b>Operating systems</b> run by the visual /X online imapsync users:
<ul>
<li><b>Windows 70%</b></li>
<li><b>Macintosh 23%</b></li>
<li><b>Linux 7%</b></li>
</ul>
</li>
<li>Do you notice the reverse statistic pattern between command-line users and visual users?</li>
</ul>
<p>
The figures presented here do not include the github imapsync release usage.
The figures presented here do not include the GitHub imapsync release usage.
It's because --noreleasecheck is on by default since release 1.592 (2014/05/22)
in the github release.
in the GitHub release.
Looking at the numbers before and after 2014, the figures showed here
Looking at the numbers before and after 2014, the figures showed above
could be doubled.
</p>
<p>
Where all those numbers come from?
To know whether a newer imapsync exists or not, imapsync does a http GET to the file
To know whether a newer imapsync exists or not, imapsync does an http GET to the file
<a href="http://imapsync.lamiral.info/VERSION">VERSION</a>.
Via the <b>User-agent</b> parameter it also sends:</p>
<ul>
@ -478,7 +659,7 @@ Via the <b>User-agent</b> parameter it also sends:</p>
<li>Operating System</li>
</ul>
<p>You can <b>remove this behavior</b> by adding option <b>--noreleasecheck</b> on the command line
<p>You can <b>remove this behavior</b> by adding the option <b>--noreleasecheck</b> on the command line
(or by setting $releasecheck = 0 in the source code).
Check <a href="https://nvd.nist.gov/vuln/detail/CVE-2013-4279">CVE-2013-4279</a>.
</p>
@ -489,25 +670,59 @@ Check <a href="https://nvd.nist.gov/vuln/detail/CVE-2013-4279">CVE-2013-4279</a
<p>
After Imapsync installation, a basic (and really working) example in a DOS window is the following: </p>
<pre>.\imapsync.exe ^
--host1 test1.lamiral.info ^
--user1 test1 ^
--password1 "secret1" ^
--host2 test2.lamiral.info ^
--user2 test2 ^
--password2 "secret2"
</pre>
<p>But it's better to edit a batch file and run it by a double-click.
Take this batch file example <b><a href="./examples/imapsync_example.bat">imapsync_example.bat</a></b>
and adapt with your own parameters.
After Imapsync <a rel="help" href="#install">installation</a>, you have to edit a "ready to use" batch file
called <b><a href="./examples/imapsync_example.bat">imapsync_example.bat</a></b>
and run it by a double-click.
This batch file is also in the zip archive so it's useless to download it.
</p>
<p>
I strongly advise you to read and follow the document <a href="README_Windows.txt">README_Windows.txt</a>
</p>
<h2>How to transfer a single mailbox on Mac <a href="#TOP" id="DOC_BASIC_MAC"><small>(back to menu)</small></a>
</h2>
<p>
After Imapsync <a rel="help" href="#install">installation</a>, you have to edit a "ready to use" script file
called <b><a href="./examples/imapsync_example_darwin.sh">imapsync_example_darwin.bat</a></b>
and run it in a shell window.
This script file is also in the tgz archive so it's useless to download it.
</p>
<p>
I strongly advise you to read first and follow the document
<a href="INSTALL.d/INSTALL.Darwin.txt">INSTALL.Darwin.txt</a>
and then the document <a href="doc/TUTORIAL_Unix.html">TUTORIAL_Unix</a>.
</p>
<h2>How to transfer a single mailbox on Linux/Unix <a href="#TOP" id="DOC_BASIC_UNIX"><small>(back to menu)</small></a>
</h2>
<p>
After Imapsync installation, a basic (and really working) example in a shell terminal is the following: </p>
Here after is presented a Linux imapsync command line example. You can try it on a terminal, as is.
Anyway, it's easier to edit a shell script with the same exact command and run this
script in a terminal or from a graphical desktop.
Just take the Bourne shell script example <b><a href="./examples/imapsync_example.sh">imapsync_example.sh</a></b>
and adapt with your own parameters.
This shell script file is also in the tgz archive so it can be useless to download it.
</p>
<p>
I strongly advise you to read and follow the document <a href="doc/TUTORIAL_Unix.html">TUTORIAL_Unix</a>.
</p>
<p>
After Imapsync <a rel="help" href="#install">installation</a>, a basic example in a shell terminal is the following: </p>
<pre>./imapsync \
--host1 test1.lamiral.info \
--user1 test1 \
@ -516,11 +731,8 @@ After Imapsync installation, a basic (and really working) example in a shell ter
--user2 test2 \
--password2 "secret2"
</pre>
<p>
But it's better to edit a shell script and run it in a terminal.
Take this Bourne shell script example <b><a href="./examples/imapsync_example.sh">imapsync_example.sh</a></b>
and adapt with your own parameters.
</p>
<h2>How to transfer many mailboxes <a href="#TOP" id="DOC_MASS"><small>(back to menu)</small></a>
</h2>
@ -541,10 +753,23 @@ it can be used with the two previous command scripts.<br />
All example scripts can be found in the <a href="examples/">examples/*</a> directory.
</p>
<p>
I strongly advise you to read also the following FAQ documents:
</p>
<h2>Installation <a href="#TOP" id="install"><small>(back to menu)</small></a>
<ul>
<li> <a href="FAQ.d/FAQ.Migration_Plan.txt">Migration plan</a>. </li>
<li> <a href="FAQ.d/FAQ.Massive.txt">Massive/bulk migrations</a>. </li>
<li> <a href="FAQ.d/FAQ.Admin_Authentication.txt">Admin authentication</a>. </li>
</ul>
<h2>Installation, Hardware, Operating Systems <a href="#TOP" id="install"><small>(back to menu)</small></a>
</h2>
<p>
Hardware system requirements:
</p>
@ -555,10 +780,25 @@ Hardware system requirements:
<li><b>Any network link</b> is ok. The average bandwidth rate is 345 KiB/s ~ 2.8 Mbps.</li>
</ul>
<p>
<b>Operating System</b> requirements: Imapsync is avalable on Windows, Mac and Linux.<br/>
Which Operating System to chose? <br/>
Use the Operating System <b>you are the most familiar with</b>.
</p>
<p>Depending on the system where you'll run imapsync:</p>
<p>
<b>Location</b> requirements: <br/>
Where to place imapsync? <br/>
<b>Any host</b> in <b>any place</b> is ok for imapsync as long as it
has a <b>network access to both IMAP servers</b>, the source and the destination.
</p>
<p>What to do next?<br/>
Depending on the system where you will run imapsync:</p>
<ul>
<li>Windows users, read directly <a href="README_Windows.txt">README_Windows.txt</a>.</li>
<li>OS X users, read <a href="INSTALL.d/INSTALL.Darwin.txt">INSTALL.Darwin.txt</a>.</li>
@ -574,7 +814,7 @@ Hardware system requirements:
<li>Docker users, read <a href="FAQ.d/FAQ.Docker.txt">FAQ.Docker.txt</a>
or directly the <a href="https://hub.docker.com/r/gilleslamiral/imapsync/">Imapsync Docker page</a>.</li>
<li>Online UI sysadmins, wanting their own <a href="https://i005.lamiral.info/X/">/X</a>,
<li>Online UI sysadmins, wanting their own <a href="https://imapsync.lamiral.info/X/">/X</a>,
read <a href="INSTALL.d/INSTALL.OnlineUI.txt">INSTALL.OnlineUI.txt</a></li>
<li>Other users, read the second part of <a href="INSTALL.d/INSTALL.ANY.txt">INSTALL.ANY.txt</a>.</li>
<li>All installation files are located in the <a href="INSTALL.d/">INSTALL.d/</a> directory.</li>
@ -601,29 +841,38 @@ to understand imapsync and succeed in your migration or backup.
<p>The <a href="FAQ.d/">FAQ.d/*</a> files present Frequently Asked Questions
(and not so frequently asked ones) and their answers. Here is the main menu:</p>
(and not so frequently asked ones) and their answers. Here is the main menu, <b>take at least the time to read the menu</b>,
you will certainly lose some time to read it, two minutes, but reading this menu will most likely <b>save
you some struggling hours later</b>, believe me. So read the three columns main menu:</p>
<div class="list"> Tips about imap server softwares:
<div class="list"><b>Specific</b> imap software <b>servers</b> tips
<ul>
<li> <a href="FAQ.d/FAQ.Gmail.txt">Gmail accounts</a>.
See <a href="https://support.google.com/a/answer/1071518?hl=en">Gmail limits</a>. </li>
<li> <a href="FAQ.d/FAQ.Exchange.txt">Exchange 20xx and Office365</a>. </li>
<li> <a href="FAQ.d/FAQ.Dovecot.txt">Dovecot</a>. </li>
<li> <a href="FAQ.d/FAQ.MailEnable.txt">MailEnable</a>. </li>
<li> <a href="FAQ.d/FAQ.Gmail.txt">Gmail accounts</a>.
See <a href="https://support.google.com/a/answer/1071518?hl=en">Gmail limits</a>.
</li>
<li> <a href="FAQ.d/FAQ.Office365.txt">Office365</a>. </li>
<li> <a href="FAQ.d/FAQ.Exchange.txt">Exchange 20xx</a>. </li>
<li> <a href="FAQ.d/FAQ.Yahoo.txt">Yahoo</a>. </li>
<li> <a href="FAQ.d/FAQ.Domino.txt">Domino</a>. </li>
<li> <a href="FAQ.d/FAQ.Dovecot.txt">Dovecot</a>. </li>
<li> <a href="FAQ.d/FAQ.Zimbra.txt">Zimbra</a>. </li>
<li> <a href="FAQ.d/FAQ.SmarterMail.txt">SmarterMail</a>. </li>
<li> <a href="FAQ.d/FAQ.Kerio.txt">Kerio</a>. </li>
<li> <a href="FAQ.d/FAQ.Oracle-UCS.txt">Oracle-UCS</a>. </li>
<li> <a href="FAQ.d/FAQ.Cyrus.txt">Cyrus</a>. </li>
<li> <a href="FAQ.d/FAQ.UCS.txt">UCS</a>. </li>
<li> <a href="FAQ.d/FAQ.David_Tobit.txt">David Tobit</a>. </li>
<li> <a href="FAQ.d/FAQ.Yandex.txt">Yandex</a>. </li>
<li> <a href="FAQ.d/FAQ.IceWarp.txt">IceWarp</a>. </li>
<li> <a href="FAQ.d/FAQ.DBmail.txt">DBmail</a>. </li>
<li> <a href="FAQ.d/FAQ.FirstClass.txt">FirstClass</a>. </li>
<li> <a href="FAQ.d/FAQ.Various_Software_Servers.txt">Other various imap software servers</a>. </li>
</ul>
</div>
<div class="list">Solving problems:
<div class="list">Solving problems (or not...)
<ul>
<li> <b><a href="FAQ.d/FAQ.Authentication_failure.txt">Authentication failure</a>.</b> </li>
@ -632,8 +881,10 @@ to understand imapsync and succeed in your migration or backup.
<li> <a href="FAQ.d/FAQ.Use_addheader.txt">Why use --addheader</a>? </li>
<li> <a href="FAQ.d/FAQ.Passwords_on_Windows.txt">Passwords on Windows</a>. </li>
<li> <a href="FAQ.d/FAQ.Passwords_on_Unix.txt">Passwords on Unix</a>. </li>
<li> <a href="FAQ.d/FAQ.Passwords_on_Mac.txt">Passwords on Mac</a>. </li>
<li> <a href="FAQ.d/FAQ.Flags.txt">Flags issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Dates.txt">Dates issues</a>. </li>
<li> <a href="FAQ.d/FAQ.Two_Ways_Sync.txt">Two Ways Sync</a>. </li>
<li> <a href="FAQ.d/FAQ.Memory.txt">Memory issue</a>. </li>
<li> <a href="FAQ.d/FAQ.APPEND_errors.txt">Append errors</a>. </li>
<li> <a href="FAQ.d/FAQ.Messages_Too_Big.txt">How to transfer too big messages</a>. </li>
@ -645,7 +896,7 @@ to understand imapsync and succeed in your migration or backup.
</ul>
</div>
<div class="list">Various tips:
<div class="list">Various tips
<ul>
<li> <a href="FAQ.d/FAQ.Migration_Plan.txt">Migration plan</a>. </li>
@ -664,8 +915,9 @@ to understand imapsync and succeed in your migration or backup.
<li> <a href="FAQ.d/FAQ.Security.txt">Security</a>. </li>
<li> <a href="FAQ.d/FAQ.Emptying.txt">Emptying an account</a>. </li>
<li> <a href="FAQ.d/FAQ.XOAUTH2.txt">XOAUTH2 (Gmail)</a>. </li>
<li> <a href="FAQ.d/FAQ.OnlineUI.txt">Online Visual Inferface (the web GUI /X)</a>. </li>
<li> <a href="FAQ.d/FAQ.OnlineUI.txt">Online Visual Interface (the web GUI /X)</a>. </li>
<li> <a href="FAQ.d/FAQ.Principles.txt">Principles and design ideas</a>. </li>
<li> <a href="FAQ.d/FAQ.Bandwidth.txt">Bandwidth used by Imapsync</a>. </li>
<li> <a href="FAQ.d/FAQ.GDPR.txt">GDPR</a> (General Data Protection Regulation). </li>
<li> <a href="FAQ.d/FAQ.Docker.txt">Using Docker.</a> </li>
</ul>
@ -719,8 +971,13 @@ like written in the <a href="LICENSE">https://imapsync.lamiral.info/LICENSE</a>
<!--#config timefmt="%D" -->
<!--#config timefmt="%A %B %d, %Y" -->
<b>This document last modified on <!--#echo var="LAST_MODIFIED" --></b>
($Id: index.shtml,v 1.443 2020/01/02 23:37:20 gilles Exp gilles $)<br />
($Id: index.shtml,v 1.499 2021/06/08 09:57:27 gilles Exp gilles $)<br />
<a href="#TOP">Top of the page</a>
</p>
<div>
<img src="https://static.scarf.sh/a.png?x-pxid=28b508c3-c51f-4109-9b88-29f3f6e4cf2f" alt="Scarf Tracker" />
</div>
</body>
</html>