2011-03-14 12:04:28 +00:00
|
|
|
SparkleShare 0.2 Release Candidate 1
|
|
|
|
====================================
|
2010-05-03 02:25:15 +00:00
|
|
|
|
2010-05-19 20:47:43 +00:00
|
|
|
SparkleShare is a file sharing and collaboration tool inspired by Dropbox.
|
2010-04-27 15:10:42 +00:00
|
|
|
|
2010-05-03 00:04:39 +00:00
|
|
|
SparkleShare isn't just a piece of software, it's part of your workflow. It's
|
2010-05-01 15:32:17 +00:00
|
|
|
designed to make sharing documents and collaboration easier, and to make peers
|
2010-05-19 20:47:43 +00:00
|
|
|
aware of what you are doing. It allows you to instantly sync with any Git
|
|
|
|
repository you have access to. The user interface and features are made to
|
|
|
|
support this goal. 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
|
2010-06-01 19:41:54 +00:00
|
|
|
ponies.
|
2010-05-01 15:22:54 +00:00
|
|
|
|
2010-06-12 09:03:37 +00:00
|
|
|
SparkleShare currently only works on Linux/GNOME.
|
|
|
|
Windows and OSX ports are planned for the future.
|
|
|
|
|
2010-05-01 15:22:54 +00:00
|
|
|
|
2010-05-05 13:13:55 +00:00
|
|
|
License
|
|
|
|
=======
|
|
|
|
|
2010-05-03 00:04:39 +00:00
|
|
|
SparkleShare is free software and licensed under the GNU GPLv3. You are welcome
|
2010-05-01 15:32:17 +00:00
|
|
|
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
|
2010-05-01 15:22:54 +00:00
|
|
|
|
|
|
|
|
2011-02-12 23:41:08 +00:00
|
|
|
Run on Linux:
|
|
|
|
=============
|
2010-05-05 13:13:55 +00:00
|
|
|
|
2010-05-05 01:20:54 +00:00
|
|
|
SparkleShare currently requires:
|
2010-05-05 13:13:55 +00:00
|
|
|
|
2010-05-01 20:05:02 +00:00
|
|
|
- git >= 1.7
|
2010-05-01 15:22:54 +00:00
|
|
|
- gtk-sharp2 >= 2.12.7
|
|
|
|
- mono-core >= 2.2
|
2010-05-05 01:20:54 +00:00
|
|
|
- ndesk-dbus >= 0.6
|
2010-06-01 19:41:54 +00:00
|
|
|
- openssh
|
2010-06-16 23:25:46 +00:00
|
|
|
- gvfs >= 1.3
|
2010-06-23 09:02:43 +00:00
|
|
|
- intltool
|
2010-11-21 15:55:18 +00:00
|
|
|
- libnotify
|
2010-06-26 20:27:01 +00:00
|
|
|
- nautilus-python
|
2010-08-30 14:28:13 +00:00
|
|
|
- pygtk
|
2010-11-06 15:05:48 +00:00
|
|
|
- webkitgtk
|
|
|
|
- webkit-sharp
|
2010-04-29 10:37:59 +00:00
|
|
|
|
2011-02-12 23:41:08 +00:00
|
|
|
Run the service, either click the SparkleShare launcher or:
|
2010-05-05 13:13:55 +00:00
|
|
|
|
|
|
|
$ sparkleshare start
|
|
|
|
|
|
|
|
You can stop the service via the graphical interface or by typing:
|
|
|
|
|
|
|
|
$ sparkleshare stop
|
|
|
|
|
|
|
|
For help:
|
|
|
|
|
|
|
|
$ sparkleshare --help
|
|
|
|
|
2010-08-22 17:24:43 +00:00
|
|
|
Note:
|
|
|
|
|
2010-11-06 15:05:48 +00:00
|
|
|
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.
|
2010-08-22 17:24:43 +00:00
|
|
|
|
2010-05-05 13:13:55 +00:00
|
|
|
|
2011-02-12 23:41:08 +00:00
|
|
|
Build on Linux:
|
|
|
|
===============
|
2010-05-01 20:05:02 +00:00
|
|
|
|
2010-05-05 01:20:54 +00:00
|
|
|
To build SparkleShare you need:
|
2010-05-05 13:13:55 +00:00
|
|
|
|
2010-05-05 01:20:54 +00:00
|
|
|
- gtk-sharp2-devel >= 2.12.7
|
|
|
|
- mono-core >= 2.2
|
2010-06-19 09:28:46 +00:00
|
|
|
- mono-devel >= 2.2
|
2010-05-05 01:20:54 +00:00
|
|
|
- monodevelop >= 2.0
|
|
|
|
- ndesk-dbus-devel >= 0.6
|
2010-06-12 13:41:11 +00:00
|
|
|
- ndesk-dbus-glib-devel >= 0.6
|
2010-08-30 14:28:13 +00:00
|
|
|
- nautilus-python-devel
|
2010-10-21 19:11:02 +00:00
|
|
|
- nant
|
2010-11-21 15:55:18 +00:00
|
|
|
- notify-sharp-devel
|
2011-03-14 13:26:02 +00:00
|
|
|
- webkit-gtk-devel
|
2010-11-06 15:05:48 +00:00
|
|
|
- webkit-sharp-devel
|
2010-05-05 01:20:54 +00:00
|
|
|
|
2011-02-23 00:36:25 +00:00
|
|
|
|
|
|
|
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 \
|
2011-03-14 23:43:22 +00:00
|
|
|
libwebkit-cil-dev intltool libtool python-nautilus libndesk-dbus-glib1.0-cil-dev
|
2011-02-23 00:36:25 +00:00
|
|
|
|
|
|
|
|
2010-05-03 00:04:39 +00:00
|
|
|
You can build and install SparkleShare like this:
|
2010-05-05 13:13:55 +00:00
|
|
|
|
2010-10-03 21:37:17 +00:00
|
|
|
$ ./configure (or ./autogen if you got SparkleShare from the repository)
|
2010-04-30 02:15:01 +00:00
|
|
|
$ make
|
2010-05-03 02:25:15 +00:00
|
|
|
$ sudo make install
|
2010-04-30 02:15:01 +00:00
|
|
|
|
2010-10-03 21:37:17 +00:00
|
|
|
Note:
|
|
|
|
|
|
|
|
Use './configure --prefix=/usr' if you want the Nautilus extension to work.
|
|
|
|
|
2010-05-18 18:40:58 +00:00
|
|
|
|
2011-02-12 23:41:08 +00:00
|
|
|
Run on Mac:
|
|
|
|
===========
|
|
|
|
|
2011-03-13 22:26:49 +00:00
|
|
|
Just double-click the SparkleShare.app.
|
2011-02-12 23:41:08 +00:00
|
|
|
|
|
|
|
|
|
|
|
Build on Mac:
|
2010-11-13 22:25:17 +00:00
|
|
|
=============
|
|
|
|
|
2011-02-12 23:50:59 +00:00
|
|
|
Install the Mono Framework, Monodevelop (plus the MonoMac plugin), and MacPorts.
|
2011-02-06 18:54:34 +00:00
|
|
|
|
2010-11-13 22:25:17 +00:00
|
|
|
Install git-core, automake and intltool using 'port install'.
|
2010-12-17 23:14:51 +00:00
|
|
|
Make sure that git or a symbolic link to git is in /usr/bin.
|
2010-11-13 22:25:17 +00:00
|
|
|
|
2011-02-05 16:53:28 +00:00
|
|
|
Note:
|
|
|
|
|
|
|
|
You may need to adjust some environment variables to find mono:
|
2011-02-23 01:13:54 +00:00
|
|
|
|
|
|
|
$ export PATH=/Library/Frameworks/Mono.framework/Versions/Current/bin:$PATH
|
2011-02-12 23:50:59 +00:00
|
|
|
$ export PKG_CONFIG=/Library/Frameworks/Mono.framework/Versions/Current/bin/pkg-config
|
|
|
|
$ export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Versions/Current/lib/pkgconfig
|
2011-02-23 01:13:54 +00:00
|
|
|
$ ./autogen.sh
|
2011-03-13 22:26:49 +00:00
|
|
|
$ make
|
2011-02-12 23:50:59 +00:00
|
|
|
|
2011-02-23 01:13:54 +00:00
|
|
|
The last step will give you some errors, but you only need the libraries to be compiled.
|
2011-02-12 23:50:59 +00:00
|
|
|
Open 'SparkleShare/Mac/SparkleShare.sln' in MonoDevelop and start the build.
|
2011-02-05 16:53:28 +00:00
|
|
|
|
|
|
|
|
2010-05-18 10:42:49 +00:00
|
|
|
Frequently Asked Question
|
|
|
|
=========================
|
|
|
|
|
|
|
|
Q: Why is it written in Mono/C#?
|
2010-06-01 19:41:54 +00:00
|
|
|
A: Because I hate freedom.
|
2010-05-18 10:42:49 +00:00
|
|
|
|
2010-04-30 02:15:01 +00:00
|
|
|
|
2010-05-05 13:13:55 +00:00
|
|
|
Info
|
|
|
|
====
|
2010-05-01 15:22:54 +00:00
|
|
|
|
2010-06-12 09:03:37 +00:00
|
|
|
Official website:
|
2010-05-05 13:40:59 +00:00
|
|
|
http://www.sparkleshare.org/
|
2010-05-01 15:22:54 +00:00
|
|
|
|
2010-06-12 09:03:37 +00:00
|
|
|
Project page:
|
2011-02-05 16:53:28 +00:00
|
|
|
http://github.com/SparkleShare/
|
2010-06-12 09:03:37 +00:00
|
|
|
|
2010-10-09 19:01:02 +00:00
|
|
|
IRC Channel:
|
|
|
|
#sparkleshare on irc.gnome.org
|
|
|
|
|
2010-06-12 09:03:37 +00:00
|
|
|
Wiki:
|
2011-02-05 16:53:28 +00:00
|
|
|
http://github.com/hbons/SparkleShare/wiki/
|
2010-06-12 09:03:37 +00:00
|
|
|
|
2010-10-05 08:32:03 +00:00
|
|
|
Issue tracker:
|
2011-02-05 16:53:28 +00:00
|
|
|
http://github.com/hbons/SparkleShare/issues/
|
2010-08-22 17:24:43 +00:00
|
|
|
|
2010-10-07 19:32:14 +00:00
|
|
|
Translation project:
|
|
|
|
http://www.transifex.net/projects/p/sparkleshare/
|
2010-05-01 15:22:54 +00:00
|
|
|
|
2011-02-05 16:53:28 +00:00
|
|
|
|
2010-05-05 01:20:54 +00:00
|
|
|
Now have fun and create cool things together! :)
|