2011-04-06 13:28:38 +04:00
|
|
|
# Mirall
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
2011-04-06 15:49:58 +04:00
|
|
|
Mirall synchronizes your folders with another computer.
|
|
|
|
|
|
|
|
|
|
The ultimate goals of Mirall are:
|
|
|
|
|
|
|
|
|
|
* Network location aware: should not try to sync against your NAS if you are
|
|
|
|
|
not in the home network
|
|
|
|
|
* It is a zero-interaction tool. So forget about resolving conflicts.
|
|
|
|
|
* It should work silently and realiably.
|
|
|
|
|
|
|
|
|
|
Mirall is in early stages of development, and may still eat your
|
|
|
|
|
files or hang your computer.
|
2011-04-06 13:28:38 +04:00
|
|
|
|
2011-04-06 15:50:31 +04:00
|
|
|
* Network location awareness not implemented yet
|
2011-04-08 15:35:24 +04:00
|
|
|
* Current version supports local and remote (sftp and smb) folders.
|
|
|
|
|
* It is powered by csync (http://www.csync.org), however
|
2011-04-06 13:28:38 +04:00
|
|
|
the user does not know and other tools will be incorporated to provide other
|
|
|
|
|
functionality.
|
|
|
|
|
|
|
|
|
|
## Current issues
|
|
|
|
|
|
2011-04-08 15:35:24 +04:00
|
|
|
* No sane way to backup conflicting versions yet, this should be solved
|
|
|
|
|
in a near csync release (--conflictcopy, available in Jann's branch).
|
|
|
|
|
Right now the newest copy wins.
|
2011-04-06 13:28:38 +04:00
|
|
|
* You can't remove folder configurations
|
2011-04-08 15:35:24 +04:00
|
|
|
Workaround: delete ~/.local/share/data/Mirall/folders/$alias and restart
|
2011-04-06 13:28:38 +04:00
|
|
|
* Some tasks block the GUI (initial setup of watchers)
|
|
|
|
|
* May be some concurrency issues
|
|
|
|
|
|
|
|
|
|
## Roadmap
|
|
|
|
|
|
|
|
|
|
* Improve robustness to minimize user interaction
|
|
|
|
|
* Improve feedback and sync results
|
|
|
|
|
* Add support for other folder types: tarsnap, duplicity, git (SparkleShare)
|
|
|
|
|
|
|
|
|
|
## Requirements
|
|
|
|
|
|
|
|
|
|
* Linux (currently it uses inotify to detect file changes)
|
|
|
|
|
* unison installed in the local and remote machine
|
|
|
|
|
(you should not care if you got Mirall with your favorite
|
|
|
|
|
distribution)
|
|
|
|
|
|
|
|
|
|
## Download
|
|
|
|
|
|
|
|
|
|
### openSUSE
|
|
|
|
|
|
|
|
|
|
* 1-click install available in software.opensuse.org
|
|
|
|
|
|
|
|
|
|
http://software.opensuse.org/search?q=mirall&baseproject=ALL&lang=en&include_home=true&exclude_debug=true
|
|
|
|
|
|
|
|
|
|
### Source code
|
|
|
|
|
|
2012-08-26 02:51:47 +04:00
|
|
|
* https://github.com/owncloud/mirall
|
2011-04-06 13:28:38 +04:00
|
|
|
|
|
|
|
|
## Building the source code
|
|
|
|
|
|
2011-04-06 13:31:54 +04:00
|
|
|
You need Qt 4.7 and cmake:
|
2011-04-06 13:28:38 +04:00
|
|
|
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake ..
|
|
|
|
|
make
|
|
|
|
|
|
|
|
|
|
To generate a tarball:
|
|
|
|
|
|
|
|
|
|
mkdir build
|
|
|
|
|
cd build
|
|
|
|
|
cmake ..
|
|
|
|
|
make package_source
|
|
|
|
|
|
|
|
|
|
## Authors
|
|
|
|
|
|
|
|
|
|
* Duncan Mac-Vicar P. <duncan@kde.org>
|
2012-10-02 15:24:10 +04:00
|
|
|
* Klaas Freitag <freitag@owncloud.com>
|
|
|
|
|
* Daniel Molkentin <danimo@owncloud.com>
|
2011-04-06 13:28:38 +04:00
|
|
|
|
2011-04-06 13:48:02 +04:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful, but
|
|
|
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
|
|
|
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
|
|
for more details.
|
|
|
|
|
|
|
|
|
|
|
