+1
日增长
5,584
stars
279
forks
82
watchers
601
prs
609
issues
21
releases
README
!Unison Unison File Synchronizer Meta Please read this entire README and https://github.com/bcpierce00/unison/wiki/Reporting-Bugs-and-Feature-Requests before creating or commenting on a github issue. TL;DR: Do not ask questions or ask for help in issues. Upgrade to the latest release. Please also read https://github.com/bcpierce00/unison/wiki before interacting with the issue tracker or asking for help. About Unison is a file-synchronization tool for POSIX-compliant systems (e.g. BSD, GNU/Linux, macOS) and Windows. It allows two replicas of a collection of files and directories to be stored on different hosts (or different disks on the same host), modified separately, and then brought up to date by propagating the changes in each replica to the other. Unison has been in use for over 25 years and many people use it to synchronize data they care about. Features: Unison works across platforms, allowing you to synchronize a Windows laptop with a Unix server, for example. Unlike simple mirroring or backup utilities, Unison can deal with updates to both replicas of a distributed directory structure. Updates that do not conflict can be propagated automatically. Conflicting updates are detected and displayed. Unlike many network filesystems, Unison copies data so that already-synchronized data can be read and written while offline. Unlike most distributed filesystems, Unison is a user-level program that simply uses normal systems calls: there is no need to modify the kernel, to have superuser privileges on either host, or to have a FUSE implementation. Unison works between any pair of machines connected to the internet, typically communicating over ssh, but also directly over TCP. It is careful with network bandwidth, and runs well over slow links. Transfers of small updates to large files are optimized using a compression protocol similar to rsync. Unison is resilient to failure. It is careful to leave the replicas and its own private structures in a sensible state at all times, even in case of abnormal termination or communication failures. Unison can run in "repeat" mode with a filesystem monitor, so that changes are synchronized soon after they happen. Unison has a clear and precise specification. Unison is Free; full source code is available under the GNU Public License, Version 3. Contributing Note that only a very small number of people are actively working on maintaining unison. An estimate is 2.5 people and 0.1 Full-Time Equivalents. This has a substantial impact on the handling of bug reports and enhancement reports. Help in terms of high-quality bug reports, fixes, and proposed changes is very welcome. Help in answering mailinglist questions is also welcome. Please do not answer questions asked in the bug tracker, which is contrary to bug tracker usage guidance. See CONTRIBUTING.md for a longer discussion. Community Unison activity is now cent
Top issues
#605Add workaround for openssh <8.7 failure to restore blocking status (needs stdout/stderr on same fd to trigger, e.g. systemd)24 comments · 2021-11-20#1148macOS GUI invokes unison from multiple threads, leading to fpcache corruption23 comments · 2025-10-08#711Reconsider mailing list host22 comments · 2022-04-25#396text UI should query terminal width and scale output 17 comments · 2020-10-14#662Add workaround for macOS 12 not allowing rename(2) on 0500 mode directory (which is legal but strange and unhelpful)16 comments · 2022-03-06#367Add pre/suffix option for temporary files so that other processes/systems will ignore them16 comments · 2020-08-23#937"Open profile on startup" not working on macOS 13.4.1 (perhaps macOS bug, perhaps Unison)15 comments · 2023-06-13#871Remove external rsync support (as more complicated than useful)14 comments · 2023-03-19
Latest release
v2.54.0 v2.54.0 2026-05-01Changes in 2.54.0
Released 2026-05-01
Drop old wire protocol. Unison will no longer interoperate with
versions before 2.52.0 and will no longer read pre-2.52.0 archive
files.
Document that LLM output is unwelcome in the Unison project (code,
issues, mailinglists, etc.).
Add desktop file.
Deprecation warning: support for external rsync will be removed;
this may happen even in a micro release.
DEPRECATION MAY HAPPEN WITH LESS THAN TYPICAL NOTICE:
lablgtk is difficult to use safely, and future maintenance is
unclear. Implementing the GUI with