Skip to content
/ lipsync Public
forked from philcryer/lipsync

lipsync sets up a lightweight service that provides command-line, Dropbox like syncing

License

Notifications You must be signed in to change notification settings

gorn/lipsync

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

lipsync

A lightweight service that provides automated two-way file syncronization

lipsync is an open source, lightweight service that provides automated two-way, {Dropbox}[http://bit.ly/1IGiJu]-like file syncronization in Linux by utilizing OpenSSH, rsync, Unison and lsyncd. lipsync is a the realization of a popular blog post of mine named HOWTO build your own open source dropbox clone Since I made the posting I’ve recieved a great deal of interest, and had time to test and architect a workable solution. Thanks to everyone that read, commented and encourged the further development of this idea!

Basic idea and example of a working system can be seen here

Features

  • automatic file synconization from multiple clients to a central server

  • true 2 way syncing with changes tracked and propogated to the clients by the server (Dropbox style)

  • optimized network transfer utilizing unique features of Unison

  • transfers secured and tunneled through OpenSSH

  • safe for everyday use

  • low fat

Dependencies

To get started with lipsync you need at least a client and a server, perferably on multiple systems. Software requirements:

  • Server - Linux 2.6.x, rsync, unison, opensshd

  • Client - Linux 2.6.x, rsync, unison, openssh, lsyncd

Install

git clone [email protected]:philcryer/lipsync.git cd lipsync chmod +x setup.sh ./setup.sh see the INSTALL file for full documentation

Caveats

Much of the initial feedback I recived asked for a graphical user interface and support for Windows. Please know that I have attempted neither, instead deciding to focus on the basic server-side functionality. This allowed me to flesh out the architecture, deciding on all the options and understanding ways to improve the transfer performance. Since most of the software used for lipsync is cross-platform, I’d be interested in working with others that want to build a gui front end to talk to the the lipsync backend service. I’ve been interested in the work done on the SparkleShare project, and since it can use different backends I’m hopeful that it will be agnostic enough to adapt to use lipsync.

Mailing list

The mailing list for the lipsync project is hosted on Google Groups, you can signup here groups.google.com/group/project-lipsync

License

lipsync is licensed as open source software under the Simplified BSD License See the accompanying LICENSE file for full details

Copyright © 2011, Phil Cryer All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the Phil Cryer nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Authors / Contact

phil (at) cryer (dot) us

Download

You can download this project in either zip or tar formats.

You can also clone the project with Git by running:

git clone git://github.com/philcryer/lipsync

Thanks

About

lipsync sets up a lightweight service that provides command-line, Dropbox like syncing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%