SparkleShare/README

SparkleShare
============

SparkleShare is a collaboration and sharing tool that is designed to keep
things simple and to stay out of your way. It allows you to instantly sync
with any Git repository you have access to.

Though SparkleShare is not made to be a graphical frontend 
for git or a backup tool, it may be useful for other kinds of purposes as well, 
like backing up small files or monitoring your favourite project. In contrast 
to the projects name, we will very likely refuse to implement your personal 
ponies.

SparkleShare currently works on Linux and Mac. A Windows port and mobile
device support are planned for the future.


License
=======

SparkleShare is free software and licensed under the GNU GPLv3 or later. You
are welcome to change and redistribute it under certain conditions. For more
information see the LICENSE file or visit http://www.gnu.org/licenses/gpl-3.0.html


Run on Linux:
=============

SparkleShare currently requires:

   - git >= 1.7
   - gtk-sharp2 >= 2.12.7
   - mono-core >= 2.2
   - ndesk-dbus >= 0.6
   - openssh
   - gvfs >= 1.3
   - intltool
   - libnotify
   - nautilus-python
   - pygtk
   - webkitgtk
   - webkit-sharp

Run the service, either click the SparkleShare launcher or:

   $ sparkleshare start

You can stop the service via the graphical interface or by typing:

   $ sparkleshare stop

For help:

   $ sparkleshare --help

Note:

   SparkleShare creates its own RSA keypair in ~/.ssh and uses that for
   authentication. Please mind this if you're planning to set up your own server 
   by hand.


Build on Linux:
===============

Installing the build dependencies on Debian:

   $ sudo apt-get install gtk-sharp2 mono-runtime mono-devel monodevelop \
     libndesk-dbus1.0-cil-dev nant libnotify-cil-dev libgtk2.0-cil-dev \
     libwebkit-cil-dev intltool libtool python-nautilus libndesk-dbus-glib1.0-cil-dev

Or on Fedora:

   $ sudo yum install gtk-sharp2-devel mono-core mono-devel monodevelop \
     ndesk-dbus-devel ndesk-dbus-glib-devel nautilus-python-devel nant \
     notify-sharp-devel webkit-gtk-devel webkit-sharp-devel webkitgtk-devel \
     libtool intltool


You can build and install SparkleShare like this:

   $ ./configure (or ./autogen if you got SparkleShare from the repository)
   $ make
   $ sudo make install

Note:

   Use './configure --prefix=/usr' if you want the Nautilus extension to work.


Run on Mac:
===========

Just double-click the SparkleShare.app.


Build on Mac:
=============

Install the Mono Framework, Monodevelop (plus the MonoMac plugin), and MacPorts.
Install git, automake, and intltool:

   $ sudo port install git-core automake intltool

You may need to adjust some environment variables to find mono:
   
   $ export PATH=/Library/Frameworks/Mono.framework/Versions/Current/bin:$PATH
   $ export PKG_CONFIG=/Library/Frameworks/Mono.framework/Versions/Current/bin/pkg-config
   $ export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig

Start the first part of the build:

   $ ./autogen.sh
   $ make

The last step will give you some errors in SparkleShare.exe, ignore these, you only
need the libraries to be compiled. Now open 'SparkleShare/Mac/SparkleShare.sln' in 
MonoDevelop and start the build.

To create the SparkleShare.app, select Project from the menu bar and
click "Create Mac Installer..."


Info
====

Official website:
http://www.sparkleshare.org/

Source code:
http://github.com/SparkleShare/

IRC Channel:
#sparkleshare on irc.gnome.org

Wiki:
http://github.com/hbons/SparkleShare/wiki/

Report issues:
http://github.com/hbons/SparkleShare/issues/

Translation project:
http://www.transifex.net/projects/p/sparkleshare/


Now have fun and create cool things together! :)