Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vole/vole
Vole is a social, peer-to-peer web app for sharing words, pictures and videos.
https://github.com/vole/vole
Last synced: about 1 month ago
JSON representation
Vole is a social, peer-to-peer web app for sharing words, pictures and videos.
- Host: GitHub
- URL: https://github.com/vole/vole
- Owner: vole
- License: mit
- Created: 2013-05-14T18:55:00.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-07-16T05:07:53.000Z (over 9 years ago)
- Last Synced: 2024-08-01T22:53:29.016Z (4 months ago)
- Language: Go
- Homepage:
- Size: 7.12 MB
- Stars: 446
- Watchers: 55
- Forks: 44
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - vole/vole - Vole is a social, peer-to-peer web app for sharing words, pictures and videos. (others)
README
Vole
====
Vole is a web application for sharing words, pictures and videos with others. Data is distributed peer-to-peer using Bittorrent Sync.
* A complete introduction is available on [vole.cc](http://vole.cc).
* Please join the [mailing list](https://groups.google.com/forum/#!forum/vole-dev) for announcements and development discussion.
* Follow us on Twitter [@volecc](https://twitter.com/volecc).
Getting started
---------------
Currently we are pre-release. The following steps are for interested developers.
* [Download](https://github.com/vole/vole/releases) the latest version of Vole for Mac OSX, Windows or Linux.
* Or, you can compile it yourself. See [CONTRIBUTING](https://github.com/vole/vole/blob/master/CONTRIBUTING.md).
* Run the Vole application from the command line. First, `cd` into the directory that you placed Vole. Then, on Mac/Linux type `./vole`, and on Windows type `vole.exe`.
* Open a web browser and go to [http://localhost:6789](http://localhost:6789).
* Click 'My Profile'
* Enter your name. Enter your Gravatar email (optional).
* Click 'Home'
* Post something. Vole supports [Github flavored markdown](https://help.github.com/articles/github-flavored-markdown), and will also auto-embed any image links you put in the text.
Sharing and following
---------------------
Start by installing [Bittorrent Sync](http://labs.bittorrent.com/experiments/sync.html).
Following and sharing currently involves manually setting up folders, however we'd like to automate it as soon as Bittorrent Sync releases a build that supports control via an API.
Following others
----------------
* Grab the **read-only** ID of the person you want to follow. A directory is in progress at [vole.cc](http://vole.cc). Why not start with Vole Team updates? Our key is RA32XLBBHXMWMECGJAJSJMMPQ3Z2ZGR7K.
* Find the Vole `users` folder. Unless you changed the defaults, it will be in a directory called `Vole/users` in your home folder.
* Create a new folder in `Vole/users`, you should name it after the user that you're about to follow. For example, `Vole/users/voleteam`.
* In BitTorrent Sync, add this new folder as a shared folder, using the read-only key you grabbed in step 1. [Instructions](http://labs.bittorrent.com/experiments/sync/get-started.html) are available on their site and vary a little by operating system.
* You should receive notification that the folder has sync'd.
* In your browser, see the new posts appear.
Sharing your posts
------------------
Find your own user folder, for example, if you created a profile named 'Chuck':
/home/chuck/Vole/users/Chuck_9674e8e8-7c7a-41e6-52ed-51a3f7969812
* In Bittorrent Sync, add this folder as a shared folder.
* In the folder options, grab the **read-only key**. Make sure the key starts with the letter 'B' that signifies it's the read-only one. You can find it by going to the advanced folder preferences. This is the key that you can share with others so they can follow your posts.
* If you want to list your key on vole.cc, make a pull request on the [website repo](https://github.com/vole/vole.github.io). Here is an [example](https://github.com/vole/vole.github.io/pull/9).
Configuration
-------------
To override the default configuration options, make a copy of `config.sample.json` and name it `config.json`.
Change the `server.listen` value to `0.0.0.0:6789` to listen for requests from any network device, instead of just the local machine.
Versions
--------
Vole uses [semantic versioning](http://semver.org).
Please see the [CHANGELOG](https://github.com/vole/vole/blob/master/CHANGELOG.md) for version history.
Technology
----------
* [Bittorrent Sync](http://labs.bittorrent.com/experiments/sync.html)
* [Go](http://golang.org/)
* [Ember.js](http://emberjs.com/)
License
-------
Copyright (C) 2013 Vole development team
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.