SparkleShare/README.md

30 lines
2.2 KiB
Markdown
Raw Normal View History

2016-07-09 21:23:03 +00:00
# [SparkleShare](https://www.sparkleshare.org/)
2017-03-18 14:01:34 +00:00
SparkleShare is a file sharing and collaboration app. It works just like Dropbox, and you can run it on your own server. It's available for Linux distributions, macOS, and Windows. [Support the project on Patreon](https://www.patreon.com/SparkleShare).
2017-03-18 14:12:26 +00:00
![Banner](https://raw.githubusercontent.com/hbons/SparkleShare/master/SparkleShare/Common/Images/readme-banner.png)
2015-07-07 23:28:42 +00:00
## How does it work?
2012-03-09 21:06:02 +00:00
2015-07-07 23:28:42 +00:00
SparkleShare creates a special folder on your computer. You can add remotely hosted folders (or "projects") to this folder. These projects will be automatically kept in sync with both the host and all of your peers when someone adds, removes or edits a file.
2012-03-06 22:56:32 +00:00
2017-03-18 14:15:41 +00:00
## Set up a host
2015-07-07 23:35:16 +00:00
SparkleShare uses the version control system [Git](https://git-scm.com/) under the hood, so setting up a host yourself is relatively easy. Using your own host gives you more privacy and control, as well as lots of cheap storage space and higher transfer speeds. We've made a simple [script](https://github.com/hbons/Dazzle) that does the hard work for you. If you need to manage a lot of projects and/or users it may be worth setting up a [GitLab](https://www.gitlabhq.com) instance.
2012-06-19 17:28:49 +00:00
2017-03-18 14:15:41 +00:00
## Compile from source
2016-03-31 08:35:26 +00:00
`SparkleShare` is Free and Open Source software and licensed under the [GNU General Public License version 3 or later](legal/License_for_SparkleShare.txt). You are welcome to change and redistribute it under certain conditions. Its library `Sparkles` is licensed under the [GNU Lesser General Public License version 3 or later](legal/License_for_Sparkles.txt).
2015-07-07 23:28:42 +00:00
2017-03-18 14:15:41 +00:00
Here are instructions to build SparkleShare on [Linux distributions](SparkleShare/Linux/README.md), [macOS](SparkleShare/Mac/README.md), and [Windows](SparkleShare/Windows/README.md). Make sure to have the `git` package installed when you're building on Linux.
2015-07-07 23:28:42 +00:00
2017-03-18 14:12:26 +00:00
[![Build Status](https://travis-ci.org/hbons/SparkleShare.svg?branch=master)](https://travis-ci.org/hbons/SparkleShare)
2015-07-07 23:36:35 +00:00
## Useful links
2016-07-09 21:23:03 +00:00
[Official website](https://www.sparkleshare.org/), [Twitter](https://www.twitter.com/SparkleShare), [Wiki](https://www.github.com/hbons/SparkleShare/wiki), and [Source Code](https://www.github.com/hbons/SparkleShare). Join the chat: `#sparkleshare` on `irc.gnome.org`.
2012-06-19 17:05:56 +00:00
Have fun, make awesome. :)