Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

The App Engine server, written in Python

branch: master
README.md

2cloud App Engine Server

About

2cloud is a free, decentralised, open source project to try and make sharing content between browsers and devices as seamless and effortless as possible. An up-to-date list of devices and browsers supported by the project is available at http://www.2cloudproject.com/clients

This is the App Engine software that powers our public server at https://2cloudapp.appspot.com. We provide it here as a reference for implementing your own server software for the project and as a plug and play package for users who want to host their own servers, but don't necessarily want to write their own server.

Installation Instructions

We tried to make installation as streamlined as possible. You just need to download the source (use git, or the download button) and change the identifier in app.yaml. Then use the App Engine SDK to sync it just like you normally would.

Where to Get Help

We try to maintain a presence with our users. To wit, we have:

If you don't use any of those... you're kind of out of luck.

Contribution Guidelines

The quickest, easiest, and most assured way to contribute is to be a beta tester. Simply join the mailing list and wait for a new beta to be released. Try and break it. Submit feedback. Wash, rinse, repeat.

If you're interested in contributing code, we use different guidelines for each part of our app. This is driven by necessity; you can't use PEP-8 on Java, for example. Our App Engine guidelines are simple:

  • If possible, have unit tests written for what you're patching
  • Explain clearly in your pull request what you're patching and why
  • Make sure your code follows the style laid out in PEP-8

That's pretty much it. We're laid back. The best way to figure out what's on our to-do list is to look at the issue tracker or ask on the dev mailing list. Whatever you work on should be something you want to see implemented, though.

Contributors

2cloud is an open source application. It is technically "owned" by Second Bit LLC, but all that really means is they take care of the mundane administrative and financial stuff. The team behind 2cloud is separate from the Second Bit team (despite some overlap). The 2cloud team is as follows:

They're pretty friendly. Please do get in touch!

Credits and Alternatives

One of the great parts about being an open source project is how often we get to stand on the shoulders of giants. Without these people and projects, we couldn't do what we do.

  • blog.notdot.net (basis of stats system)
  • docs.python.org (basis of timestamp.py)
  • jQuery (Stats dashboard)
  • Chrome to Phone (Inspiration)

There are some alternatives to 2cloud out there, and we encourage you to try them out. Use what works best for you. You can find an up-to-date list on our website.

Something went wrong with that request. Please try again.