opcontrol / sparkleshare

SparkleShare is an Open Source collaboration and sharing tool that is designed to keep things simple and to stay out of your way. http://www.sparkleshare.org/

SparkleShare

SparkleShare is a collaboration and sharing tool that is designed to keep things simple and to stay out of your way. SparkleShare is available for Linux, Mac and Windows.

SparkleShare allows you to instantly sync with any Git repository you have access to.

Resources

Website:	http://www.sparkleshare.org/
Source code:	https://github.com/hbons/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/

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

Running SparkleShare

Linux

You can choose to build from source or get the packages through your distribution's repositories.

Requirements:

curl
git >= 1.7.3
gtk-sharp2
mono-core >= 2.8
notify-sharp
webkit-sharp

Optional:

nautilus-python
gvfs
libappindicator

Mac

Download, unzip and open the SparkleShare bundle.

Windows

Download and run the installer and start SparkleShare from the Windows menu.

Building on Linux

Ubuntu:

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

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-sharp-devel webkitgtk-devel libtool intltool

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 mono-mcs mono-gmcs \
  libwebkit-cil-dev intltool libtool python-nautilus libndesk-dbus-glib1.0-cil-dev

You can then build and install SparkleShare like this:

$ ./configure --prefix=/usr (or ./autogen.sh if you build from the repository)
$ make
$ sudo make install

Note: The Nautilus extension will only be enabled if you build with --prefix=/usr.

Building on Mac

Install Xcode, the Mono Framework and MonoDevelop.

Start MonoDevelop and install the MonoMac add-in (it's in MonoDevelop > Add-in Manager).

You may need to adjust some environment variables to let the build environment tools 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

Install git, automake, and intltool using MacPorts:

$ sudo port install git-core automake intltool

Start the first part of the build:

$ ./autogen.sh --enable-gtkui=no
$ make

Now that you have compiled the libraries, open SparkleShare/Mac/SparkleShare.sln in MonoDevelop and start the build.

Creating a Mac bundle

To create the SparkleShare.app, make sure the project is focused and select Project from the menu bar and click "Create Mac Installer...". Make sure to select "Don't link assemblies".

Save the SparkleShare.app somewhere. Copy SparkleShare/Mac/config to SparkleShare.app/Contents/MonoBundle/config (adjust the paths to where you saved the .app):

cp SparkleShare/Mac/config SparkleShare.app/Contents/MonoBundle/config

Copy /Library/Frameworks/Mono.framework/Versions/Current/lib/libintl.dylib to SparkleShare.app/Contents/Resources

Now you should have a working bundle that you can run.

Building on Windows

Install version 4.0 of the .NET Framework if you haven't already.

Install msysGit. Change the install location to C:\msysgit and use the default settings for the other settings during the installation. Copy the C:\msysgit directory into bin\msysgit (in the SparkleShare source directory).

Open a command prompt and execute the following:

cd C:\path\to\SparkleShare\source
cd SparkleShare\Windows
build

C:\path\to\SparkleShare\source\bin should now contain SparkleShare.exe, which you can run.

Creating a Windows installer

To create an installer package, install WiX 3.5, restart Windows and run:

build installer

This will create SparkleShare.msi in the same directory.

Reset SparkleShare settings

Linux and Mac:

rm -Rf ~/SparkleShare
rm -Rf ~/.config/sparkleshare

Windows

Remove My Documents\SparkleShare and AppData\Roaming\sparkleshare (AppData is hidden by default).

Finally

Have fun! :)