• Syncthing https://syncthing.net
• Dropbox https://dropbox.com یا یکی از بی‌شمار سرویس‌های مشابه آن
• unison https://www.cis.upenn.edu/~bcpierce/unison
• صرفاً git به همراه یک sshd.

• مشابه todo.txt، برنامهٔ Dropbox و ابزارهای مشابه آشکارا از محتوای فایل‌ها بی‌خبر هستند (نسبت به محتوا ناآگاهند). اگر فایلی در هر دو طرف تغییر کرده باشد، Dropbox صرفاً هر دو نسخه را در هر دو طرف کپی می‌کند.

  این ایده زمانی خوب است که کاربر مستقیماً با فایل‌سیستم تعامل داشته باشد و خود قادر به حل تداخل‌ها باشد. اما در اینجا ممکن است منجر به رفتار اشتباه در برنامه‌هایی نظیر khal شود، زیرا اکنون دو رویداد با UID یکسان وجود دارند.

  این نکته در مورد git صدق نمی‌کند: این ابزار قابلیت‌های ادغام بسیار خوبی دارد، حتی بهتر از آنچه vdirsyncer در حال حاضر ارائه می‌دهد.

• چنین ساختاری اصلاً بر روی تلفن‌های هوشمند کار نمی‌کند. از سوی دیگر، vdirsyncer با سرورهای CardDAV/CalDAV همگام‌سازی می‌کند، سرورهایی که می‌توان از طریق برنامه‌هایی مانند DAVx⁵ https://www.davx5.com یا سایر برنامه‌های پیش‌فرض موجود در تلفن‌های هوشمند به آن‌ها دسترسی داشت.

• Arch Linux https://archlinux.org/packages/extra/any/vdirsyncer
• Ubuntu و Debian، فقط برای x86_64 https://packagecloud.io/pimutils/vdirsyncer (بسته‌ها در مخازن رسمی نیز موجود هستند اما ممکن است قدیمی باشند)
• GNU Guix https://packages.guix.gnu.org/packages/vdirsyncer
• macOS (homebrew) https://formulae.brew.sh/formula/vdirsyncer
• NetBSD https://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/time/py-vdirsyncer/index.html
• OpenBSD http://ports.su/productivity/vdirsyncer
• Slackware (اسکریپت SlackBuild در Slackbuilds.org) https://slackbuilds.org/repository/15.0/network/vdirsyncer

• Python نسخهٔ 3.9 تا 3.14 و pip.
• libxml و libxslt
• zlib
• Linux یا macOS. سیستم‌عامل Windows پشتیبانی نمی‌شود، گزارش شمارهٔ #535 را در https://github.com/pimutils/vdirsyncer/issues/535 ببینید.

•

گزینهٔ --ignore-installed برای دور زدن بسته‌های احتمالاً معیوب دبیان (Debian) است (خطاهای ImportError مرتبط با Requests را در <#debian-urllib3> ببینید).

• همهٔ بسته‌های پایتون را به‌طور جداگانه و بدون اتکا به بسته‌های سیستم در ~/vdirsyncer_env/ نصب می‌کند. این کار مشکلات خاص سیستم‌عامل یا توزیع را دور می‌زند.
• برای حذف کامل vdirsyncer می‌توانید ~/vdirsyncer_env/ را حذف کنید.

• فایلی که متغیر محیطی VDIRSYNCER_CONFIG به آن اشاره می‌کند.
• ~/.vdirsyncer/config.
• $XDG_CONFIG_HOME/vdirsyncer/config که معمولاً ~/.config/vdirsyncer/config است. مشخصات XDG-Basedir http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html#variables را ببینید.

1.

vdirsyncer یک پیام خطا نمایش می‌دهد (پیش‌فرض)؛

2.

vdirsyncer یکی از نسخه‌ها را به جای دیگری انتخاب می‌کند؛

3.

vdirsyncer دستور انتخابی شما را اجرا می‌کند که وظیفه دارد دو نسخه متفاوت را ادغام کند.

• "from a"، "from b": جای‌بانی برای تمام مجموعه‌هایی که هنگام اجرای vdirsyncer discover در سمت A/B یافت می‌شوند.
• null: پارامترهای داده‌شده به مخزن دقیق هستند و نیازی به کشف (discovery) ندارند.

تمام پیکربندی‌های SSL به‌ازای هر فضای ذخیره‌سازی انجام می‌شود.

[storage foo]
type = "caldav"
...
auth_cert = ["/path/to/certificate.crt", "/path/to/key.key"]

تغییر یافته در نسخه 0.7.0: پیکربندی گذرواژه به‌طور کامل دگرگون شده است.

برنامه Vdirsyncer می‌تواند گذرواژه‌ها را از چندین منبع دیگر به‌جز فایل پیکربندی دریافت کند.

password.fetch = ["command", "keyring", "get", "example.com", "foouser"]

همچنین می‌توانید به سادگی گذرواژه را به صورت تعاملی درخواست کنید:

[storage foo]
type = "caldav"
username = "myusername"
password.fetch = ["prompt", "Password for CalDAV"]

•

status_path: دایرکتوری‌ای که vdirsyncer برخی داده‌های اضافی را برای همگام‌سازی بعدی در آن ذخیره می‌کند.

این داده‌ها برای تشخیص این موضوع لازم است که آیا یک آیتم جدید به این معناست که در یک طرف اضافه شده یا در طرف دیگر حذف شده است. مسیرهای نسبی نسبت به دایرکتوری فایل پیکربندی تفسیر خواهند شد.

برای مشاهدهٔ جزئیات آنچه دقیقاً در آنجا قرار دارد، مقالهٔ «الگوریتم همگام‌سازی ساده» را در https://unterwaditzer.net/2016/sync-algorithm.html ببینید.

• نام‌های جفت (Pair names) می‌توانند از هر نویسهٔ الفبایی-عددی و خط زیرین (underscore) تشکیل شوند.
• a و b با استفاده از نام‌هایشان، به فضاهای ذخیره‌سازی جهت همگام‌سازی ارجاع می‌دهند.
• collections: فهرستی از مجموعه‌ها (collections) برای همگام‌سازی در زمان اجرای vdirsyncer sync. همچنین «اطلاعات بیشتر دربارهٔ مجموعه‌ها» را در <#collections-tutorial> ببینید.

  مقادیر ویژهٔ "from a" و "from b" به vdirsyncer می‌گویند که کشف خودکار (autodiscovery) را روی یک فضای ذخیره‌سازی مشخص امتحان کند. این به معنای تمام مجموعه‌های سمت A / سمت B است.

  اگر مجموعه‌ای که می‌خواهید همگام‌سازی کنید در هر دو طرف نام یکسانی ندارد، می‌توانید از مقداری به شکل ["config_name", "name_a", "name_b"] استفاده کنید. این کار مجموعهٔ name_a در سمت A را با مجموعهٔ name_b در سمت B همگام‌سازی می‌کند. از config_name برای نمایش در آرگومان‌های CLI و ثبت رخدادها (logging) استفاده خواهد شد.

  مثال‌ها:

•

conflict_resolution: اختیاری است؛ نحوهٔ مدیریت تداخل‌ها (conflicts) را مشخص می‌کند. تداخل زمانی رخ می‌دهد که یک آیتم (رویداد، وظیفه) از زمان آخرین همگام‌سازی، در هر دو طرف تغییر کرده باشد. همچنین «حل تداخل» را در <#conflict-resolution-tutorial> ببینید.

مقادیر معتبر عبارتند از:

برنامهٔ vdirsyncer هرگز تلاش نمی‌کند دو آیتم را «به‌طور خودکار ادغام» کند.

•

partial_sync: فرض کنید A فقط-خواندنی (read-only) است و B خیر. اگر آیتم‌ها را در B تغییر دهید، vdirsyncer نمی‌تواند تغییرات را در A همگام کند. در عوض چه باید رخ دهد؟

همچنین «همگام‌سازی با فضاهای ذخیره‌سازی فقط-خواندنی» را در <#partial-sync-tutorial> ببینید.

•

metadata: کلیدهای متاداده‌ای که باید هنگام اجرای vdirsyncer metasync همگام‌سازی شوند. مثال:

metadata = ["color", "displayname", "description", "order"]

این کار ویژگی‌های زیر را همگام‌سازی می‌کند:

implicit = "create"

• نام‌های storage می‌توانند از هر نویسهٔ حرفی-عددی و خط زیر (underscore) تشکیل شوند.
• type مشخص می‌کند که چه نوع فضایی تعریف شده است. بخش Supported Storages را ببینید.
• read_only تعیین می‌کند که آیا فضای ذخیره‌سازی باید فقط‌خواندنی در نظر گرفته شود یا خیر. مقدار true به این معنی است که همگام‌سازی هرگونه تغییر ایجادشده در طرف دیگر را نادیده می‌گیرد. مقدار false به معنای همگام‌سازی عادی دوطرفه است.
• هر پارامتر دیگری به کلاس storage فرستاده می‌شود.

caldav

CalDAV.

[storage example_for_caldav]
type = "caldav"
#start_date = null
#end_date = null
#item_types = []
url = "..."
#username = ""
#password = ""
#verify = /path/to/custom_ca.pem
#auth = null
#useragent = "vdirsyncer/0.16.4"
#verify_fingerprint = null
#auth_cert = null

شما می‌توانید با استفاده از پارامترهای start_date و end_date یک محدوده زمانی را برای همگام‌سازی تنظیم کنید. درون این پارامترها، می‌توانید از هر عبارت پایتونی برای برگرداندن یک شیء معتبر datetime.datetime استفاده کنید. برای نمونه، کد زیر محدوده زمانی از یک سال پیش تا یک سال آینده را همگام می‌کند:

start_date = "datetime.now() - timedelta(days=365)"
end_date = "datetime.now() + timedelta(days=365)"

باید هر دو مشخص شوند یا هیچ‌کدام. پیش‌فرض، همگام‌سازی همه‌چیز است.

می‌توانید item_types را برای محدود کردن نوع آیتم‌های مورد نظر جهت همگام‌سازی تنظیم کنید. برای مثال، اگر فقط می‌خواهید رویدادها را همگام‌سازی کنید (اما هیچ وظیفه‌ای (task) را از سرور بارگیری نکنید)، عبارت item_types = ["VEVENT"] را تنظیم کنید. اگر می‌خواهید رویدادها و وظایف را همگام‌سازی کنید، اما برخی آیتم‌های VJOURNAL در سرور وجود دارند که نمی‌خواهید همگام شوند، از item_types = ["VEVENT", "VTODO"] استفاده کنید.

carddav

CardDAV.

[storage example_for_carddav]
type = "carddav"
url = "..."
#username = ""
#password = ""
#verify = /path/to/custom_ca.pem
#auth = null
#useragent = "vdirsyncer/0.16.4"
#verify_fingerprint = null
#auth_cert = null
#use_vcard_4 = false

1.

به Google API Manager بروید https://console.developers.google.com

2.

یک پروژه جدید با هر نام دلخواهی ایجاد کنید.

2.

درون آن پروژه، APIهای "CalDAV" و "CardDAV" را فعال کنید (نه APIهای Calendar و Contacts، چرا که آن‌ها متفاوت هستند و کار نخواهند کرد). باید یک جعبه جستجو وجود داشته باشد که بتوانید این عبارات را در آن وارد کنید.

3.

در نوار کناری، "Credentials"، سپس "Create Credentials" را انتخاب کرده و یک "OAuth Client ID" جدید بسازید.

ابتدا از شما خواسته می‌شود یک OAuth consent screen بسازید. آن فرم را به هر شکلی که مایلید پر کنید.

پس از راه‌اندازی صفحه رضایت (consent screen)، ایجاد "OAuth Client ID' جدید را به پایان برسانید. نوع برنامه صحیح، "Desktop application" است.

4.

در نهایت باید یک Client ID و یک Client secret در اختیار داشته باشید. این موارد را در پیکربندی فضای ذخیره‌سازی خود وارد کنید.

google_calendar

تقویم Google.

[storage example_for_google_calendar]
type = "google_calendar"
token_file = "..."
client_id = "..."
client_secret = "..."
#start_date = null
#end_date = null
#item_types = []

لطفاً برای اطلاعات بیشتر درباره پارامترهای item_types و بازه زمانی به caldav مراجعه کنید.

google_contacts

مخاطبین Google.

[storage example_for_google_contacts]
type = "google_contacts"
token_file = "..."
client_id = "..."
client_secret = "..."

filesystem

با مشخص کردن یک دایرکتوری، هر مورد را در فایل اختصاصی خودش ذخیره می‌کند.

[storage example_for_filesystem]
type = "filesystem"
path = "..."
fileext = "..."
#encoding = "utf-8"
#post_hook = null
#pre_deletion_hook = null
#fileignoreext = ".tmp"

می‌تواند همراه با khal http://lostpackets.de/khal استفاده شود. برای توصیف رسمی‌تر این قالب، The Vdir Storage Format <> را ببینید.

دایرکتوری‌هایی که نامشان با نقطه آغاز می‌شود نادیده گرفته می‌شوند تا برای مثال استفاده از کنترل نسخه آسان‌تر شود.

singlefile

داده‌ها را در یک فایل محلی واحد .vcf یا .ics ذخیره می‌کند.

این فضای ذخیره‌سازی اساساً نحوه پیوند موارد در فایل را حدس می‌زند.

در نسخه 0.1.6 اضافه شد.

نکته:

مثال برای همگام‌سازی با caldav:

[pair my_calendar]
a = my_calendar_local
b = my_calendar_remote
collections = ["from a", "from b"]
[storage my_calendar_local]
type = "singlefile"
path = ~/.calendars/%s.ics
[storage my_calendar_remote]
type = "caldav"
url = https://caldav.example.org
#username =
#password =

مثال برای همگام‌سازی با caldav با استفاده از یک مجموعه null:

[pair my_calendar]
a = my_calendar_local
b = my_calendar_remote
[storage my_calendar_local]
type = "singlefile"
path = ~/my_calendar.ics
[storage my_calendar_remote]
type = "caldav"
url = https://caldav.example.org/username/my_calendar
#username =
#password =

این فضاهای ذخیره‌سازی از نوشتن روی آیتم‌های خود پشتیبانی نمی‌کنند، در نتیجه read_only به‌طور پیش‌فرض بر روی true تنظیم شده است. تغییر read_only به false در آن‌ها منجر به بروز خطا می‌شود.

[pair holidays]
a = holidays_local
b = holidays_remote
collections = null
[storage holidays_local]
type = "filesystem"
path = ~/.config/vdir/calendars/holidays/
fileext = .ics
[storage holidays_remote]
type = "http"
url = https://example.com/holidays_from_hicksville.ics
#filter_hook = null

• در بخش general، مسیر پوشه وضعیت (status) را برای مجموعه‌های شناسایی‌شده و به‌طور کلی مواردی که باید بین دفعات همگام‌سازی حفظ شوند، تعیین می‌کنیم.
• در بخش local مشخص می‌کنیم که تمام مخاطبین باید در یک تک‌فایل همگام شوند و همچنین مسیر قرارگیری مخاطبین را تعیین می‌کنیم.
• در بخش online باید مقادیر url، username و password را مطابق با مشخصات خود تغییر دهید. ما همچنین این فضای ذخیره‌سازی را روی read-only قرار می‌دهیم تا هیچ تغییری به سرور بازگردانده و همگام نشود. در هر صورت Claws-Mail نباید قادر به اعمال هیچ تغییری باشد، اما این یک گام ایمنی بیشتر است تا در صورت خرابی فایل‌ها یا عملکرد غیرمنتظره vdirsyncer مشکلی پیش نیاید. اگر می‌خواهید قادر به ویرایش این فایل‌ها به‌صورت محلی باشید، می‌توانید این بخش را نادیده بگیرید.
• در بخش آخر پیکربندی می‌کنیم که در صورت بروز تداخل (conflict)، مخاطبین آنلاین اولویت داشته باشند (برنده شوند). این بخش را به هر شکل که مایلید تنظیم کنید؛ مقدار مناسب بستگی به این دارد که کدام سمت به احتمال زیاد به‌روزتر است.

vdirsyncer discover contacts
vdirsyncer sync contacts

برنامه Claws-Mail را باز کنید. به مسیر Tools => Addressbook بروید.

روی Addressbook => New vCard کلیک کنید. نامی برای دفترچه مخاطبین انتخاب نمایید.

سپس در پوشه ~/.contacts/ به دنبال vCard بگردید. روی ok کلیک کنید، تا مخاطبین خود را ببینید.

نکته:

OnBootSec=5m  # This is how long after boot the first run takes place.
OnUnitActiveSec=15m  # This is how often subsequent runs take place.

قالب iCalendar همچنین از ذخیره‌سازی وظایف در قالب ورودی‌های VTODO با همان پسوند فایل رویدادهای عادی پشتیبانی می‌کند: .ics. بسیاری از سرورهای CalDAV از همگام‌سازی وظایف پشتیبانی می‌کنند و vdirsyncer نیز همین‌طور است.

برنامه todoman http://todoman.readthedocs.io یک مدیر وظیفه تحت خط فرمان (CLI) با پشتیبانی از vdir <> است. رابط کاربری آن شبیه به Taskwarrior یا برنامه خط فرمانی todo.txt است. می‌توانید filesystem <#storage-filesystem> را به همراه آن به کار ببرید.

• برنامه Tasks موجود در iOS
• برنامه OpenTasks برای Android https://github.com/dmfs/opentasks
• برنامه Tasks https://apps.nextcloud.com/apps/tasks برای رابط کاربری وب NextCloud

• برنامه khal http://lostpackets.de/khal، یک برنامه تقویم CLI با پشتیبانی از vdir <>. می‌توانید filesystem <#storage-filesystem> را به همراه آن به کار ببرید.
• بسیاری از برنامه‌های تقویم گرافیکی مانند dayplanner http://www.day-planner.org، Orage https://gitlab.xfce.org/apps/orage یا rainlendar http://www.rainlendar.net یک تقویم را در یک فایل منفرد .ics ذخیره می‌کنند. برای آن‌ها می‌توانید از singlefile <#storage-singlefile> استفاده کنید.
• برنامه khard https://github.com/scheibler/khard، یک دفترچه نشانی خط فرمانی با پشتیبانی از vdir <>. می‌توانید filesystem <#storage-filesystem> را به همراه آن به کار ببرید.
• برنامه contactquery.c https://github.com/t-8ch/snippets/blob/master/contactquery.c، برنامه‌ای کوچک که صریحاً برای پرس‌وجوی vdirها از mutt نوشته شده است.
• برنامه mates https://github.com/pimutils/mates.rs، یک دفترچه نشانی خط فرمانی با پشتیبانی از vdir <>.
• برنامه vdirel https://github.com/DamienCassou/vdirel، دسترسی به مخاطبین vdir <> از طریق Emacs.

•

برنامهٔ Baikal تا نسخهٔ 0.2.7 نیز از یک نسخهٔ قدیمی SabreDAV با همان مشکل ownCloud استفاده می‌کند؛ گزارش #160 https://github.com/pimutils/vdirsyncer/issues/160 را ببینید. این مشکل در نسخه‌های بعدی برطرف شده است.

• نسخه‌های قدیمی‌تر DavMail با URLها به‌صورت غیرحساس به حروف بزرگ و کوچک (case-insensitively) رفتار می‌کنند. گزارش #144 https://github.com/pimutils/vdirsyncer/issues/144 را ببینید.
• برنامهٔ DavMail داده‌های معیوب و ناهنجار را در سرور Exchange بسیار ضعیف مدیریت می‌کند. در چنین مواردی، ابزار Calendar Checking Tool for Outlook https://www.microsoft.com/en-us/download/details.aspx?id=28786 ممکن است کمک‌کننده باشد.
• در برخی موارد، ممکن است خطاهایی دربارهٔ رویدادهای تکراری مشاهده کنید؛ چیزی شبیه به این:

error: my_calendar/calendar: Storage "my_calendar_remote/calendar" contains multiple items with the same UID or even content. Vdirsyncer will now abort the synchronization of this collection, because the fix for this is not clear; It could be the result of a badly behaving server. You can try running:
error:
error:     vdirsyncer repair my_calendar_remote/calendar
error:
error: But make sure to have a backup of your data in some form. The offending hrefs are:
[...]

به‌منظور برطرف کردن این مورد، می‌توانید اسکریپت پاورشل Remove-DuplicateAppointments.ps1 https://blogs.msdn.microsoft.com/emeamsgdev/2015/02/12/powershell-remove-duplicate-calendar-appointments را که مایکروسافت برای حذف موارد تکراری ارائه داده است، امتحان کنید.

[storage cal]
type = "caldav"
url = "https://caldav.fastmail.com/"
username = "..."
password = "..."
[storage card]
type = "carddav"
url = "https://carddav.fastmail.com/"
username = "..."
password = "..."

استفاده از vdirsyncer با Google Calendar از نسخهٔ 0.10 امکان‌پذیر است، اما مرتباً آزمایش نمی‌شود. می‌توانید از google_contacts <#storage-google_contacts> و google_calendar <#storage-google_calendar> استفاده کنید.

برای اطلاعات بیشتر، issue #202 https://github.com/pimutils/vdirsyncer/issues/202 و issue #8 https://github.com/pimutils/vdirsyncer/issues/8 را ببینید.

• ابزار vdirsyncer نمی‌تواند احراز هویت دومرحله‌ای (two-factor auth) را با iCloud انجام دهد (به نظر نمی‌رسد راهی برای انجام احراز هویت دومرحله‌ای از طریق APIهای DAV وجود داشته باشد). در عوض باید از گذرواژه‌های مخصوص برنامه (app-specific passwords) https://support.apple.com/en-us/HT204397 استفاده کنید.
• سرویس iCloud هنگام ایجاد مجموعه‌ها نیازمندی‌های خاصی دارد. در اصل vdirsyncer قادر به انجام آن است، اما توصیه می‌شود آن‌ها را از طریق یک کلاینت Apple (یا واسط وب iCloud) ایجاد کنید.

•

اشتراک‌های WebCAL توسط vdirsyncer قابل شناسایی نیستند. این issue مرتبط را ببینید: https://github.com/nextcloud/calendar/issues/63.

•

نسخه‌های قدیمی‌تر از 7.0.0: سرویس ownCloud از SabreDAV استفاده می‌کند که در تشخیص تداخل‌ها و شرایط رقابتی (race-conditions) مشکلاتی داشت. این مشکلات گزارش شده و در مخزن SabreDAV رفع شده‌اند، و اصلاحیهٔ متناظر نیز از نسخهٔ 7.0.0 در ownCloud اعمال شده است. برای اطلاعات بیشتر issue #16 https://github.com/pimutils/vdirsyncer/issues/16 را ببینید.

سرور Radicale http://radicale.org بسیار سبک است؛ با این حال، استانداردهای CalDAV و CardDAV را به‌صورت عمدی به‌طور کامل پیاده‌سازی نمی‌کند، که ممکن است حتی با کلاینت‌های بسیار خوش‌ساخت نیز به بروز مشکلاتی بینجامد. فارغ از عدم انطباق آن با استانداردها، چندین مشکل دیگر در کیفیت کد و شیوهٔ نگهداری آن وجود دارد. به‌جای آن، استفاده از مواردی مانند Xandikos <> را در نظر بگیرید.

با این وجود، vdirsyncer به‌طور مداوم با نسخهٔ git و آخرین انتشار PyPI از Radicale آزمایش می‌شود.

• اطمینان حاصل کنید که مشکل شما قبلاً در مشکلات شناخته‌شده (Known Problems) <> فهرست نشده باشد.
• مطمئن شوید که قطعاً از آخرین نسخه vdirsyncer استفاده می‌کنید. برای کاربران برخی از توزیع‌های لینوکس مانند Debian یا Fedora، ممکن است این نسخه همان نسخه‌ای نباشد که توزیع شما ارائه می‌دهد. در چنین مواردی لطفاً باگ را برای بسته توزیع ثبت کنید، نه برای بالادست (upstream) vdirsyncer.
• هنگام قرار دادن خروجی vdirsyncer، از --verbosity=DEBUG استفاده کنید.

• پیش از پیاده‌سازی، ابتدا همه‌چیز را در سامانه پیگیری اشکالات به بحث بگذارید (یا از راهی دیگر با من ارتباط برقرار کنید).
• مطمئن شوید که آزمون‌ها با موفقیت پاس می‌شوند. برای اجرای آن‌ها بخش زیر را ببینید.
• اما نه صرفاً به این دلیل که آزمون‌های بسیار کمی نوشته‌اید.
• نام خود را به AUTHORS.rst اضافه کنید، و همچنین یادداشتی به CHANGELOG.rst بیفزایید.

• پوشه system شامل آزمون‌های سیستم و همچنین یکپارچه‌سازی است. یک قاعده کلی این است: اگر آزمون از فایل‌های موقت استفاده می‌کند، آن را اینجا قرار دهید.
• پوشه unit، که در آن هر مورد آزمون، یک کلاس یا تابع واحد را می‌آزماید.
• پوشه storage یک مجموعه آزمون ذخیره‌سازی عمومی را روی تمام فضاهای ذخیره‌سازی اجرا می‌کند.

• یک فایل vCard https://tools.ietf.org/html/rfc6350، که در این صورت پسوند فایل باید .vcf باشد، یا
• یک فایل iCalendar https://tools.ietf.org/html/rfc5545، که در این صورت پسوند فایل باید .ics باشد.

• فایلی به نام color درون vdir رنگ vdir را مشخص می‌کند؛ این مشخصه صرفاً در طراحی رابط کاربری (UI) اهمیت دارد.

  محتوای آن یک مقدار hex-RGB با کدگذاری ASCII به قالب #RRGGBB است. برای نمونه، محتوای فایل #FF0000 مشخص می‌کند که vdir رنگ قرمز (قابل مشاهده برای کاربر) دارد. استفاده از اشکال کوتاه یا مقادیر غیررسمی مانند red (برای مثال آن‌گونه که در CSS وجود دارد) مجاز نیست. علامت پیشوند # باید وجود داشته باشد.

• فایل‌هایی به نام‌های displayname و description حاوی عنوان/توضیحاتی با کدگذاری UTF-8 هستند که ممکن است برای نمایش vdir در رابط‌های کاربری به کار روند.
• فایلی به نام order درون vdir شامل ترتیب نسبی گاه‌شمار است؛ مشخصه‌ای که صرفاً در طراحی رابط کاربری اهمیت دارد.

• هر فایلی که به .tmp ختم شود یا فاقد پسوند فایل باشد، نباید به عنوان یک آیتم در نظر گرفته شود.
• بخش ident از نام فایل نباید به منظور افزایش سرعت جستجوی آیتم‌ها تجزیه شود.

• پیاده‌سازی تلاش مجدد برای نوع ذخیره‌سازی google در صورت رسیدن به سقف نرخ درخواست (rate limit).
• بسته tenacity اکنون یک وابستگی الزامی است.
• پایان پشتیبانی از Python 3.8.
• تلاش مجدد برای خطاهای گذرا شبکه در درخواست‌های بی‌اثر (nullipotent).
• افزودن پشتیبانی از Python 3.14.

• حذف وابستگی به کتابخانه متروکه atomicwrites.
• پیاده‌سازی filter_hook برای فضای ذخیره‌سازی HTTP.
• پایان پشتیبانی از Python 3.7.
• افزودن پشتیبانی از Python 3.12 و Python 3.13.
• بستن صحیح پایگاه داده وضعیت پس از استفاده. این موضوع به‌ویژه بر آزمون‌ها تأثیر می‌گذارد، جایی که شمار زیادی از توصیف‌کننده‌های فایل (file descriptors) نشت می‌کردند.
• گسترش نسخه‌های پشتیبانی‌شده از aiostream برای دربرگرفتن 0.7.x.

• افزودن گزینه no_delete به پیکربندی فضای ذخیره‌سازی. issue #1090 https://github.com/pimutils/vdirsyncer/issues/1090
• رفع خرابی (crash) هنگام اجرای vdirsyncer repair روی یک مجموعه. issue #1019 https://github.com/pimutils/vdirsyncer/issues/1019
• افزودن گزینه‌ای برای درخواست vCard v4.0. issue #1066 https://github.com/pimutils/vdirsyncer/issues/1066
• الزام تطابق خطوط BEGIN و END در vobjectها. issue #1103 https://github.com/pimutils/vdirsyncer/issues/1103
• یک محیط Docker برای Vdirsyncer تحت عنوان Vdirsyncer DOCKERIZED افزوده شده است https://github.com/Bleala/Vdirsyncer-DOCKERIZED.
• پیاده‌سازی احراز هویت digest. issue #1137 https://github.com/pimutils/vdirsyncer/issues/1137
• افزودن پارامتر filter_hook به http <#storage-http>. issue #1136 https://github.com/pimutils/vdirsyncer/issues/1136

• رفع کرش هنگام پردازش Google Contacts. issue #994 https://github.com/pimutils/vdirsyncer/issues/994
• متغیرهای محیطی HTTP_PROXY و HTTPS_PROXY اکنون رعایت و اعمال می‌شوند. issue #1031 https://github.com/pimutils/vdirsyncer/issues/1031
• دستورالعمل‌های یکپارچه‌سازی با Google CalDav/CardDav تغییر کرده است. برنامه‌ها اکنون باید به عنوان "Web Application" ثبت شوند. issue #975 https://github.com/pimutils/vdirsyncer/issues/975
• به‌روزرسانی‌های گوناگون در مستندات.

• افزودن راهبرد دریافت گذرواژه "shell" برای فرستادن رشته دستور به یک شل.
• افزودن "description" و "order" به عنوان متادیتا. این مقادیر به ترتیب ویژگی‌های CalDAV: calendar-description، CardDAV:addressbook-description و apple-ns:calendar-order را دریافت می‌کنند.
• افزودن وضعیت جدید showconfig. این دستور برخی از مقادیر پیکربندی را به صورت JSON نمایش می‌دهد. این قابلیت برای استفاده توسط ابزارها و برنامه‌های کمکی خارجی که با vdirsyncer در تعامل هستند در نظر گرفته شده و آزمایشی محسوب می‌شود.
• افزودن گزینه implicit به بخش pair <#pair-config>. هنگامی که روی "create" تنظیم شود، مجموعه‌های مفقود را در حین همگام‌سازی بدون نیاز به تأیید کاربر ایجاد می‌کند. این امر جریان‌های کاری را که در آن‌ها مجموعه‌ها باید به طور خودکار در هر دو طرف ایجاد شوند ساده می‌کند.
• به‌روزرسانی آزمون‌های مرتبط با TLS که به دلیل MDهای ضعیف با شکست مواجه می‌شدند. issue #903 https://github.com/pimutils/vdirsyncer/issues/903
• بسته‌های pytest-httpserver و trustme اکنون برای اجرای آزمون‌ها الزامی هستند.
• بسته pytest-localserver دیگر برای اجرای آزمون‌ها الزامی نیست.
• پشتیبانی از چندنخی (Multithreaded) متوقف شد. گزینه "--max-workers حذف شده است.
• اکنون از بک‌اند جدید asyncio استفاده می‌شود. تا اینجا، این تغییر باعث بهبود چشمگیر سرعت در discovery و metasync شده، اما تغییر اندکی در sync داشته است. این مورد احتمالاً در طول زمان بهبود بیشتری خواهد یافت. issue #906 https://github.com/pimutils/vdirsyncer/issues/906
• انواع ذخیره‌ساز google دیگر به requests-oauthlib نیازی ندارند، و به جای آن نیازمند python-aiohttp-oauthlib هستند.
• برنامه Vdirsyncer دیگر پشتیبانی آزمایشی از EteSync https://www.etesync.com را شامل نمی‌شود. یکپارچه‌سازی موجود مدت‌ها بود که پشتیبانی نمی‌شد و دیگر کار نمی‌کرد. در صورت تمایل افراد به نگهداری یک افزونه برای EteSync، ممکن است پشتیبانی از ذخیره‌سازهای خارجی اضافه شود. به کاربران EteSync پیشنهاد می‌شود استفاده از etesync-dav https://github.com/etesync/etesync-dav را مد نظر قرار دهند.
• فایل plist برای macOS حذف شد. این فایل ایراد داشت و homebrew نسخه خودش را بر اساس متادیتای بسته تولید می‌کند. به کاربران macOS توصیه می‌شود از آن به عنوان مرجع استفاده کنند.

• پشتیبانی از Python 3.5 و 3.6 پایان یافته است. این انتشار عمدتاً بر حفظ سازگاری vdirsyncer با محیط‌های جدیدتر تمرکز دارد.
• اکنون نسخه‌های click 8 و click-threading 0.5.0 مورد نیاز هستند.
• برای کسانی که از pipsi استفاده می‌کنند، اکنون استفاده از جانشین آن، pipx، توصیه می‌شود.
• اکنون از Python 3.9 پشتیبانی می‌شود.
• اسکریپت‌های ساخت Debian/Ubuntu به‌روزرسانی شده‌اند. نسخه‌های جدید باید به‌زودی به آن مخازن فرستاده شوند.

•

پشتیبانی از Python 3.7 و 3.8.

•

رفع اشکال‌ها برای Python 3.7

•

بسته‌سازان: ساخت مستندات دیگر نیازی به یک نسخهٔ نصب‌شده و فعال از vdirsyncer ندارد.

• بسته‌سازان: نسخه click-log 0.3 مورد نیاز است.
• تمام خروجی‌ها اکنون روی stderr ارسال خواهند شد (به دلیل ارتقای click-log).

•

اصلاح آزمون‌ها برای نسخه جدید Hypothesis. (دقیقاً هیچ تغییر دیگری اعمال نشده است)

• اولین نسخه با بسته‌های سفارشی Debian و Ubuntu. مسئلهٔ #663 را ببینید https://github.com/pimutils/vdirsyncer/issues/663.
• حذف نویسه‌های کنترلی نامعتبر ASCII از پاسخ‌های سرور. مسئلهٔ #626 را ببینید https://github.com/pimutils/vdirsyncer/issues/626.
• بسته‌سازان: از Python 3.3 دیگر پشتیبانی نمی‌شود. درخواست تغییرات (pull request) شماره #674 را ببینید https://github.com/pimutils/vdirsyncer/pull/674.

• رفع خرابی ناگهانی هنگام استفاده از فیلترهای daterange یا item_type در google_calendar <#storage-google_calendar>، مسئلهٔ #657 را ببینید https://github.com/pimutils/vdirsyncer/issues/657.
• بسته‌سازان: اصلاحات مربوط به نسخهٔ جدید 0.2.0 از click-log. نیازمندی‌های نسخه برای وابستگی click-log تغییر یافته است.

  منتشرشده در 8 اوت 2017

• حذف METHOD:PUBLISH اضافه‌شده توسط برخی ارائه‌دهندگان تقویم؛ گزارش شماره #502 https://github.com/pimutils/vdirsyncer/issues/502 را ببینید.
• رفع مشکل از کار افتادن (crash) فضاهای ذخیره‌سازی Google هنگام ذخیره فایل توکن.
• انطباق بیشتر شناسایی DAV با استانداردهای RFC؛ درخواست ادغام #585 https://github.com/pimutils/vdirsyncer/pull/585 را ببینید.
• ابزار vdirsyncer اکنون در برابر Xandikos آزمایش می‌شود؛ درخواست ادغام #601 https://github.com/pimutils/vdirsyncer/pull/601 را ببینید.
• زیرپوشه‌های دارای نقطه در ابتدای نام اکنون در طول فرایند شناسایی برای فضای ذخیره‌سازی filesystem نادیده گرفته می‌شوند. این امر ادغام آن را با سیستم‌های کنترل نسخه آسان‌تر می‌کند.
• وضعیت‌ها اکنون در یک پایگاه داده sqlite ذخیره می‌شوند. داده‌های قدیمی به‌طور خودکار مهاجرت داده می‌شوند. کاربران دارای مجموعه‌داده‌های بسیار بزرگ باید شاهد بهبود عملکرد باشند. این بدان معناست که sqlite3 اکنون یک وابستگی برای vdirsyncer است.
• Vdirsyncer اکنون تحت مجوز 3-بندی BSD منتشر می‌شود؛ گزارش شماره #610 https://github.com/pimutils/vdirsyncer/issues/610 را ببینید.
• ابزار vdirsyncer اکنون شامل پشتیبانی آزمایشی از EteSync https://www.etesync.com است؛ درخواست ادغام #614 https://github.com/pimutils/vdirsyncer/pull/614 را ببینید.
• ابزار vdirsyncer اکنون برای تشخیص تغییر یک آیتم، از متاداده‌های بیشتری از سامانه فایل استفاده می‌کند. ممکن است در نخستین همگام‌سازی پس از ارتقا متوجه افزایش ناگهانی و شدید بار پردازنده و ورودی/خروجی (CPU/IO) شوید.
• بسته‌بندها: فایل‌های واحد مرجع systemd.service و systemd.timer ارائه شده‌اند. توصیه می‌شود اگر توزیع شما مبتنی بر systemd است، این فایل‌ها را به‌عنوان مستندات نصب کنید.

• نحو منسوخ‌شده برای مقادیر پیکربندی اکنون کاملاً رد می‌شود. تمامی مقادیر اکنون باید ساختار معتبر JSON داشته باشند.
• چندین بهبود تجربه کاربری برای فضاهای ذخیره‌سازی Google؛ گزارش شماره #549 https://github.com/pimutils/vdirsyncer/issues/549 و گزارش شماره #552 https://github.com/pimutils/vdirsyncer/issues/552 را ببینید.
• رفع مشکل شناسایی مجموعه برای google_contacts <#storage-google_contacts>؛ گزارش شماره #564 https://github.com/pimutils/vdirsyncer/issues/564 را ببینید.
• سرویس iCloud اکنون در Travis آزمایش می‌شود؛ گزارش شماره #567 https://github.com/pimutils/vdirsyncer/issues/567 را ببینید.

• دستور vdirsyncer repair دیگر به‌طور پیش‌فرض "UIDهای ناامن" را تغییر نمی‌دهد؛ یک گزینه اضافی باید مشخص شود. گزارش شماره #527 https://github.com/pimutils/vdirsyncer/issues/527 را ببینید.
• به‌روزرسانی‌های مهم متعددی در مستندات.

• دستور vdirsyncer sync اکنون در صورت شکست یک بارگذاری، بارگذاری‌های دیگر را ادامه می‌دهد. کد خروج در چنین شرایطی همچنان غیر صفر خواهد بود.
• افزودن گزینه partial_sync به بخش pair. مستندات پیکربندی <#partial-sync-def> را ببینید.
• ابزار vdirsyncer اکنون در صورت وجود رشته‌های بدون نقل‌قول در پیکربندی شما هشدار می‌دهد. لطفاً در صورت مشاهده مستنداتی که از رشته‌های بدون نقل‌قول استفاده می‌کنند، گزارش خطا ارسال کنید.
• رفع مشکلی که باعث از کار افتادن دستیار پیکربندی ابزار khal می‌شد.

  منتشر شده در ۳۰ سپتامبر ۲۰۱۶

• پشتیبانی از Python 2 به طور کامل متوقف شد. گزارش #219 را ببینید: https://github.com/pimutils/vdirsyncer/issues/219.
• اکنون بخش‌های پیکربندی از نظر نام‌های تکراری بررسی می‌شوند. این بدان معناست که شما نمی‌توانید یک بخش ذخیره‌سازی [storage foo] و یک جفت [pair foo] با نام یکسان در پیکربندی خود داشته باشید؛ آنها باید نام‌های متفاوتی داشته باشند. این کار انجام شد تا خروجی کنسول همیشه بدون ابهام باشد. گزارش #459 را ببینید: https://github.com/pimutils/vdirsyncer/issues/459.
• اکنون می‌توان از دستورات سفارشی برای حل تعارض در حین همگام‌سازی استفاده کرد. گزارش #127 را ببینید: https://github.com/pimutils/vdirsyncer/issues/127.
• ذخیره‌ساز http <#storage-http> اکنون UIDها را کاملاً نادیده می‌گیرد. این کار از بارگیری و بارگذاری‌های غیرضروری بسیاری جلوگیری می‌کند.

• رفع کرش در فضاهای ذخیره‌سازی Google و DAV. درخواست ادغام #492 را ببینید: https://github.com/pimutils/vdirsyncer/pull/492.
• رفع مشکل URL-encoding با DavMail. گزارش #491 را ببینید: https://github.com/pimutils/vdirsyncer/issues/491.

•

ذخیره‌ساز singlefile <#storage-singlefile> اکنون از مجموعه‌ها پشتیبانی می‌کند. درخواست ادغام #488 را ببینید: https://github.com/pimutils/vdirsyncer/pull/488.

• مقدار پیش‌فرض پارامتر auth از guess به basic تغییر یافت تا مشکلات با Apple Calendar Server برطرف شود (گزارش #457 https://github.com/pimutils/vdirsyncer/issues/457) و کارایی بهبود یابد. گزارش #461 را ببینید: https://github.com/pimutils/vdirsyncer/issues/461.
• بسته‌بندها: نیازمندی به click-threading اکنون >=0.2 است. این مقدار پیش‌تر نادرست بود. گزارش #478 را ببینید: https://github.com/pimutils/vdirsyncer/issues/478.
• رفع باگی در کد تجزیه XML مربوط به DAV که باعث کرش کردن vdirsyncer با برخی ورودی‌های خاص می‌شد. گزارش #480 را ببینید: https://github.com/pimutils/vdirsyncer/issues/480.
• زنجیره‌های بازهدایت (redirect chains) هنگام تحلیل نشانی‌های وب well-known اکنون باید به درستی مدیریت شوند. درخواست ادغام #481 را ببینید: https://github.com/pimutils/vdirsyncer/pull/481.

•

رفع غلط املایی که آزمون‌ها را با شکست مواجه می‌کرد.

• رفع باگ در اعتبارسنجی مجموعه‌ها.
• رفع باگ ظاهری در خروجی اشکال‌زدایی (debug).
• بهبودهای مختلف در مستندات.

• شناسایی (Discovery) دیگر به طور خودکار هنگام اجرای vdirsyncer sync انجام نمی‌شود. اکنون باید vdirsyncer discover صریحاً فراخوانی شود.
• افزودن یک نمونه .plist برای Mac OS X.
• استفاده تحت Python 2 اکنون نیازمند تنظیم یک پارامتر پیکربندی ویژه است.
• چندین پارامتر پیکربندی منسوخ‌شده دیگر پیام‌های خطای اختصاصی ندارند. پیام خطای عمومی برای پارامترهای ناشناخته نمایش داده می‌شود.

منتشرشده در ۲۳ آوریل ۲۰۱۶

• اکنون singlefile <#storage-singlefile> و http <#storage-http> رویدادهای تکرارشونده را به‌درستی مدیریت می‌کنند.
• رفع یک غلط املایی در دستورالعمل‌های بسته‌بندی.
• انتقال به سازمان pimutils در GitHub. پیوندهای قدیمی باید تغییر مسیر دهند، اما مراقب نرم‌افزارهای کلاینتی که تغییر مسیرها را به‌درستی مدیریت نمی‌کنند باشید.

•

مجموعه آزمون برای محیط‌هایی که هیچ مرورگر وبی در آن‌ها نصب نشده اصلاح شد. درخواست ادغام شماره ۳۸۴ را ببینید: https://github.com/pimutils/vdirsyncer/pull/384.

• دستور چاپ اشکال‌زدایی باقی‌مانده در vdirsyncer discover حذف شد؛ کامیت 3d856749f37639821b148238ef35f1acba82db36 را ببینید.
• دستور metasync اکنون فاصله‌های خالی را از ابتدا و انتهای مقادیر حذف می‌کند. گزارش مشکل شماره ۳۵۸ را ببینید: https://github.com/pimutils/vdirsyncer/issues/358.
• بخش جدید Packaging Guidelines به مستندات افزوده شده است.

•

پارامتر collections اکنون در پیکربندی‌های جفت الزامی است. Vdirsyncer در پیام خطای خود به شما خواهد گفت چه کاری انجام دهید. گزارش مشکل شماره ۳۲۸ را ببینید: https://github.com/pimutils/vdirsyncer/issues/328.

•

اصلاح پیام‌های خطا هنگام استفاده از راهبرد نامعتبر برای واکشی پارامتر. این مورد از آنجا اهمیت دارد که کاربران به دلیل استفاده از روش منسوخ‌شده واکشی با keyring خطاهای نامفهومی دریافت می‌کردند.

• پشتیبانی از Keyring حذف شده است، به این معنی که password.fetch = ["keyring", "example.com", "myuser"] دیگر کار نمی‌کند.

  برای راه‌اندازی‌های موجود: در عوض از password.fetch = ["command", "keyring", "get", "example.com", "myuser"] استفاده کنید که عمومی‌تر است. برای جزئیات به مستندات مراجعه کنید.

• اکنون هنگام اجرا تحت Python 2 یک هشدار صادر می‌شود. گزارش مشکل شماره ۲۱۹ را ببینید: https://github.com/pimutils/vdirsyncer/issues/219.

  منتشرشده در ۲۳ دسامبر ۲۰۱۵

• بهبود پیام‌های خطا به جای رفتار نادرست سرور؛ گزارش مشکل #290 https://github.com/pimutils/vdirsyncer/issues/290 و گزارش مشکل #300 https://github.com/pimutils/vdirsyncer/issues/300 را ببینید.
• خاموش‌سازی ایمن‌تر threadpool و جلوگیری از بروز استثناها؛ گزارش مشکل #291 https://github.com/pimutils/vdirsyncer/issues/291 را ببینید.
• رفع باگ همگام‌سازی برای حافظه‌های ذخیره‌سازی فقط-خواندنی (read-only)؛ کامیت ed22764921b2e5bf6a934cf14aa9c5fede804d8e را ببینید.
• تغییرات Etag دیگر برای راه‌اندازی عملیات همگام‌سازی کافی نیستند. تغییر واقعی محتوا نیز ضروری است. گزارش مشکل #257 https://github.com/pimutils/vdirsyncer/issues/257 را ببینید.
• اکنون remotestorage به‌طور خودکار کادرهای گفتگوی احراز هویت را در مرورگر GUI پیکربندی‌شده شما باز می‌کند.
• بسته‌بندها (Packagers): اکنون lxml>=3.1 مورد نیاز است (نسخه حداقل جدیدتر).

•

واقعاً اختیاری کردن وابستگی‌های remotestorage (remotestorage-dependencies).

•

رفع خرابی مجموعه آزمون (testsuite).

• بسته‌بندها (Packagers): موارد اضافی (extras) در setuptools با عنوان‌های keyring و remotestorage اضافه شده‌اند. آن‌ها اساساً وابستگی‌های اختیاری هستند. برای جزئیات بیشتر setup.py را ببینید.
• پشتیبانی بسیار آزمایشی از remoteStorage اضافه شده است. ممکن است این قابلیت در هر نسخه‌ای کاملاً بازنویسی شود یا حتی حذف گردد.
• حذف ارجاعات به password_command قدیمی در مستندات.

• بسته‌بندها (Packagers): وابستگی‌های جدید عبارتند از click_threading، click_log و click>=5.0.
• دستور password_command حذف شده است. پشتیبانی از Keyring کاملاً بازنویسی شد. بخش ذخیره‌سازی گذرواژه‌ها (Storing passwords) <> را ببینید.

• فراخوانی‌های password_command با کد خروج غیرصفر اکنون مهلک تلقی شده (و همگام‌سازی را متوقف می‌کنند) به جای اینکه صرفاً هشداری تولید کنند.
• برنامه Vdirsyncer اکنون قادر به همگام‌سازی متاداده‌های مجموعه‌ها است. مقدار metadata = ["displayname"] را تنظیم کرده و vdirsyncer metasync را اجرا کنید.
• بسته‌بندها (Packagers): از بسته‌های tarball گیت‌هاب استفاده نکنید، بلکه از بسته‌های PyPI استفاده کنید.
• بسته‌بندها (Packagers): اسکریپت build.sh حذف شده و Makefile در بسته‌های tarball گنجانده شده است. برای چگونگی اجرای آزمون‌ها پس از بسته‌بندی، محتوای Makefile را ببینید.
• گزینه verify_fingerprint دیگر به‌طور خودکار verify را غیرفعال نمی‌کند.

  منتشر شده در 15 ژوئن 2015

• توجه: نسخه آپلود شده 0.5.0 روی PyPI کاملاً معیوب است.
• ارتقای نسخه مورد نیاز requests-toolbelt به 0.4.0.
• خط فرمان زمانی که کاری برای انجام دادن وجود ندارد (مانند خروجی راهنما)، باید بسیار سریع‌تر باشد.
• رفع مجدد سازگاری با iCloud.
• استفاده از تنها یک worker در صورت فعال بودن حالت اشکال‌زدایی (debug mode).
• استفاده از verify=false اکنون در vdirsyncer غیرمجاز است؛ لطفاً به جای آن از verify_fingerprint استفاده کنید.
• رفع باگی که در آن فضای ذخیره‌سازی DAV در vdirsyncer از useragent پیکربندی‌شده برای کشف مجموعه (collection discovery) استفاده نمی‌کرد.

• پشتیبانی از گواهی‌های کلاینت از طریق پارامتر جدید auth_cert، گزارش باگ شماره 182 https://github.com/pimutils/vdirsyncer/issues/182 و pull request شماره 183 https://github.com/pimutils/vdirsyncer/pull/183 را ببینید.
• بسته icalendar دیگر مورد نیاز نیست.
• چندین رفع باگ مربوط به ساخت مجموعه.

• بهبودهای عملکردی بیشتر برای فضای ذخیره‌سازی singlefile.
• افزودن پارامتر post_hook به فضای ذخیره‌سازی filesystem.
• ایجاد مجموعه اکنون با سرورهای مبتنی بر SabreDAV مانند Baikal یا ownCloud نیز کار می‌کند.
• حذف برخی راه‌حل‌های موقت برای Radicale. ارتقا به آخرین نسخه Radicale این مشکلات را برطرف خواهد کرد.
• رفع مشکلات مربوط به کشف در iCloud.
• برنامه Vdirsyncer اکنون شامل یک دستور ساده repair است که تلاش می‌کند برخی آیتم‌های معیوب را اصلاح کند.

• برنامه Vdirsyncer اکنون هنگام بارگذاری و به‌روزرسانی آیتم‌ها از تغییرمسیرها پیروی می‌کند. این امر ممکن است مشکلات مربوط به Zimbra را رفع کند.
• مقادیر نسبی status_path اکنون به عنوان مسیر نسبی نسبت به دایرکتوری فایل پیکربندی تفسیر می‌شوند.
• رفع سازگاری با سرورهای سفارشی SabreDAV. گزارش باگ شماره 166 را ببینید: https://github.com/pimutils/vdirsyncer/issues/166.
• گرفتن استثناهای بی‌خطر ریسه‌بندی (threading) که هنگام متوقف شدن vdirsyncer رخ می‌دهند. گزارش باگ شماره 167 را ببینید: https://github.com/pimutils/vdirsyncer/issues/167.
• برنامه Vdirsyncer اکنون به atomicwrites وابسته است.
• بهبودهای عملکردی چشمگیر در فضای ذخیره‌سازی singlefile.
• آیتم‌هایی با UIDهای بسیار طولانی اکنون باید به درستی در فضای ذخیره‌سازی filesystem ذخیره شوند. گزارش باگ شماره 173 را ببینید: https://github.com/pimutils/vdirsyncer/issues/173.

  منتشرشده در ۵ ژانویه ۲۰۱۵

• پارامتر passwordeval به password_command تغییر نام یافته است.
• روش قدیمی برای نوشتن برخی مقادیر پیکربندی مانند فهرست‌ها حذف شده است.
• شناسایی مجموعه (Collection discovery) بازنویسی شده است. فایل‌های پیکربندی قدیمی باید با آن سازگار باشند، اما اکنون vdirsyncer نتایج شناسایی مجموعه را کَش می‌کند. در صورتی که مجموعه‌ها در یک طرف اضافه یا حذف شوند، باید دستور vdirsyncer discover را اجرا کنید.
• نام‌های جفت (pair) و فضای ذخیره‌سازی (storage) اکنون به نویسه‌های خاصی محدود شده‌اند. اگر فایل پیکربندی شما از این نظر نامعتبر باشد، vdirsyncer یک پیام خطای واضح صادر خواهد کرد.
• اکنون vdirsyncer از مشخصات XDG-Basedir پشتیبانی می‌کند. اگر متغیر محیطی VDIRSYNCER_CONFIG تنظیم نشده باشد و فایل ~/.vdirsyncer/config وجود نداشته باشد، به دنبال فایل پیکربندی در مسیر $XDG_CONFIG_HOME/vdirsyncer/config خواهد گشت.
• بهبودهایی در شناسایی CardDAV و CalDAV بر پایهٔ مشکلات مشاهده‌شده با FastMail صورت گرفته است. پشتیبانی از URIهای .well-known اضافه شد.

•

چند رفع اشکال دیگر در مدیریت پیکربندی.

• برنامهٔ vdirsyncer اکنون با iCloud نیز کار می‌کند. به‌ویژه شناسایی مجموعه و مدیریت etag اصلاح شده‌اند.
• اکنون vdirsyncer درخواست‌های CalDAV و CardDAV را به شکلی متفاوت کُدگذاری می‌کند. این تغییر با سرورهایی مانند Zimbra یا SoGo به طور کامل آزمایش نشده است، اما انتظار نمی‌رود مشکلی ایجاد کند.
• برنامهٔ vdirsyncer اکنون در برابر پاسخ‌های نامعتبر از سرورهای CalDAV مقاوم‌تر است. این امر به سازگاری آینده با Davmail/Outlook کمک خواهد کرد.
• رفع یک اشکال هنگام تعیین item_types برای caldav <#storage-caldav> در قالب منسوخ‌شدهٔ پیکربندی.
• رفع اشکالی که در آن vdirsyncer همهٔ نویسه‌ها به جز یک مورد را در مقدار مشخص‌شدهٔ unsafe_href_chars برای caldav <#storage-caldav> و carddav <#storage-carddav> نادیده می‌گرفت.

•

قالب فعلی پیکربندی منسوخ شده است و پشتیبانی از آن در نسخه 0.4.0 حذف خواهد شد. اکنون vdirsyncer در این باره هشدار می‌دهد.

• رفع اشکالی که در آن اگر مواردی در سمت A حذف ولی در سمت B تغییر داده می‌شدند، vdirsyncer آن‌ها را حذف می‌کرد. اکنون در عوض، vdirsyncer موارد جدید را در سمت A بارگذاری خواهد کرد. گزارش مشکل شماره ۱۲۸ https://github.com/pimutils/vdirsyncer/issues/128 را ببینید.
• در صورت بروز نقص در یک جفت، همگام‌سازی با جفت‌های باقی‌مانده ادامه می‌یابد؛ گزارش مشکل شماره ۱۲۱ https://github.com/pimutils/vdirsyncer/issues/121 را ببینید.
• کلید پیکربندی processes حذف شده است. اکنون گزینهٔ --max-workers در خط فرمان وجود دارد که هدف مشابهی دارد. درخواست ادغام شماره ۱۲۶ https://github.com/pimutils/vdirsyncer/pull/126 را ببینید.
• پوستهٔ Read The Docs دیگر برای ساخت مستندات الزامی نیست. اگر نصب نباشد، پوستهٔ پیش‌فرض استفاده خواهد شد. گزارش مشکل شماره ۱۳۴ https://github.com/pimutils/vdirsyncer/issues/134 را ببینید.

  منتشر شده در ۲۰ سپتامبر ۲۰۱۴

• عدم درخواست گذرواژه یک سرور بیش از یک‌بار و رفع چندین مشکل هم‌زمانی، گزارش مشکل #101 https://github.com/pimutils/vdirsyncer/issues/101 را ببینید.
• اعتبارسنجی بهتر نقطه‌های پایانی DAV.

• گنجاندن راه‌حل موقت برای کشف مجموعه‌ها با آخرین نسخه Radicale.
• گنجاندن فایل‌های متادیتا مانند changelog یا مجوز در بسته توزیع منبع، گزارش مشکل #97 https://github.com/pimutils/vdirsyncer/issues/97 و گزارش مشکل #98 https://github.com/pimutils/vdirsyncer/issues/98 را ببینید.

• اکنون vdirsyncer دارای پرچم --version است، گزارش مشکل #92 https://github.com/pimutils/vdirsyncer/issues/92 را ببینید.
• رفع تعداد زیادی از باگ‌های مربوط به نویسه‌های خاص در URLها، گزارش مشکل #49 https://github.com/pimutils/vdirsyncer/issues/49 را ببینید.

• حذف یک بررسی امنیتی که در نشانی‌های وب DAV با نویسه‌های خاص و سرورهای معینی ایجاد مشکل می‌کرد. علاوه بر این، آن بررسی امنیتی بی‌معنی بود. گزارش مشکل #87 https://github.com/pimutils/vdirsyncer/issues/87 و گزارش مشکل #91 https://github.com/pimutils/vdirsyncer/issues/91 را ببینید.
• تغییر برخی خطاها به هشدار، گزارش مشکل #88 https://github.com/pimutils/vdirsyncer/issues/88 را ببینید.
• بهبود کشف خودکار مجموعه‌ها برای سرورهای فاقد پشتیبانی کامل.

• رفع باگی که در آن vdirsyncer هنگام استفاده از CardDAV با Zimbra دفترچه‌های نشانی را خالی نشان می‌داد.
• رفع حلقه بی‌نهایت هنگام عدم وجود گذرواژه در keyring سامانه.
• رنگی‌سازی خطاها، هشدارها و پیام‌های اشکال‌زدایی (debug).
• اکنون vdirsyncer به‌جای argvard به بسته click وابسته است.

• اکنون vdirsyncer برای رهایی از تجزیه‌کننده خراب خود، به بسته icalendar از PyPI وابسته است.
• اکنون vdirsyncer به requests_toolbelt نیز وابسته است. این موضوع حدس زدن نوع احراز هویت را به‌جای پیش‌فرض گرفتن بی‌چون‌وچرای basic ممکن می‌سازد.
• رفع یک شبه‌باگ در ذخیره‌سازهای caldav و carddav که در آن به‌جای etag صحیح، یک چندتایی (href, etag) از متد upload بازگردانده می‌شد. ممکن است vdirsyncer هنگام ارتقا به این نسخه، کپی‌برداری غیرضروری انجام دهد.
• افزودن ذخیره‌ساز singlefile <#storage-singlefile>. گزارش مشکل #48 https://github.com/pimutils/vdirsyncer/issues/48 را ببینید.
• پارامتر collections برای بخش‌های pair اکنون مقادیر خاص from a و from b را برای کشف خودکار مجموعه‌ها می‌پذیرد. بخش Pair Section <#pair-config> را ببینید.
• پارامتر read_only به بخش‌های ذخیره‌ساز اضافه شد. بخش Storage Section <#storage-config> را ببینید.

  منتشر شده در 14 مه 2014

• Ben Boeckel
• Bleala
• Christian Geier
• Clément Mondon
• Corey Hinshaw
• Kai Herlemann
• Hugo Osvaldo Barrera
• Jason Cox
• Julian Mehne
• Malte Kiefer
• Marek Marczykowski-Górecki
• Markus Unterwaditzer
• Michael Adler
• rEnr3n
• Thomas Weißschuh
• Witcher01
• samm81

• FastMail https://github.com/pimutils/vdirsyncer/issues/571 که یک حساب پولی را برای آزمایش سرورهایشان حمایت مالی می‌کند.
• Packagecloud https://packagecloud.io که مخازن بسته‌های Debian برنامه vdirsyncer را فراهم می‌کند.

• توزیع‌های مجدد کد منبع باید اعلان حق نشر بالا، این فهرست شرایط و سلب مسئولیت زیر را حفظ کنند.
• توزیع‌های مجدد در قالب باینری باید اعلان حق نشر بالا، این فهرست شرایط و سلب مسئولیت زیر را در مستندات و/یا سایر موارد ارائه‌شده همراه با توزیع، بازتولید کنند.
• نام‌های مشارکت‌کنندگان نباید بدون مجوز کتبی و قبلی مشخص، برای تأیید یا تبلیغ محصولات مشتق‌شده از این نرم‌افزار به کار رود.

• بیت‌کوین (Bitcoin): 13p42uWDL62bNRH3KWA6cSpSgvnHy1fs2E.
• حمایت از طریق پرداخت‌های یک‌باره یا کمک‌های مالی دوره‌ای از طریق Ko-fi https://ko-fi.com/whynothugo.
• حمایت از طریق کمک‌های مالی دوره‌ای از طریق liberapay https://liberapay.com/WhyNotHugo.